Add issue triage system to prevent deferred issue pile-up

- /gsd:consider-issues reviews issues with codebase context
- Phase completion now prompts for issue review
- Auto-categorizes: resolved, urgent, natural-fit, can-wait
- README: explain context exhaustion problem and subagent solution

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Lex Christopherson
2025-12-15 08:25:51 -06:00
parent c6439a2c9c
commit 2e1b0b8d70
5 changed files with 266 additions and 4 deletions

View File

@@ -84,6 +84,7 @@ GSD handles it for you:
| `STATE.md` | Decisions, blockers, position — memory across sessions |
| `PLAN.md` | Atomic task with XML structure, verification steps |
| `SUMMARY.md` | What happened, what changed, committed to history |
| `ISSUES.md` | Deferred enhancements tracked across sessions |
Size limits based on where Claude's quality degrades. Stay under, get consistent excellence.
@@ -109,11 +110,15 @@ Precise instructions. No guessing. Verification built in.
### Subagent Execution
Plans run in fresh contexts:
As Claude fills its context window, quality degrades. You've seen it: "Due to context limits, I'll be more concise now." That "concision" is code for cutting corners.
- 0% overhead to start
- Maximum quality, zero degradation
- Walk away, come back to completed work
GSD prevents this. Each plan is maximum 3 tasks. Each plan runs in a fresh subagent — 200k tokens purely for implementation, zero accumulated garbage.
- Task 1: fresh context, full quality
- Task 2: fresh context, full quality
- Task 3: fresh context, full quality
No degradation. Walk away, come back to completed work.
### Clean Git History
@@ -147,6 +152,7 @@ You're never locked in. The system adapts.
| `/gsd:list-phase-assumptions [N]` | See what Claude thinks before you correct it |
| `/gsd:pause-work` | Create handoff file when stopping mid-phase |
| `/gsd:resume-work` | Restore from last session |
| `/gsd:consider-issues` | Review deferred issues, close resolved, identify urgent |
| `/gsd:help` | Show all commands and usage guide |
---