diff --git a/openspec/changes/correct-documentation-drift/design.md b/openspec/changes/correct-documentation-drift/design.md index e08f186..e6f51b7 100644 --- a/openspec/changes/correct-documentation-drift/design.md +++ b/openspec/changes/correct-documentation-drift/design.md @@ -122,3 +122,22 @@ something is, and a path that resolves does not verify the claim. *Alternative considered:* delete `CLAUDE.md` in the repositories that reduced it to a pointer, so stale references fail loudly. Claude Code loads that file by name; removing it removes the pointer's purpose. + +## Found, not covered + +Two findings surfaced while applying that no requirement in this change reaches. +They are recorded here rather than as tasks: a task list carries only its own +change's work, and a forward reference would block this change from archiving. + +**gohai's collector legend contradicts itself.** `docs/collectors/README.md` +defines `✅` twice — "implemented and tested" and "planned" — and declares `⚠️` = +partial, a state no row uses. The requirements here cover references that do not +resolve and counts that do not match. A document that disagrees with itself is +neither. The fix was written and reverted; it needs its own change. + +**Repositories disagree on where plans live.** `gohai` says `docs/superpowers/`; +`osapi`, `nats-client`, `nats-server`, and `osapi-justfiles` say `docs/plans/`. +Each now states the directory is created on first use, which satisfies "a path +exists, or the documentation says it does not yet". Choosing one location is a +standardization decision, and `repo-standards` deliberately does not impose a +section structure on `AGENTS.md`, so no requirement covers it today. diff --git a/openspec/changes/correct-documentation-drift/tasks.md b/openspec/changes/correct-documentation-drift/tasks.md index c856917..e6dad88 100644 --- a/openspec/changes/correct-documentation-drift/tasks.md +++ b/openspec/changes/correct-documentation-drift/tasks.md @@ -107,17 +107,3 @@ Fixed under requirements this change already carries, but not enumerated above. per-module sections - [x] 9.9 `osapi-justfiles` — `AGENTS.md` points at a `docs/plans/` directory that does not exist - -### Deferred — no requirement covers it - -- [ ] 9.10 `gohai` — `docs/collectors/README.md`'s legend defines `✅` twice - ("implemented and tested" and "planned") and declares `⚠️` = partial, which no - row uses. A document contradicting itself is neither a broken reference nor a - miscount, so nothing in this change's spec reaches it. Needs its own change. - -### Left standing — a decision, not drift - -- [ ] 9.11 `gohai` says plans live in `docs/superpowers/`; `osapi`, - `nats-client`, `nats-server`, and `osapi-justfiles` say `docs/plans/`. Each - now states the directory is created on first use, which satisfies the - requirement. Choosing one location belongs to `standardize-repository-layout`.