chronicle-mcp: Skill for Claude Code

Write Skill Subdocs

Extract heavy reference material (lookup tables, schemas, templates) from SKILL.md into auxiliary sub-documents (REFERENCE.md or <DOMAIN>.md) via progressive disclosure.

Workflow

flowchart TD
    Start["Target SKILL.md"] --> Audit["1. Inventory & Log brain/RATIONALE.md"]
    Audit --> Evaluate{"Evaluate Routing Gates"}
    
    Evaluate -->|"No signals & < 150 lines"| Gate0["Gate 0: No Extraction (Exit)"]
    Evaluate -->|"Global shared references"| Gate1["Gate 1: Single REFERENCE.md"]
    Evaluate -->|"Branch-specific domains"| Gate2["Gate 2: Multiple DOMAIN.md"]
    
    Gate1 --> Plan["Draft Subdocs & Refactor Plan"]
    Gate2 --> Plan
    
    Plan --> UserGate{"User Approval Gate"}
    UserGate -->|"Revisions"| Plan
    UserGate -->|"Approved"| Apply["Apply Edits & agents distribute"]

---

Directives

1. Optimization Invariant: MUST minimize $\sum(\text{reference bytes loaded per execution path})$ per HEURISTICS.md.
2. 1-Level Depth Limit: Extracted sub-documents MUST be 1-level deep relative to SKILL.md; NEVER link nested sub-documents from within a subdoc.
3. No Over-Specification: When linking extracted subdocs from SKILL.md, MUST use concise topic anchors (e.g., - Domain rules: see [DOMAIN.md](DOMAIN.md)) without cataloging internal contents.
4. Approval Gate: NEVER edit target SKILL.md or write subdocs before presenting RATIONALE.md and obtaining explicit user approval.

---

Routing Gates

Gate	Condition	Action
Gate 0 (No Extraction)	No primary signals in HEURISTICS.md AND linear prose < ~150 lines	Log rationale in RATIONALE.md and exit without modifying files.
Gate 1 (Single Subdoc)	Primary signals present, but references are globally needed across all paths	Extract to single REFERENCE.md.
Gate 2 (Domain Subdocs)	Primary signals present and isolated to independent execution branches	Extract to multiple <DOMAIN>.md files (Overlapping Subdocs Principle).