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:
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
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
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