Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions openspec/changes/correct-documentation-drift/design.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
14 changes: 0 additions & 14 deletions openspec/changes/correct-documentation-drift/tasks.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.