Skip to content

feat: integrate superpowers skills into dev-workflow plugin#6

Merged
tombakerjr merged 16 commits into
mainfrom
feature/integrate-superpowers-skills
Jan 27, 2026
Merged

feat: integrate superpowers skills into dev-workflow plugin#6
tombakerjr merged 16 commits into
mainfrom
feature/integrate-superpowers-skills

Conversation

@tombakerjr
Copy link
Copy Markdown
Owner

Summary

Integrates planning and workflow skills from superpowers into dev-workflow, creating a self-contained development workflow plugin.

New Skills (5 created)

Skill Purpose
test-driven-development Red-green-refactor discipline
systematic-debugging 4-phase root cause analysis
writing-plans Bite-sized task planning with model recommendations
using-git-worktrees Isolated workspaces for parallel work
brainstorming Socratic design exploration

Skill Chaining

FEATURE WORKFLOW:
brainstorming → using-git-worktrees → writing-plans → subagent-driven-development → /pr-merge

BUG FIX WORKFLOW:
systematic-debugging → test-driven-development → commit

Other Changes

  • implementer agent: Added TDD principles and verification discipline sections
  • subagent-driven-development skill: Updated refs to new dev-workflow skills
  • PR verification: Uses gh pr checks --watch + polls for Claude review comment
  • workflow-preferences.sh: Mentions new skills on session start
  • README: Comprehensive rewrite as full development workflow plugin
  • CLAUDE.md: Updated with skills directory and invocation examples
  • ~/.claude/CLAUDE.md: Updated superpowers refs → dev-workflow refs

Self-Contained

All superpowers: references removed. Plugin is now fully self-contained.

Test plan

  • Run claude plugin update
  • Verify dev-workflow:brainstorming loads correctly
  • Verify dev-workflow:systematic-debugging loads correctly
  • Verify SessionStart hook shows new skill hints

🤖 Generated with Claude Code

tombakerjr and others added 15 commits January 27, 2026 11:50
Add TDD skill enforcing red-green-refactor cycle with verification
checkpoints. Establishes iron law: no production code without failing
test first.

Integrates with systematic-debugging for regression tests and
implementer for disciplined implementation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Implements 4-phase debugging framework (Investigate -> Analyze ->
Hypothesize -> Implement) with iron law of no fixes without root cause.

Key features:
- Structured evidence gathering and hypothesis testing
- 3-fix rule to prevent infinite fix loops
- Chains to test-driven-development for fix implementation
- Clear checkpoints and success criteria
- Integration with implementer and subagent workflows

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Creates isolated worktrees for feature branches to prevent git index
conflicts during parallel development. Provides smart directory
selection, safety verification, and cleanup guidance.

Key features:
- Safety checks before worktree creation
- Sibling directory naming pattern
- Chains to writing-plans for implementation
- Comprehensive cleanup process
- Common commands reference

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Implements Socratic dialogue approach for requirements exploration:
- One question at a time with multiple choice options
- Incremental design building with 200-300 word validated sections
- Saves to docs/plans/YYYY-MM-DD-<topic>-design.md
- Chains to using-git-worktrees and writing-plans

Key principles:
- No lists of questions (reduces user burden)
- Validate each section before continuing
- Build understanding incrementally through dialogue
- Clear integration with downstream skills

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Creates bite-sized tasks with model recommendations
- Embeds TDD approach in task structure
- Plan header references dev-workflow:subagent-driven-development
- Includes comprehensive examples and anti-patterns
- Model selection guide (haiku/sonnet/opus)
- Phase boundary review checkpoints

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Change superpowers:writing-plans to dev-workflow:writing-plans
- Add references to dev-workflow:brainstorming
- Add references to dev-workflow:systematic-debugging
- Add references to dev-workflow:test-driven-development
- Add references to dev-workflow:using-git-worktrees

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
…ic-debugging

Add mentions of dev-workflow:brainstorming for features and dev-workflow:systematic-debugging for bugs in SessionStart hook context.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Replace hardcoded 12-second sleep with gh pr checks --watch flag to properly
wait for all CI checks to complete before proceeding with comment review.
Also reduce post-CI delay to 5 seconds since watch already waits for completion.

- commands/pr-merge.md: Add --watch flag after initial check status query
- agents/pr-verifier.md: Add watch step and reduce sleep to 5 seconds
Replace arbitrary 5-second sleep with active polling that waits up to 60
seconds for the Claude code review comment. The review comment is REQUIRED
before proceeding with merge evaluation.

Changes:
- commands/pr-merge.md: Poll for review comment with 12 retries (60s total)
- agents/pr-verifier.md: Same polling logic, block if comment not found
- Search for bot usernames: claude, code-review, github-actions
- Exit with warning if comment not found after polling

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Fix jq Cartesian product bug in comment polling (pr-merge.md, pr-verifier.md)
- Revert version to 2.1.0 (will use release automation for versioning)
- Update README to reflect polling behavior instead of fixed wait time

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@claude
Copy link
Copy Markdown

claude Bot commented Jan 27, 2026

Claude finished @tombakerjr's task in 1m 42s —— View job


Code Review Complete

  • Read CLAUDE.md for project context
  • Review plugin metadata files
  • Review new skill files
  • Review agent/command updates
  • Review PR verification changes
  • Post findings

LGTM - no blocking issues

Reviewed this comprehensive integration of 5 workflow skills from superpowers into dev-workflow. The changes are well-structured and self-contained:

Verified

  • ✅ All 5 new skills have proper frontmatter and clear structure
  • ✅ Skills integration into subagent-driven-development is correct
  • ✅ PR verification polling logic is robust (12 retries × 5s = 60s timeout)
  • ✅ README comprehensively documents feature/bug workflows
  • ✅ CLAUDE.md updated with skill invocation examples
  • ✅ Version consistency (2.1.0 in both metadata files)
  • ✅ All superpowers references removed (self-contained)

Notable improvements in this PR

  • PR verification: Replaced sleep 12 with gh pr checks --watch + polling loop for Claude review comment (agents/pr-verifier.md:23-54, commands/pr-merge.md:61-101)
  • Implementer discipline: Added TDD principles and verification discipline sections (agents/implementer.md:74-96)
  • Comprehensive planning: writing-plans skill includes model recommendations and complexity classification (skills/writing-plans/SKILL.md)

No security issues, logic errors, or missing error handling detected. Test plan in PR description is appropriate.

- Fix plugin.json URLs to use actual repo name (claude-code-pr-workflow)
- Simplify workflow-preferences.sh messaging
- Update README install commands to use dev-workflow plugin name

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@tombakerjr tombakerjr merged commit 21da858 into main Jan 27, 2026
2 checks passed
@tombakerjr tombakerjr deleted the feature/integrate-superpowers-skills branch January 27, 2026 17:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant