Skip to content

feat: add workflow skills#15

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

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

Conversation

@raiderrobert

Copy link
Copy Markdown
Owner

Summary

  • review-and-fix: Review code on a branch with a domain skill, document findings, dispatch parallel worktree agents to fix each issue, cherry-pick results back, verify, and push. Language-agnostic orchestration workflow.
  • dispatch-worktree-task: Dispatch a planned task to a background worktree subagent for isolated execution. Moved from diecut repo and generalized (removed bead references, made language-agnostic).
  • review-with-research: Review a branch with parallel code-review and research subagents, synthesize into an evidence-based verdict. Moved from diecut repo and generalized (Rust-specific examples made ecosystem-neutral).

Test plan

  • Verify all three skills appear in the skills list in a new session
  • Trigger phrases don't conflict with existing skills
  • Invoke review-and-fix on a branch with known issues

…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 896732d into main Feb 28, 2026
2 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