Skip to content

feat: add /sprint skill for Linux-native parallel sprints#222

Open
AaronLPS wants to merge 4 commits intogarrytan:mainfrom
AaronLPS:feat/sprint-skill
Open

feat: add /sprint skill for Linux-native parallel sprints#222
AaronLPS wants to merge 4 commits intogarrytan:mainfrom
AaronLPS:feat/sprint-skill

Conversation

@AaronLPS
Copy link

Summary

  • New /sprint skill — parallel sprint orchestration using git worktrees + tmux, as a free and open alternative to Conductor (which is Mac-only GUI)
  • Works on Linux, macOS, and WSL. Graceful fallback when tmux is not installed
  • Five subcommands: new, list, switch, done, dashboard
  • Default auto-accept mode (--dangerously-skip-permissions) for autonomous parallel agents, opt-out with --supervised
  • Integration with existing gstack skills — auto-run any skill on sprint creation (e.g. auth-fix review)
  • Full {{PREAMBLE}} support: update check, session tracking, contributor mode, analytics

Why Linux users need this

gstack's README recommends Conductor for running 10-15 parallel sprints. But Conductor is a Mac-only GUI app. Linux users (and CLI-purists on any platform) can achieve the exact same parallelism using git worktrees + tmux — tools they already have. This skill makes that workflow first-class in gstack.

Files changed

File What
sprint/SKILL.md.tmpl New skill template
sprint/SKILL.md Generated skill (via gen-skill-docs)
scripts/gen-skill-docs.ts Registered sprint in template finder
SKILL.md.tmpl + SKILL.md Added /sprint to skill suggestion list
README.md Added to power tools table + parallel sprints section
CLAUDE.md Added to project structure
docs/skills.md Deep-dive section with philosophy, example, troubleshooting

Example interaction

You: /sprint
Claude: 
  Sprint Manager — git worktrees + tmux

  Active sprints:
  | Sprint        | Branch              | tmux window       | Age  |
  |---------------|---------------------|-------------------|------|
  | auth-rework   | sprint/auth-rework  | sprint:auth-rework | 23m |
  | onboarding-ui | sprint/onboarding-ui| sprint:onboarding-ui | 1h |

  What would you like to do?
  A) New sprint — create isolated worktree + tmux window
  B) List all sprints — detailed dashboard  
  C) Switch to a sprint — jump to its tmux window
  D) Complete a sprint — merge/PR/cleanup
  E) Dashboard — full status view

Test plan

  • bun test — 370 skill validation tests pass (0 failures)
  • bun run gen:skill-docs --dry-run — all 23 SKILL.md files FRESH
  • Manual testing: created sprints, switched between them, completed with PR
  • Verified tmux fallback mode (prints manual commands when tmux unavailable)
  • Verified auto-accept mode launches Claude with --dangerously-skip-permissions

🤖 Generated with Claude Code

AaronLPS and others added 4 commits March 19, 2026 18:44
Git worktrees + tmux as a free, open alternative to Conductor for
running 10-15 parallel Claude Code sessions. Works on Linux, macOS,
and WSL. Graceful fallback when tmux is not installed.

Subcommands: new, list, switch, done, dashboard.
Integration with existing gstack skills via auto-run on sprint creation.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
When creating a new sprint, the user can choose to run Claude Code with
--dangerously-skip-permissions for fully autonomous parallel work, or
normal mode for supervised sprints.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Reduces interaction from two separate questions to one combined prompt.
User enters sprint name and picks auto-accept vs normal mode in one step.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Auto-accept (--dangerously-skip-permissions) is now the default for
new sprints. Users who want supervised mode add --supervised flag.
Eliminates the second permission question entirely.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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