The-Artificer-of-Ciphers-LLC/skills-from-the-artificer / adr-phase-coverage
adr-phase-coverage
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.7 KB |
| assets/trace.adr1244-broken.json | config | 2.0 KB |
| assets/trace.example.json | config | 2.4 KB |
| evals/evals.json | config | 3.0 KB |
| evals/fixtures/ROADMAP-apikeys.md | markdown | 893 B |
| evals/fixtures/adr-0007-apikeys.md | markdown | 1.1 KB |
| evals/trigger-eval.json | config | 3.7 KB |
| references/adapting-to-your-repo.md | markdown | 4.6 KB |
| references/anti-patterns.md | markdown | 5.5 KB |
| references/methodology.md | markdown | 5.4 KB |
| scripts/check_coverage.py | script | 11.2 KB |
assets/trace.example.json
View on GitHub{
"_comment": "A PASSING decomposition (the corrected ADR-1244). Copy this shape. The id strings are yours to choose — D1..Dn for ADR decisions, and a readable id like 'UX-manage' for each user-facing capability the ADR PROMISES. Mark user_facing:true for anything the user directly invokes/sees (a command, route, screen). Every decision must be owned by exactly one phase; every defer must land in a phase that owns or accepts it; every user-facing capability must have an owning phase whose accepts names the wired surface.",
"adr": "ADR-1244 (corrected)",
"decisions": [
{"id": "D1", "title": "Versioned capability manifest", "user_facing": false},
{"id": "D2", "title": "Runtime registry overlay", "user_facing": false},
{"id": "D3", "title": "Source resolver (URL importer)", "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; CI stamps native versions"], "defers": []},
{"id": "2", "name": "Registry overlay", "owns": ["D2"], "accepts": ["loadRegistry composes installed overlay over first-party"], "defers": []},
{"id": "3", "name": "Resolver + ledger", "owns": ["D3", "D4"], "accepts": ["resolveCapabilitySource 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": "6", "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 + management command", "owns": ["D9", "UX-manage"], "accepts": ["capability matrix generated from registry", "user can run the `gsd capability install/update/remove/list` CLI command (wired to the Phase-4 lifecycle)"], "defers": []}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |