Skip to content

Commit c99ab63

Browse files
committed
feat(v6.3.0): SDD document path unification
- Requirements → storage/specs/ - Design documents → storage/design/ - Task documents → storage/tasks/ - Validation reports → storage/validation/ Updated: - All 7 agent platform templates (Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex CLI, Qwen Code, Windsurf) - musubi-init.js: Create storage/design and storage/tasks directories - Steering files: structure.md, tech.md, product.md (EN/JA) - Documentation: README, CHANGELOG, USER-GUIDE, QUICKSTART, AGENTS.md Tests: - Unit tests: 4,827 passing - Integration tests: 660 passing
1 parent 4b4fe40 commit c99ab63

82 files changed

Lines changed: 627 additions & 309 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.claude/commands/sdd-change-init.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ grep -r "{{related-feature}}" lib/
5757
ls storage/specs/*requirements.md
5858

5959
# Check existing design documents
60-
ls storage/specs/*design.md
60+
ls storage/design/*design.md
6161
```
6262

6363
**Document Current State**:
@@ -334,7 +334,7 @@ Use template from `templates/change-proposal.md`:
334334
### References
335335

336336
- Original requirements: `storage/specs/{{feature}}-requirements.md`
337-
- Current design: `storage/specs/{{feature}}-design.md`
337+
- Current design: `storage/design/{{feature}}-design.md`
338338
- Related issues: #123, #456
339339

340340
### Change History

.claude/commands/sdd-design.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -531,10 +531,10 @@ Document ADRs for:
531531
**IMPORTANT**: Create BOTH English and Japanese versions.
532532

533533
**English version (Primary/Reference)**:
534-
`storage/specs/{{feature-name}}-design.md`
534+
`storage/design/{{feature-name}}-design.md`
535535

536536
**Japanese version (Translation)**:
537-
`storage/specs/{{feature-name}}-design.ja.md`
537+
`storage/design/{{feature-name}}-design.ja.md`
538538

539539
**File Naming**:
540540

@@ -545,10 +545,10 @@ Document ADRs for:
545545

546546
**Examples**:
547547

548-
- `storage/specs/authentication-design.md` (English)
549-
- `storage/specs/authentication-design.ja.md` (Japanese)
550-
- `storage/specs/payment-processing-design.md` (English)
551-
- `storage/specs/payment-processing-design.ja.md` (Japanese)
548+
- `storage/design/authentication-design.md` (English)
549+
- `storage/design/authentication-design.ja.md` (Japanese)
550+
- `storage/design/payment-processing-design.md` (English)
551+
- `storage/design/payment-processing-design.ja.md` (Japanese)
552552

553553
**Generation Order**:
554554

@@ -565,7 +565,7 @@ Document ADRs for:
565565
Run constitutional validation:
566566

567567
```bash
568-
@constitution-enforcer validate storage/specs/{{feature-name}}-design.md
568+
@constitution-enforcer validate storage/design/{{feature-name}}-design.md
569569
```
570570

571571
**Checks**:
@@ -584,7 +584,7 @@ Run constitutional validation:
584584
## ✅ Technical Design Complete
585585

586586
**Feature**: {{FEATURE_NAME}}
587-
**File**: storage/specs/{{feature-name}}-design.md
587+
**File**: storage/design/{{feature-name}}-design.md
588588

589589
### Architecture Summary:
590590

.claude/commands/sdd-implement.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -32,10 +32,10 @@ Implement the feature by executing tasks from the task breakdown document, follo
3232

3333
```bash
3434
# Task Breakdown (English version)
35-
storage/specs/{{feature-name}}-tasks.md
35+
storage/tasks/{{feature-name}}-tasks.md
3636

3737
# Design (English version)
38-
storage/specs/{{feature-name}}-design.md
38+
storage/design/{{feature-name}}-design.md
3939

4040
# Requirements (English version)
4141
storage/specs/{{feature-name}}-requirements.md
@@ -57,7 +57,7 @@ steering/product.md
5757
```markdown
5858
**Error**: Task breakdown not found
5959

60-
Expected: storage/specs/{{feature-name}}-tasks.md
60+
Expected: storage/tasks/{{feature-name}}-tasks.md
6161

6262
Please run `/sdd-tasks {{feature-name}}` first.
6363

@@ -69,7 +69,7 @@ Implementation requires task breakdown.
6969
```markdown
7070
**Error**: Design document not found
7171

72-
Expected: storage/specs/{{feature-name}}-design.md
72+
Expected: storage/design/{{feature-name}}-design.md
7373

7474
Implementation requires design document.
7575
```

.claude/commands/sdd-tasks.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Generate a comprehensive task breakdown that transforms the design into actionab
3030

3131
```bash
3232
# Design and Requirements
33-
storage/specs/{{feature-name}}-design.md
33+
storage/design/{{feature-name}}-design.md
3434
storage/specs/{{feature-name}}-requirements.md
3535

3636
# Steering Context
@@ -48,7 +48,7 @@ steering/product.md
4848
```markdown
4949
**Error**: Design document not found
5050

51-
Expected: storage/specs/{{feature-name}}-design.md
51+
Expected: storage/design/{{feature-name}}-design.md
5252

5353
Please run `/sdd-design {{feature-name}}` first.
5454

@@ -487,10 +487,10 @@ Before marking feature complete, verify:
487487
**IMPORTANT**: Create BOTH English and Japanese versions.
488488
489489
**English version (Primary/Reference)**:
490-
`storage/specs/{{feature-name}}-tasks.md`
490+
`storage/tasks/{{feature-name}}-tasks.md`
491491
492492
**Japanese version (Translation)**:
493-
`storage/specs/{{feature-name}}-tasks.ja.md`
493+
`storage/tasks/{{feature-name}}-tasks.ja.md`
494494
495495
**File Naming**:
496496
- Match requirements and design files
@@ -512,8 +512,8 @@ Before marking feature complete, verify:
512512
513513
**Feature**: {{FEATURE_NAME}}
514514
**Files**:
515-
- English: storage/specs/{{feature-name}}-tasks.md
516-
- Japanese: storage/specs/{{feature-name}}-tasks.ja.md
515+
- English: storage/tasks/{{feature-name}}-tasks.md
516+
- Japanese: storage/tasks/{{feature-name}}-tasks.ja.md
517517
518518
### Summary:
519519
- **Total Tasks**: [N]
@@ -597,7 +597,7 @@ Before completing:
597597
```markdown
598598
**Error**: Design document not found
599599

600-
Expected: storage/specs/{{feature-name}}-design.md
600+
Expected: storage/design/{{feature-name}}-design.md
601601

602602
Please run `/sdd-design {{feature-name}}` first.
603603
```

.claude/commands/sdd-validate.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ Perform comprehensive validation of the feature implementation against:
3737
```bash
3838
# Requirements and Design (English versions)
3939
storage/specs/{{feature-name}}-requirements.md
40-
storage/specs/{{feature-name}}-design.md
41-
storage/specs/{{feature-name}}-tasks.md
40+
storage/design/{{feature-name}}-design.md
41+
storage/tasks/{{feature-name}}-tasks.md
4242

4343
# Steering Context (English versions)
4444
steering/structure.md

.claude/skills/constitution-enforcer/phase-minus-one-gates.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -184,8 +184,8 @@ def validate_traceability_setup(feature_name):
184184
"""
185185
required_artifacts = {
186186
"requirements": f"storage/specs/{feature_name}-requirements.md",
187-
"design": f"storage/specs/{feature_name}-design.md",
188-
"tasks": f"storage/specs/{feature_name}-tasks.md",
187+
"design": f"storage/design/{feature_name}-design.md",
188+
"tasks": f"storage/tasks/{feature_name}-tasks.md",
189189
}
190190

191191
for artifact, path in required_artifacts.items():

.claude/skills/steering/auto-update-rules.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -143,7 +143,7 @@ git diff --name-only --diff-filter=A | grep "requirements\.md"
143143

144144
### memories/architecture_decisions.md
145145

146-
**Trigger**: New ADR created in `storage/specs/*-design.md`
146+
**Trigger**: New ADR created in `storage/design/*-design.md`
147147

148148
**Action**:
149149
```markdown

.claude/skills/traceability-auditor/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -102,8 +102,8 @@ Test Suite (tests/auth/service.test.ts)
102102
### Phase 1: Collect Artifacts
103103

104104
1. Read `storage/specs/[feature]-requirements.md`
105-
2. Read `storage/specs/[feature]-design.md`
106-
3. Read `storage/specs/[feature]-tasks.md`
105+
2. Read `storage/design/[feature]-design.md`
106+
3. Read `storage/tasks/[feature]-tasks.md`
107107
4. Scan source code for implementation
108108
5. Scan test files for test cases
109109

.claude/skills/traceability-auditor/coverage-matrix-template.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -97,8 +97,8 @@ def generate_traceability_matrix(feature_name):
9797
"""Generate traceability matrix for a feature."""
9898

9999
requirements = parse_requirements(f"storage/specs/{feature_name}-requirements.md")
100-
design = parse_design(f"storage/specs/{feature_name}-design.md")
101-
tasks = parse_tasks(f"storage/specs/{feature_name}-tasks.md")
100+
design = parse_design(f"storage/design/{feature_name}-design.md")
101+
tasks = parse_tasks(f"storage/tasks/{feature_name}-tasks.md")
102102
code_files = find_code_files(f"src/{feature_name}/")
103103
test_files = find_test_files(f"tests/{feature_name}/")
104104

.claude/skills/traceability-auditor/gap-detection-rules.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ for ref in all_references:
9090
# find-orphaned-requirements.sh
9191

9292
REQ_FILE="storage/specs/$1-requirements.md"
93-
DESIGN_FILE="storage/specs/$1-design.md"
93+
DESIGN_FILE="storage/design/$1-design.md"
9494

9595
# Extract requirement IDs
9696
grep -oP 'REQ-[\w-]+' "$REQ_FILE" | sort -u > /tmp/reqs.txt

0 commit comments

Comments
 (0)