coaia-planning: Plan Decomposition to STCs
Emergence Context
From session e3991fb4-dcf1-4e36-885c-3a5131564d6c exploring Keeper Chronicles MCP integration.
The Pattern
``` coaia-narrative → STC creation/management (MCP tools) coaia-visualizer → STC viewing/editing (WebUI) coaia-planning → Plan decomposition into STCs (Claude integration) ```
Core Function
Transform Claude plan files (.md) into structural tension chart JSONL compatible with coaia-narrative.
Input → Output
``` Input: /home/mia/.claude/plans/<plan-name>.md Output: <project>-planning.jsonl (coaia-narrative format) Trace: Langfuse observation with plan→STC mapping ```
Mapping Rules
| Plan Element | STC Element | Notes |
|---|---|---|
| Episode/Phase | structural_tension_chart entity | One chart per major section |
| Goal/Objective | desired_outcome entity | Extract from headers/bullets |
| Current state | current_reality entity | Framework's current evolution |
| Implementation steps | action_step entities | Key tasks with due dates |
| Dependencies | Relations (advances_toward) | Cross-chart connections |
MCP Tool Candidates
```typescript // Core tools parse_claude_plan // Read .md plan, extract structure create_plan_stc // Generate STC from plan section list_plan_sections // Navigate plan structure sync_plan_to_charts // Update existing charts from plan changes
// Integration tools export_to_visualizer // Generate coaia-visualizer compatible output create_langfuse_trace // Document plan→STC transformation ```
miette Integration
Replaces manual work in miette_claude_plan_perspective_claude.sh:
- Current: Script parses plan, creates temp prompt, launches Claude agent
- With coaia-planning: Direct MCP calls to decompose plan
Architecture Sketch
``` ┌─────────────────────────────────────────────────────┐ │ Claude Session │ ├─────────────────────────────────────────────────────┤ │ │ │ ┌──────────────┐ ┌──────────────────┐ │ │ │ Claude Plan │───►│ coaia-planning │ │ │ │ (.md file) │ │ (MCP) │ │ │ └──────────────┘ └────────┬─────────┘ │ │ │ │ │ ┌─────────────────────┼─────────────────┐ │ │ ▼ ▼ ▼ │ │ ┌──────────────┐ ┌──────────────┐ ┌────────┐│ │ │coaia-narrative│ │ Langfuse │ │ Redis ││ │ │ (.jsonl) │ │ (traces) │ │(state) ││ │ └──────────────┘ └──────────────┘ └────────┘│ │ │ │ │ ▼ │ │ ┌──────────────┐ │ │ │coaia-visualizer │ │ │ (WebUI) │ │ │ └──────────────┘ │ │ │ └─────────────────────────────────────────────────────┘ ```
Next Steps
- Create coaia-planning package structure (mirror coaia-narrative)
- Implement plan parsing logic (markdown → sections)
- Define STC generation rules
- Add Langfuse integration
- Test with proud-watching-sutton.md
Related Files
/src/coaia-narrative/index.ts- Reference implementation/src/coaia-visualizer/lib/types.ts- Type definitions to extend/src/miette/claude-plan-insights/miette_claude_plan_perspective_claude.sh- Manual workflow to formalize