chronicle-mcp: Skill for Claude Code

Implement With Subagents

Orchestrate multi-ticket or multi-step execution using sequential subagents, empirical context monitoring via chronicle, and strict separation of specs from orchestrator prompts.

Core Principles

1. Zero Specs in Prompt (No Prompt Telephone Game):

   • The orchestrator prompt MUST NOT summarize, paraphrase, or re-explain requirements or acceptance criteria.
   • The prompt contains ONLY:
     • Target Ticket / Plan / Spec artifact path.
     • Git operational instructions (target branch, conventional commit template, issue closing directive closes #XX).
     • Tool and verification directives (e.g., test commands, linters).
   • The subagent MUST read the artifact file directly from disk.

2. Sequential Ticket Execution:

   • Dispatch one ticket at a time to ensure atomic commits, clean git history, and conflict-free testing.

3. Data-Driven Context Lifecycle Management:

   • Before assigning the next ticket to an existing subagent, inspect its context health using chronicle MCP tool get_session_benchmarks.
   • Never guess whether a subagent is degraded or truncated.

Workflow Decision Tree

flowchart TD
    Start["Ticket Ready to Dispatch"] --> HasSubagent{"Active Subagent Exists?"}
    
    HasSubagent -->|"No"| SpawnNew["invoke_subagent (Fresh Context)<br/>• Model: inherit<br/>• Role: Ticket Implementer"]
    
    HasSubagent -->|"Yes"| QueryBench["Call chronicle: get_session_benchmarks<br/>for subagent sessionId"]
    
    QueryBench --> EvaluateHealth{"Evaluate Context Health:<br/>• Checkpoint Count == 1 (Truncation count == 0)?<br/>• Curr. Context < 90,000 tokens?"}
    
    EvaluateHealth -->|"Healthy (Pass)"| ReuseSubagent["send_message (Continue Subagent)<br/>Pass next Ticket path + Git mandate"]
    EvaluateHealth -->|"Degraded / Truncated (Fail)"| SpawnNew
    
    SpawnNew --> WaitSubagent["Subagent reads Ticket file directly<br/>Executes TDD & implementation"]
    ReuseSubagent --> WaitSubagent
    
    WaitSubagent --> SubagentDone["Subagent Reports:<br/>• Modified files<br/>• Test & build output<br/>• Commit hash"]
    
    SubagentDone --> VerifyCommit["Orchestrator verifies test status & git log"]
    VerifyCommit --> MoreTickets{"More Tickets in Queue?"}
    MoreTickets -->|"Yes"| HasSubagent
    MoreTickets -->|"No"| Finalize["All Tickets Implemented → Final Quality Gate"]