ibrahim-3d/conductor-orchestrator-superpowers/retrospective-agent

## Track Analysis: [track-id]
 
### Execution Summary
-**Total Tasks**: 12
-**Fix Cycles**: 1
-**Lead Consultations**: 3
-**Duration**: Plan to Complete
 
### What Worked Well
-[Extracted from smooth tasks with no fix cycles]
 
### What Caused Problems
-[Extracted from fix cycles and blocked tasks]
 
### Patterns Discovered
-[New solutions that could be reused]
 
### Errors Encountered
-[New error patterns and their fixes]

### [Pattern Name]
**Category**: [UI | State | API | Auth | Integration | Testing | Performance]
**Discovered**: [track-id] on [date]
**Problem**: What problem does this solve?
**Solution**: How to implement it
**Code Example**: (key code snippet)
**Gotchas**: Watch out for...

{
  "id": "err-XXX",
  "pattern": "Regex pattern matching the error",
  "category": "typescript|react|nextjs|supabase|stripe|etc",
  "context": "When this error typically occurs",
  "problem": "What causes this error",
  "solution": "How to fix it",
  "code_fix": "Code snippet if applicable",
  "occurrences": 1,
  "last_seen": "2026-01-31",
  "discovered_in": "track-id"
}

## [Category] Patterns
 
### [New Pattern Name]
**Category**: [Category]
**Discovered**: [track-id] on [YYYY-MM-DD]
**Problem**: [Problem statement]
**Solution**: [Solution description]
**Code Example**:

**Gotchas**: [Warnings]

// read_file current errors.json
const errors = JSON.parse(await readFile('conductor/knowledge/errors.json'));
// Add new error
errors.errors.push({
  id: `err-${String(errors.errors.length + 1).padStart(3, '0')}`,
  pattern: "New error pattern regex",
  category: "category",
  context: "When this occurs",
  problem: "What causes it",
  solution: "How to fix",
  code_fix: "Code if applicable",
  occurrences: 1,
  last_seen: new Date().toISOString().split('T')[0],
  discovered_in: trackId
});
// write_file back
await writeFile('conductor/knowledge/errors.json', JSON.stringify(errors, null, 2));

# Retrospective: [Track ID]
 
**Completed**: [YYYY-MM-DD]
**Duration**: [X days/hours]
**Fix Cycles**: [N]
 
## Summary
 
[1-2 sentence summary of what the track accomplished]
 
## What Worked Well
 
-[Thing 1]
-[Thing 2]
 
## What Caused Problems
 
-[Problem 1]: [How it was resolved]
-[Problem 2]: [How it was resolved]
 
## Patterns Extracted
 
-**[Pattern Name]** → Added to patterns.md under [Category]
 
## Errors Logged
 
-**[Error Pattern]** → Added to errors.json as err-XXX
 
## Skill Improvements Proposed
 
-[ ] [Improvement 1] — [Which skill to update]
-[ ] [Improvement 2] — [Which skill to update]
 
## Recommendations for Similar Tracks
 
-[Advice for future tracks doing similar work]

{
  "track_id": "feature-name_20260131",
  "completed_at": "2026-01-31T15:00:00Z",
  "patterns_added": [
    {
      "name": "Pattern Name",
      "category": "Category",
      "added_to": "conductor/knowledge/patterns.md"
    }
  ],
  "errors_added": [
    {
      "id": "err-011",
      "pattern": "Error pattern",
      "added_to": "conductor/knowledge/errors.json"
    }
  ],
  "skill_improvements": [
    {
      "skill": "loop-executor",
      "improvement": "Add checkpoint after each task for better resumption",
      "priority": "medium"
    }
  ],
  "retrospective_file": "conductor/tracks/feature-name_20260131/retrospective.md"
}

// In conductor-orchestrator, after track reaches COMPLETE
async function runRetrospective(trackId: string) {
  const result = await Task({
    subagent_type: "general-purpose",
    description: "Run track retrospective",
    prompt: `You are the retrospective-agent.
      Track: ${trackId}
      1. read_file conductor/tracks/${trackId}/plan.md
      2. read_file conductor/tracks/${trackId}/metadata.json
      3. Analyze what worked and what failed
      4. Extract patterns → Update conductor/knowledge/patterns.md
      5. Extract errors → Update conductor/knowledge/errors.json
      6. write_file retrospective to conductor/tracks/${trackId}/retrospective.md
      Return summary of learnings added.`
  });
  console.log(`Retrospective complete. ${result.patterns_added.length} patterns, ${result.errors_added.length} errors added.`);
}