Skip to content

feat: add workflow skills#16

Merged
raiderrobert merged 6 commits into
mainfrom
feat/workflow-skills
Feb 28, 2026
Merged

feat: add workflow skills#16
raiderrobert merged 6 commits into
mainfrom
feat/workflow-skills

Conversation

@raiderrobert

Copy link
Copy Markdown
Owner

Summary

  • Add review-and-fix skill — parallel code review with worktree-based fix dispatch and cherry-pick
  • Add dispatch-worktree-task skill — packages a plan and dispatches a subagent in an isolated worktree
  • Add review-with-research skill — reviews a branch with parallel code review + research subagents
  • Add iterative-review-fix skill — serial review-fix loop that repeats until findings converge to zero or plateau

Test plan

  • Invoke each skill via its trigger keywords and verify routing
  • Run iterative-review-fix on a branch with known issues, confirm it converges
  • Verify frontmatter descriptions are under 1024 chars
  • Confirm no cross-references to sauce repo

…view-with-research)

- review-and-fix: review a branch with a domain skill, document findings,
  dispatch parallel worktree agents to fix each, cherry-pick and verify
- dispatch-worktree-task: dispatch a planned task to a background worktree
  subagent (moved from diecut, generalized)
- review-with-research: review a branch with parallel code-review and
  research subagents (moved from diecut, generalized)
- Sharpen review-and-fix trigger to avoid overlap with review-with-research
- Cross-reference between review-and-fix and dispatch-worktree-task
  explaining why each uses a different worktree strategy
- Specify subagent types in review-with-research (Explore for review,
  general-purpose with sonnet for research)
- Simplify review-and-fix step 6: Task tool result provides the branch
  name directly, no separate lookup needed
- Add .gitignore reminder for .worktrees/ in dispatch-worktree-task and
  review-with-research
Fix 3 bugs, 6 design issues, and 2 minor issues found during audit of
dispatch-worktree-task, review-and-fix, and review-with-research skills.

Key fixes:
- Add explicit cwd instruction for subagents in manual worktrees
- Handle already-checked-out branch with --detach in review-with-research
- Add clean working tree prerequisite before cherry-pick
- Replace "smoke test" with "reproduction command" for consistency
- Add Task tool parameter tables for review-with-research subagents
- Add wave sizing guidance for parallel agent dispatch
- Clarify domain skill invocation (read reference files, don't invoke Skill tool)
- Clarify file access patterns (git show for baseline, direct read for branch)
- Make .gitignore check actionable (check and add, not just "ensure")
- Add worktree cleanup step to dispatch-worktree-task
- dispatch-worktree-task: move push out of subagent to main session,
  add plan completeness gate, subagent failure instructions, stale
  worktree handling, reproduction escape hatch for refactorings
- review-and-fix: fix same-file sequencing (cherry-pick before second
  worktree), add zero-findings early exit, wave strategy, per-cherry-pick
  validation, simplify findings file handling, integrate task list as
  dispatch manifest, add user checkpoint before push
- review-with-research: add research topic derivation step, merge
  synthesis+verdict with reconciliation guidance, add edge case handling
  (empty diff, inconclusive research, contradictions), add handoff to
  review-and-fix
Serial review-fix loop that dispatches a reviewer agent, then a fixer
agent, commits, and repeats until findings converge to zero, plateau,
or hit an iteration cap.
@raiderrobert raiderrobert merged commit 6f6d948 into main Feb 28, 2026
3 checks passed
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