You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs/design/DESIGN_REQUIREMENTS.md uses [done]/[partial]/[dropped] status flags per FR section. The doc-keeper sweep reconciles these flags against the actual code state.
Problem
The cross-cutting audit (docs/audits/cross-cutting.md F27) quantified the drift between flags and filed issues. Six FR sections marked [done] have multiple filed P0/P1 issues contradicting the flag:
#323 (cap 500 not 10K), #324 (error not recorded), #325 (no execute immediately), #326 (no filter), #327 (no remove UI), #328 (unknown connection on failure), #329 (multi-statement records single entry), #330 (raw SQL persisted), #331 (sync localStorage write), #332 (no dup validation), #333 (rename onBlur race), #334 (no hierarchical folders), #335 (no import/export), #336 (focus traps), #337 (no delete confirm), #338 (+New invisible), #339 (no scrubbing), #340 (god-component), #341 (no isDirty check), #342 (no Save as Favorite button)
That's 56+ filed issues contradicting the [done] flags. A doc PR is needed to flip each [done] → [partial] and cite the issue numbers.
The cross-cutting audit (docs/audits/cross-cutting.md F27) flagged this as P3 (convention/test/doc-drift). It's a single meta-issue that reconciles all status flags at once per the audit README.
After this PR, only FRs with ≥ 90% of acceptance criteria implemented keep the [done] flag. Sections with multiple unresolved P0/P1 issues show [partial] and cite the issue numbers in a small header note.
Proposed fix
Scope S. One PR that:
Updates each [done] → [partial] for FR-1, FR-2, FR-3, FR-4, FR-6, FR-9.
Adds a one-line header note citing the count of filed issues per section.
grep -nE "^### FR-.*\[done\]" docs/design/DESIGN_REQUIREMENTS.md returns 0 hits (or only FRs with ≥ 90% of acceptance criteria implemented). Each remaining flag has a brief comment citing the issue tracker.
Context
docs/design/DESIGN_REQUIREMENTS.mduses[done]/[partial]/[dropped]status flags per FR section. The doc-keeper sweep reconciles these flags against the actual code state.Problem
The cross-cutting audit (docs/audits/cross-cutting.md F27) quantified the drift between flags and filed issues. Six FR sections marked
[done]have multiple filed P0/P1 issues contradicting the flag:[done][done][done][done][done][done]That's 56+ filed issues contradicting the
[done]flags. A doc PR is needed to flip each[done]→[partial]and cite the issue numbers.The cross-cutting audit (docs/audits/cross-cutting.md F27) flagged this as P3 (convention/test/doc-drift). It's a single meta-issue that reconciles all status flags at once per the audit README.
Files
Repro
Expected
After this PR, only FRs with ≥ 90% of acceptance criteria implemented keep the
[done]flag. Sections with multiple unresolved P0/P1 issues show[partial]and cite the issue numbers in a small header note.Proposed fix
Scope S. One PR that:
[done]→[partial]for FR-1, FR-2, FR-3, FR-4, FR-6, FR-9.[partial]) header to cite the new audit: table designer #376/audit: routine viewer #390/audit: EXPLAIN visualizer #411 siblings.[dropped]on FR-10 unchanged.Acceptance
grep -nE "^### FR-.*\[done\]" docs/design/DESIGN_REQUIREMENTS.mdreturns 0 hits (or only FRs with ≥ 90% of acceptance criteria implemented). Each remaining flag has a brief comment citing the issue tracker.Needs human verify
Yes (doc change).
Labels: audit, area/cross-cutting, severity/p3, kind/doc-drift