Sheldon Finlay
17e5eb707f
Generator-evaluator architecture with iterative context-reset for long-running coding tasks. Ships as a Claude Code plugin — install with /plugin and use /agent-loop:init, /agent-loop:plan, /agent-loop:run.
84 lines
2.2 KiB
Markdown
84 lines
2.2 KiB
Markdown
---
|
|
name: triage
|
|
description: Generate a human handoff brief summarizing loop status — completed, blocked, and remaining stories with recommended next steps.
|
|
---
|
|
|
|
# /triage — Generate Human Handoff Brief
|
|
|
|
Generate a triage brief summarizing the current state of a loop run. Use this when:
|
|
- The loop hit max iterations without completing
|
|
- You want a status check mid-run
|
|
- You're handing off to another developer
|
|
|
|
## Instructions
|
|
|
|
When the user invokes `/loop-triage`:
|
|
|
|
### Step 1: Read Current State
|
|
|
|
1. Read `.loop/prd.json` — get story statuses
|
|
2. Read `.loop/progress.md` — get session log and patterns
|
|
3. Read `.loop/config.json` — get mode and iteration settings
|
|
4. Check git log for recent commits on the loop branch
|
|
|
|
### Step 2: Analyze
|
|
|
|
For each story, determine:
|
|
- **Complete**: `passes: true`, verified by evaluator
|
|
- **In Progress**: `passes: false`, has been attempted (check progress.md for entries)
|
|
- **Blocked**: `passes: false`, rejected multiple times (check `rejections` count and `notes`)
|
|
- **Not Started**: `passes: false`, no progress.md entries, no rejections
|
|
|
|
### Step 3: Generate Brief
|
|
|
|
Write to `.loop/triage/TRIAGE_BRIEF.md`:
|
|
|
|
```markdown
|
|
# Triage Brief
|
|
|
|
Generated: {current date and time}
|
|
Mode: {mode from config.json}
|
|
Branch: {branchName from prd.json}
|
|
|
|
## Status Summary
|
|
|
|
- **Complete:** {N} stories
|
|
- **In Progress:** {N} stories
|
|
- **Blocked:** {N} stories (hit retry limit)
|
|
- **Not Started:** {N} stories
|
|
|
|
## Story Details
|
|
|
|
| ID | Title | Status | Rejections | Notes |
|
|
|----|-------|--------|------------|-------|
|
|
| US-001 | ... | Complete | 0 | |
|
|
| US-002 | ... | Blocked | 3 | Evaluator rejected: ... |
|
|
| US-003 | ... | Not Started | 0 | |
|
|
|
|
## Key Patterns Discovered
|
|
|
|
{Copy the Codebase Patterns section from progress.md}
|
|
|
|
## Blocked Stories — Analysis
|
|
|
|
For each blocked story, summarize:
|
|
- What was attempted
|
|
- Why it was rejected (from notes field)
|
|
- Suggested approach for a human to unblock it
|
|
|
|
## Recommended Next Steps
|
|
|
|
Based on the current state:
|
|
1. {Most important next action}
|
|
2. {Second priority}
|
|
3. {Third priority}
|
|
|
|
## Files Modified
|
|
|
|
{List all files changed across all commits on the loop branch, with brief descriptions}
|
|
```
|
|
|
|
### Step 4: Present to User
|
|
|
|
Show the summary inline and tell the user where the full brief is saved.
|