- System Layer Architecture (graph TD): shows VSCode Host, Hook Engine,
Data Layer, and LLM with all data flow edges
- Agent Sequence Diagram: full two-stage state machine handshake flow
from user message → select_active_intent → write_to_file → trace
- Hook Engine State Machine (stateDiagram): NoIntent → IntentDeclared →
ScopeCheck → ToolExecutes → TraceWritten transitions with blocked states
- Pre-Hook Interceptor Chain (flowchart): decision tree for mutating vs
safe tools, IntentGate, ScopeGuard, and TraceLedger
- Traceability Chain: Business Requirement → Intent → Code → SHA-256 Hash
→ Git SHA → agent_trace.jsonl golden thread
- Data Model Class Diagram: ActiveIntent, TraceRecord, FileTrace,
Contributor, Range, Related, HookEngine with relationships
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
