docs: prdlint is PRD-only; docs/architecture and ARCHITECTURE.md are ungated #1253

Closed
opened 2026-10-27 13:39:38 +00:00 by sam · 0 comments
Owner

prdlint (tools/prdlint, task docs:prds) governs docs/prds only. The same
session-bound writing lives in the other documentation of record, which is
read far more often:

grep -rE '.go:[0-9]+' docs/architecture ARCHITECTURE.md CLAUDE.md

docs/architecture is authoritative for settled design, so a line citation that
has drifted there misleads harder than one in a Draft PRD.

Not folded into the sweep because the rules are not identical. An architecture
doc legitimately describes current runtime truth, so the progress-claim and
phase-progress rules need re-deciding for that directory rather than copying.
The line-citation rule transfers unchanged.

Scope: decide which of the five rules apply per directory, extend prdlint's
--dir to take a rule set, sweep, and add the directories to the gate.

Acceptance criteria

task docs:prds covers docs/architecture, ARCHITECTURE.md and CLAUDE.md under a rule set decided for each, and those files carry no line citations.

Close reason

Closed


Imported from beads archie-core-c023 · GitHub #1135 · type task · priority P2 · created 2026-09-21 · closed 2026-10-03

prdlint (tools/prdlint, task docs:prds) governs docs/prds only. The same session-bound writing lives in the other documentation of record, which is read far more often: grep -rE '\.go:[0-9]+' docs/architecture ARCHITECTURE.md CLAUDE.md docs/architecture is authoritative for settled design, so a line citation that has drifted there misleads harder than one in a Draft PRD. Not folded into the sweep because the rules are not identical. An architecture doc legitimately describes current runtime truth, so the progress-claim and phase-progress rules need re-deciding for that directory rather than copying. The line-citation rule transfers unchanged. Scope: decide which of the five rules apply per directory, extend prdlint's --dir to take a rule set, sweep, and add the directories to the gate. ### Acceptance criteria task docs:prds covers docs/architecture, ARCHITECTURE.md and CLAUDE.md under a rule set decided for each, and those files carry no line citations. ### Close reason Closed --- _Imported from beads `archie-core-c023` · GitHub #1135 · type task · priority P2 · created 2026-09-21 · closed 2026-10-03_
sam added the mediumtask labels 2026-10-27 13:39:38 +00:00
sam self-assigned this 2026-10-27 13:39:38 +00:00
sam closed this issue 2026-10-27 13:39:39 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sam/archie#1253