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
scripts/generate-requirements.py is still the only known generator for docs/requirements.md, but it is not wired into build.w or current runbooks and remains a post-seed Python dependency in the Makefile-elimination audit.
Triage findings
rg finds no build target or runbook invoking scripts/generate-requirements.py; it is a manual maintenance tool.
docs/requirements.md still describes itself as a generated traceability matrix derived from docs/with-specification.md.
Regenerate docs/requirements.md against spec v7.0 #386 is closed, but running python3 scripts/generate-requirements.py --preserve-from-head on current main is not a no-op: it changes docs/requirements.md by thousands of lines and changes the generated count from 3074 normative requirements to 3092. The diff includes source line shifts and title truncation changes, so this is not safe to treat as obsolete without an explicit replacement/retirement decision.
Desired outcome
Either:
Port the generator to a With-owned docs-generation target, for example with build :requirements-generate plus a check target that verifies docs/requirements.md is current without writing it; or
Decide the requirements matrix is no longer generated/live, delete the Python script, and update docs/requirements.md to state its actual maintenance policy.
Acceptance criteria
No normal post-seed workflow depends on Python for requirements generation.
If the requirements matrix remains generated, the generator is implemented in With and has a build target.
Existing triage checkboxes, impl: #N, and tests: #N annotations are preserved when regenerating.
Section 30 remains informative-only; with build :requirements-informative-check continues to pass.
docs/eliminate-Makefile.md no longer lists scripts/generate-requirements.py as an unresolved post-seed blocker after the replacement or retirement lands.
Summary
scripts/generate-requirements.pyis still the only known generator fordocs/requirements.md, but it is not wired intobuild.wor current runbooks and remains a post-seed Python dependency in the Makefile-elimination audit.Triage findings
rgfinds no build target or runbook invokingscripts/generate-requirements.py; it is a manual maintenance tool.docs/requirements.mdstill describes itself as a generated traceability matrix derived fromdocs/with-specification.md.python3 scripts/generate-requirements.py --preserve-from-headon currentmainis not a no-op: it changesdocs/requirements.mdby thousands of lines and changes the generated count from 3074 normative requirements to 3092. The diff includes source line shifts and title truncation changes, so this is not safe to treat as obsolete without an explicit replacement/retirement decision.Desired outcome
Either:
with build :requirements-generateplus a check target that verifiesdocs/requirements.mdis current without writing it; ordocs/requirements.mdto state its actual maintenance policy.Acceptance criteria
impl: #N, andtests: #Nannotations are preserved when regenerating.with build :requirements-informative-checkcontinues to pass.docs/eliminate-Makefile.mdno longer listsscripts/generate-requirements.pyas an unresolved post-seed blocker after the replacement or retirement lands.