Development record
2026-07-13 — `abcd audit` (itd-85): a new read-only repo-conformance verb, distinct from
decisiondcn-2607130000000002
2026-07-13 — abcd audit (itd-85): a new read-only repo-conformance verb, distinct from
ahoy doctor (doctor = tool-setup health, audit = does-the-repo-conform). Bespoke on
internal/core/lint (adapt repolinter's rule-schema vocabulary + Conftest severity/exit
codes + SARIF as an optional export), zero new deps → no dependency gate. v1 = five rules
(three-tier-layout, conventions-router, decision-durability, docs-currency, privacy-hygiene);
SARIF deferred to P3; wires into prepare-this-repo Phase 2, closing iss-86. SOTA-researched
in plan 2026-07-13-abcd-audit-verb.md.
Frontmatter
| id | dcn-2607130000000002 |
|---|---|
| type | decision |
| date | 2026-07-13 |
.abcd/work/decisions/dcn-2607130000000002-abcd-audit-itd-85-a-new-read-only.md
open on GitHub ↗ · commit history ↗
mentions2
- iss-86abcd has no read-only convention-audit surface, and the binary gap model is disjoint from the prepare-this-repo skill audit. abcd ahoy --json on a partially-scaffolded repo reports only abcd own install-plumbing gaps (config.json, rules.json, marker blocks, history store) and is silent on the gaps the onboarding skill exists to fix: the missing committed .abcd/work/ tier, the absent AGENTS.md conventions router, and durable decisions leaking into the gitignored layer. The entire Phase 2 gap report had to be produced by hand. Detector: a read-only abcd audit (or extended ahoy doctor) verb that checks the three-tier layout, decision-durability, docs Diataxis/tense, and privacy -- every convention the skill audits by prose. Acceptance corpus (Manuscripts dogfood): (a) missing .abcd/work/ tier undetected, (b) decisions/ vs decisions/adrs/ layout drift undetected, (c) whole convention audit done manually. This is the single highest-value onboarding gap: it is what would make prepare-this-repo engine-backed instead of agent-glue.
- itd-85A Read-Only Repo-Conformance Audit