Child of web-jam-tools#737 #737 ("design-issue skill enhancements and fixes").
What this builds
Updates skills/design-issue/SKILL.md and src/design-issue/lint_doc.ts to support and enforce a structured ## Revision History table when design documents are resumed and updated for major milestone iterations and epics.
- Updates
skills/design-issue/SKILL.md to define the standing rule for ## Revision History:
- When an existing design document undergoes a major update or new Phase Epic, it carries a structured markdown table with columns:
| Date | Phase / Milestone | Epic Link | Summary of Key Additions & Enhancements |.
- Distinguishes structured revision history tables from forbidden unstructured historical narrative prose ("an earlier version said", "what changed", "why this was withdrawn").
- Updates
src/design-issue/lint_doc.ts:
- Adjusts
revisionNarrationRegexes so that the literal heading ## Revision History and compliant markdown table rows are permitted.
- Validates that if a
## Revision History section is present, it adheres to the required table schema and non-empty summary cells.
- Adds automated unit test coverage in
test/design_issue_lint_doc.test.ts.
Design reference
~/Dropbox/web-jam-llms/Token_Savings/design-issue-enhancements-design-2026-08-23.md
STOP and say so if this path cannot be read. Do not reconstruct the requirements from this issue body, from comments, or from guesswork.
Acceptance criteria
skills/design-issue/SKILL.md documents the ## Revision History table schema and multi-phase resume requirements.
deno task design:lint-doc passes cleanly on design documents carrying a compliant ## Revision History table.
deno task design:lint-doc continues to fail design documents carrying forbidden unstructured narrative phrases.
- All unit tests in
test/design_issue_lint_doc.test.ts pass 100% green.
deno task fmt:check, deno task lint, and deno task sast pass 100% green.
Child of web-jam-tools#737 #737 ("design-issue skill enhancements and fixes").
What this builds
Updates
skills/design-issue/SKILL.mdandsrc/design-issue/lint_doc.tsto support and enforce a structured## Revision Historytable when design documents are resumed and updated for major milestone iterations and epics.skills/design-issue/SKILL.mdto define the standing rule for## Revision History:| Date | Phase / Milestone | Epic Link | Summary of Key Additions & Enhancements |.src/design-issue/lint_doc.ts:revisionNarrationRegexesso that the literal heading## Revision Historyand compliant markdown table rows are permitted.## Revision Historysection is present, it adheres to the required table schema and non-empty summary cells.test/design_issue_lint_doc.test.ts.Design reference
~/Dropbox/web-jam-llms/Token_Savings/design-issue-enhancements-design-2026-08-23.mdSTOP and say so if this path cannot be read. Do not reconstruct the requirements from this issue body, from comments, or from guesswork.
Acceptance criteria
skills/design-issue/SKILL.mddocuments the## Revision Historytable schema and multi-phase resume requirements.deno task design:lint-docpasses cleanly on design documents carrying a compliant## Revision Historytable.deno task design:lint-doccontinues to fail design documents carrying forbidden unstructured narrative phrases.test/design_issue_lint_doc.test.tspass 100% green.deno task fmt:check,deno task lint, anddeno task sastpass 100% green.