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/ CLI resolution helpers to automatically detect pre-existing canonical design documents in ~/Dropbox/web-jam-llms/<Theme>/ when invoked on an Epic or feature, proposing a Major Revision to the existing document rather than spawning a new standalone file.
- Enhances design document candidate detection in
src/design-issue/gate1.ts and src/design-issue/cli.ts:
- Scans
~/Dropbox/web-jam-llms/<Theme>/ for existing topic design documents (<topic>-design-*.md or <topic>-skill-design-*.md).
- If a matching document exists for the feature/skill, resolves to that existing document and suggests a Major Revision.
- Updates
skills/design-issue/SKILL.md:
- Codifies the Major Revision workflow: records a new entry in
## Revision History, updates architecture, ERD, and decisions in-place, preserving the document as the single source of truth for the feature.
- Adds automated unit test coverage in
test/design_issue_gate1.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
- Running
/design-issue or design:candidates on an Epic whose feature already has a canonical design document automatically resolves to the existing document and prompts for a Major Revision.
- The skill refuses to create redundant parallel design documents for the same feature.
skills/design-issue/SKILL.md documents the automatic feature matching and Major Revision protocol.
- Unit tests in
test/design_issue_gate1.test.ts verify existing document discovery and path resolution.
deno task test, 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/CLI resolution helpers to automatically detect pre-existing canonical design documents in~/Dropbox/web-jam-llms/<Theme>/when invoked on an Epic or feature, proposing a Major Revision to the existing document rather than spawning a new standalone file.src/design-issue/gate1.tsandsrc/design-issue/cli.ts:~/Dropbox/web-jam-llms/<Theme>/for existing topic design documents (<topic>-design-*.mdor<topic>-skill-design-*.md).skills/design-issue/SKILL.md:## Revision History, updates architecture, ERD, and decisions in-place, preserving the document as the single source of truth for the feature.test/design_issue_gate1.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
/design-issueordesign:candidateson an Epic whose feature already has a canonical design document automatically resolves to the existing document and prompts for a Major Revision.skills/design-issue/SKILL.mddocuments the automatic feature matching and Major Revision protocol.test/design_issue_gate1.test.tsverify existing document discovery and path resolution.deno task test,deno task fmt:check,deno task lint, anddeno task sastpass 100% green.