Track workflow phase transitions in recap

[acreeger]

Summary

Add phase tracking to the recap so the VS Code panel can show a breadcrumb of workflow progress. Use startsubagent hooks to detect phase transitions.

Phase Transitions

The iloom workflow has these phases:

• Enhancement
• Complexity Evaluation
• Analysis
• Planning
• Implementation

Each phase corresponds to a subagent being started (e.g., @agent-iloom-issue-analyzer).

Implementation

1. Add startsubagent hook - Fires when a subagent starts, captures agent name
2. Map agent name to phase - e.g., agent-iloom-issue-analyzer → "Analysis"
3. Update recap with current phase - New field in recap JSON

Schema Addition

{
  "filePath": "...",
  "goal": null,
  "startedAt": "2025-12-16T10:00:00Z",
  "currentPhase": "analysis",
  "phaseHistory": [
    { "phase": "enhancement", "startedAt": "2025-12-16T10:01:00Z" },
    { "phase": "complexity", "startedAt": "2025-12-16T10:03:00Z" },
    { "phase": "analysis", "startedAt": "2025-12-16T10:05:00Z" }
  ],
  "entries": [...],
  "artifacts": [...]
}

Hook Integration

The hook fires on subagent start:

on: startsubagent
run: # update recap with phase transition

Related

• VS Code display: iloom-ai/iloom-vscode#TBD
• Part of Loom Context Panel feature set

[acreeger]

VS Code display: iloom-ai/iloom-vscode#52