Architecture Decision Records

• 1. Go + Cobra CLI
• 2. Single llama.cpp Instance for Routing and Coding
• 3. Claude via CLI Subprocess, not Direct API
• 4. Context Handoff via --append-system-prompt
• 5. Session Storage as JSON Files Indexed by cwd
• 6. CLAUDE_WAITING State for Turn-Level Routing
• 7. Local Model Self-Escalation via Function Call
• 8. Branching Strategy and Conventional Commits
• 9. Router Signal Extractor and Weighted Scorer
• 10. Interactive REPL Mode (superseded by 14)
• 11. Claude Pipe-Only Mode with Stdin Disconnect
• 12. Claude Tool and Directory Permission Handling
• 13. Structured Permission Prompts via --permission-prompt-tool stdio
• 14. Full TUI with bubbletea viewport+textarea (partially superseded by 19)
• 15. TUI-native permission prompts via blocking goroutine + channel
• 16. Memory System: Percept Store with NREM Consolidation
• 17. OpenTelemetry-native Observability with File Exporters
• 18. Streaming Tool-Format Detector for Multi-Model Compatibility
• 19. TUI Input History Persistence and Turn Cancellation
• 20. Memory System Refinements: Reachable Promotion and User-Stated Facts
• 21. Memory TUI Panel and Interactive Management Commands
• 22. Claude Percept Skill: Nonce Tags, Consumer Hints, and Bidirectional Memory
• 23. AWS Credential Injection for Bedrock-backed Claude Subprocess
• 24. TUI Selection, Copy/Paste, and Welcome Screen
• 25. Memory Decay Constant Re-tuning
• 26. Tool-Usage UI: Inline ⚙ Hint Line
• 27. Remote Inference Authentication Transports
• 28. Multi-Provider Local-Agent Configuration (superseded by 30)
• 29. Summary Bricks for Escalation Context
• 30. Agent Flavours: Unified Config and Escalation Refactor
• 31. Local Agent Percept Writing, Dynamic Consumer Hints, and CurrentNeed Early-Exit Fallback
• 32. Returning Fresh-Start on Stale Context
• 33. Unified TurnRunner Interface for Agent Dispatch
• 34. Agent as Tool
• 35. Stream-closed Pre-flight Denial Detection and Retry
• 36. MCP stdio Subprocess Transport
• 37. Experimental Permission Management
• 38. Move user-turn AddTurn to after Execute
• 39. Native Workflow Engine
• 40. Log Rotation and Simplification
• 41. Time-Based CurrentNeed Expiry
• 42. Preserve reasoning_content Across Multi-Turn Tool Calls