chronicle-mcp: Skill for Claude Code

Implement a Ticket

Execute mature, well-specified tickets directly from their acceptance criteria without recreating redundant implementation plans.

Directives

1. Zero-Plan Mandate (No Re-planning): NEVER generate a new implementation_plan.md when a ticket already contains an explicit Acceptance Criteria checklist. The ticket's checklist IS the execution plan.
2. Context Pre-fetch: Run node <skill-dir>/scripts/fetch-ticket.js <ticket-id-or-url> to download both the ticket and its parent PRD to .scratch/tickets/.
3. Targeted Seam Exploration: Inspect only the codebase seams and tests relevant to the current ticket before execution.
4. Single-Step Progression: Mark progress directly on the ticket criteria: [ ] -> [/] (max 1 active) -> [x].
5. Empirical Verification: Run test commands (npm test, build checks) to prove each acceptance criterion passes before marking [x].
6. Atomic Close & Handoff:
   • Commit changes referencing the ticket (e.g. feat(scope): title (closes #<id>)).
   • Run node <skill-dir>/scripts/close-ticket.js <ticket-id> on completion.
   • If next unblocked ticket exists: ask "Do you want me to read Ticket <N> and implement?".
   • If all tickets in PRD are done: close parent PRD and output delivery summary.

Workflow

flowchart TD
    Start["Ticket URL / Issue ID"] --> Fetch["1. Run fetch-ticket.js (Pulls Ticket + Parent PRD)"]
    Fetch --> Inspect["2. Inspect relevant codebase seams & tests"]
    Inspect --> Confirm{"3. Report summary & ask: Implement?"}
    Confirm -->|"User Approves / T3"| Loop["4. Execute Acceptance Criteria [ ] -> [/] -> [x] (TDD)"]
    Confirm -->|"Clarifications / No"| Stop["Address feedback"]
    Loop --> Verify{"All criteria [x] and tests pass?"}
    Verify -->|"No"| Fix["Fix & re-run tests"] --> Loop
    Verify -->|"Yes"| CommitClose["5. Commit, push & run close-ticket.js"]
    CommitClose --> NextCheck{"Next unblocked ticket in PRD?"}
    NextCheck -->|"Yes"| AskNext["Ask: Do you want me to read Ticket N and implement?"]
    NextCheck -->|"No (All Done)"| ClosePRD["Close Parent PRD & Output Final Report"]