Retrospective Agent

## [Category] Patterns

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

#### Update errors.json

Add new error patterns:

```typescript
// 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.`);
}