Skip to content

The-Artificer-of-Ciphers-LLC/skills-from-the-artificer / adr-phase-coverage

adr-phase-coverage

Verified

Use when a user needs to turn a design doc, ADR, RFC, or spec into a phased implementation plan — or verify that an existing phase breakdown actually covers everything the design promised. The failure mode this catches: Phase N defers a deliverable to Phase N+1, Phase N+1 never claims it, and it ships as promised-but-not-built. Trigger when users say: 'break this into phases', 'turn this ADR/RFC into a roadmap', 'is my phase plan complete', 'what slips between phases', 'sanity check my phase breakdown', 'audit this epic for coverage gaps', or ask to sequence any architectural work into milestones. Also trigger on `/adr-phase-coverage`. Do NOT trigger for: authoring a new ADR, updating ADR rationale, writing a PRD, debugging a stuck deploy, or dependency analysis.

assets/trace.adr1244-broken.json

View on GitHub
{
  "_comment": "The HISTORICAL ADR-1244 decomposition that shipped the gap. Phase 4 built the lifecycle library and deferred the user-facing command to 'Phase 5'; Phase 5's real scope was registry dispatch (D7), so it never claimed UX-manage. The command belonged to nobody across all 6 phases. Run the checker on this file to see it caught.",
  "adr": "ADR-1244 (as-shipped, broken)",
  "decisions": [
    {"id": "D1", "title": "Versioned capability manifest", "user_facing": false},
    {"id": "D2", "title": "Runtime registry overlay", "user_facing": false},
    {"id": "D3", "title": "Source resolver", "user_facing": false},
    {"id": "D4", "title": "Capability ledger", "user_facing": false},
    {"id": "D5", "title": "Trust model / consent gate", "user_facing": false},
    {"id": "D6", "title": "Upgrade + compatibility", "user_facing": false},
    {"id": "D7", "title": "Registry-driven dispatch", "user_facing": false},
    {"id": "D9", "title": "Capability matrix", "user_facing": false},
    {"id": "UX-manage", "title": "User can run `gsd capability install/update/remove/list`", "user_facing": true}
  ],
  "phases": [
    {"id": "1", "name": "Versioned manifest", "owns": ["D1"], "accepts": ["capability.json carries version + engines.gsd"], "defers": []},
    {"id": "2", "name": "Registry overlay", "owns": ["D2"], "accepts": ["loadRegistry composes installed overlay"], "defers": []},
    {"id": "3", "name": "Resolver + ledger", "owns": ["D3", "D4"], "accepts": ["resolver stages copy-only; ledger records installs"], "defers": []},
    {"id": "4", "name": "Trust gate + upgrade", "owns": ["D5", "D6"], "accepts": ["installCapability/upgradeCapability/removeCapability library functions exist + tested"], "defers": [{"to": "5", "what": "UX-manage"}]},
    {"id": "5", "name": "Registry-driven dispatch", "owns": ["D7"], "accepts": ["graphify/intel/audit dispatched via the registry seam"], "defers": []},
    {"id": "6", "name": "Matrix + docs", "owns": ["D9"], "accepts": ["capability matrix generated; diataxis docs written"], "defers": []}
  ]
}
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 196kUpdated Claude CodeCodexVerifiedInstall