Plan a phase by creating and reviewing issues
Plan a phase of work for the {team_name} team. Decomposes phase scope into GitHub Issues, assigns them, reviews from multiple perspectives, and proposes a wave structure.
Read available context to determine what this phase should accomplish:
cross-repo-status.json) for dependency contextgh issue list --state open --label "tech-debt" --json number,title,labels
cat .claude/cross-repo-status.json 2>/dev/null
For each work item, create a GitHub Issue with:
phase-{N}), repo label, category (feature, bug, tech-debt, security, infra)gh issue create --title "{title}" --body "$(cat <<'EOF'
## Summary
{description}
## Acceptance Criteria
- [ ] {criterion 1}
- [ ] {criterion 2}
## Origin
{why this work exists — user request, retro finding, dependency, etc.}
EOF
)" --label "phase-{N}" --label "{category}"
For each issue, determine the best assignee based on:
Apply the assignee label:
gh issue edit {NUMBER} --add-label "{FIRSTNAME_LASTNAME}"
Review each issue from 6 perspectives. For each perspective, assess whether the issue description is complete and whether there are concerns:
| Perspective | Focus |
|---|---|
| Architecture | System design, API contracts, data model impact |
| DevOps | Deployment impact, infrastructure needs, CI changes |
| Data | Data migration, pipeline impact, schema changes |
| Tech Lead | Scope accuracy, effort estimate, risk |
| QA | Testability, edge cases, acceptance criteria completeness |
| Security | Auth impact, input validation, data exposure |
For each concern raised, either:
gh issue comment {NUMBER} --body "$(cat <<'EOF'
**{Perspective} Review**
{findings — concerns, suggestions, or "No concerns"}
EOF
)"
Build a dependency graph across the proposed issues:
Group issues into waves based on:
Present the proposed structure:
**Phase {N} Plan**
### Wave 1: {theme}
| Issue | Title | Assignee | Priority | Dependencies |
|-------|-------|----------|----------|--------------|
| #N | ... | Name | bug | None |
### Wave 2: {theme}
| Issue | Title | Assignee | Priority | Dependencies |
|-------|-------|----------|----------|--------------|
| #N | ... | Name | feature | Wave 1: #M |
**Total issues:** {count}
**Estimated waves:** {count}
**Cross-repo dependencies:** {list or "None"}
Display the full plan. Do NOT create issues or start implementation without user approval. The user may: