musubi-sdd 5.1.0 → 5.6.1

package/src/templates/agents/claude-code/skills/test-engineer/test-types.md

@@ -30,21 +30,25 @@ Confidence: ◀── High ───────────────── L
 ## Unit Tests
 
 ### Purpose
+
 Test individual units (functions, methods, classes) in isolation.
 
 ### Characteristics
+
 - Fast execution (milliseconds)
 - Dependencies are mocked
 - Test single behavior per test
 - High code coverage
 
 ### When to Use
+
 - Testing business logic
 - Testing algorithms
 - Testing edge cases
 - Testing error handling
 
 ### Example
+
 ```typescript
 // tests/services/calculator.test.ts
 describe('Calculator', () => {
@@ -53,12 +57,12 @@ describe('Calculator', () => {
       const calc = new Calculator();
       expect(calc.add(2, 3)).toBe(5);
     });
-    
+
     it('should handle negative numbers', () => {
       const calc = new Calculator();
       expect(calc.add(-2, 3)).toBe(1);
     });
-    
+
     it('should return 0 when adding number to its negative', () => {
       const calc = new Calculator();
       expect(calc.add(5, -5)).toBe(0);
@@ -68,6 +72,7 @@ describe('Calculator', () => {
 ```
 
 ### Best Practices
+
 - One assertion per test (when practical)
 - Use descriptive test names
 - Follow AAA pattern (Arrange, Act, Assert)
@@ -78,66 +83,66 @@ describe('Calculator', () => {
 ## Integration Tests
 
 ### Purpose
+
 Test how multiple components work together.
 
 ### Characteristics
+
 - Medium speed (seconds)
 - Uses real or test databases
 - Tests component interactions
 - Validates data flow
 
 ### When to Use
+
 - Testing API endpoints
 - Testing database operations
 - Testing service interactions
 - Testing middleware chains
 
 ### Example
+
 ```typescript
 // tests/integration/auth.test.ts
 describe('Authentication Flow', () => {
   let app: Express;
   let db: TestDatabase;
-  
+
   beforeAll(async () => {
     db = await TestDatabase.connect();
     app = createApp({ database: db });
   });
-  
+
   afterAll(async () => {
     await db.disconnect();
   });
-  
+
   describe('POST /api/auth/login', () => {
     it('should authenticate user and return token', async () => {
       // Arrange
       await db.createUser({
         email: 'test@example.com',
-        password: 'hashed_password'
+        password: 'hashed_password',
       });
-      
+
       // Act
-      const response = await request(app)
-        .post('/api/auth/login')
-        .send({
-          email: 'test@example.com',
-          password: 'password123'
-        });
-      
+      const response = await request(app).post('/api/auth/login').send({
+        email: 'test@example.com',
+        password: 'password123',
+      });
+
       // Assert
       expect(response.status).toBe(200);
       expect(response.body.token).toBeDefined();
       expect(response.body.user.email).toBe('test@example.com');
     });
-    
+
     it('should reject invalid credentials', async () => {
-      const response = await request(app)
-        .post('/api/auth/login')
-        .send({
-          email: 'test@example.com',
-          password: 'wrongpassword'
-        });
-      
+      const response = await request(app).post('/api/auth/login').send({
+        email: 'test@example.com',
+        password: 'wrongpassword',
+      });
+
       expect(response.status).toBe(401);
       expect(response.body.error).toBe('Invalid credentials');
     });
@@ -146,6 +151,7 @@ describe('Authentication Flow', () => {
 ```
 
 ### Best Practices
+
 - Use test database (not production)
 - Clean database between tests
 - Test both success and error paths
@@ -156,51 +162,55 @@ describe('Authentication Flow', () => {
 ## End-to-End (E2E) Tests
 
 ### Purpose
+
 Test complete user journeys through the application.
 
 ### Characteristics
+
 - Slow execution (minutes)
 - Uses real browser/environment
 - Tests full system
 - Highest confidence
 
 ### When to Use
+
 - Critical user journeys
 - Happy path validation
 - Regression testing
 - Pre-release verification
 
 ### Example
+
 ```typescript
 // tests/e2e/checkout.test.ts
 describe('Checkout Flow', () => {
   it('should complete purchase successfully', async () => {
     // Navigate to product
     await page.goto('/products/123');
-    
+
     // Add to cart
     await page.click('[data-testid="add-to-cart"]');
-    
+
     // Go to cart
     await page.click('[data-testid="cart-icon"]');
     expect(await page.textContent('.cart-count')).toBe('1');
-    
+
     // Proceed to checkout
     await page.click('[data-testid="checkout-button"]');
-    
+
     // Fill shipping info
     await page.fill('[name="address"]', '123 Main St');
     await page.fill('[name="city"]', 'New York');
     await page.fill('[name="zip"]', '10001');
-    
+
     // Fill payment info
     await page.fill('[name="cardNumber"]', '4111111111111111');
     await page.fill('[name="expiry"]', '12/25');
     await page.fill('[name="cvv"]', '123');
-    
+
     // Complete order
     await page.click('[data-testid="place-order"]');
-    
+
     // Verify success
     await page.waitForSelector('.order-confirmation');
     expect(await page.textContent('.order-number')).toMatch(/ORD-\d+/);
@@ -209,6 +219,7 @@ describe('Checkout Flow', () => {
 ```
 
 ### Best Practices
+
 - Focus on critical paths
 - Keep tests minimal (expensive to run)
 - Use stable selectors (data-testid)
@@ -219,15 +230,18 @@ describe('Checkout Flow', () => {
 ## Component Tests (Frontend)
 
 ### Purpose
+
 Test React/Vue/Angular components in isolation.
 
 ### Characteristics
+
 - Fast execution
 - Tests rendering and interactions
 - Mocks external services
 - Uses testing library
 
 ### Example
+
 ```typescript
 // tests/components/LoginForm.test.tsx
 import { render, screen, fireEvent } from '@testing-library/react';
@@ -236,16 +250,16 @@ import { LoginForm } from './LoginForm';
 describe('LoginForm', () => {
   it('should render email and password fields', () => {
     render(<LoginForm onSubmit={jest.fn()} />);
-    
+
     expect(screen.getByLabelText('Email')).toBeInTheDocument();
     expect(screen.getByLabelText('Password')).toBeInTheDocument();
     expect(screen.getByRole('button', { name: 'Login' })).toBeInTheDocument();
   });
-  
+
   it('should call onSubmit with form data', async () => {
     const handleSubmit = jest.fn();
     render(<LoginForm onSubmit={handleSubmit} />);
-    
+
     fireEvent.change(screen.getByLabelText('Email'), {
       target: { value: 'test@example.com' }
     });
@@ -253,21 +267,21 @@ describe('LoginForm', () => {
       target: { value: 'password123' }
     });
     fireEvent.click(screen.getByRole('button', { name: 'Login' }));
-    
+
     expect(handleSubmit).toHaveBeenCalledWith({
       email: 'test@example.com',
       password: 'password123'
     });
   });
-  
+
   it('should show validation error for invalid email', async () => {
     render(<LoginForm onSubmit={jest.fn()} />);
-    
+
     fireEvent.change(screen.getByLabelText('Email'), {
       target: { value: 'invalid-email' }
     });
     fireEvent.blur(screen.getByLabelText('Email'));
-    
+
     expect(await screen.findByText('Invalid email format')).toBeInTheDocument();
   });
 });
@@ -278,26 +292,29 @@ describe('LoginForm', () => {
 ## Contract Tests
 
 ### Purpose
+
 Verify API contracts between services.
 
 ### Characteristics
+
 - Tests API schema compliance
 - Uses Pact or similar
 - Consumer-driven contracts
 - Prevents breaking changes
 
 ### Example
+
 ```typescript
 // tests/contracts/user-api.pact.ts
 describe('User API Contract', () => {
   const provider = new Pact({
     consumer: 'WebApp',
-    provider: 'UserService'
+    provider: 'UserService',
   });
-  
+
   beforeAll(() => provider.setup());
   afterAll(() => provider.finalize());
-  
+
   describe('GET /users/:id', () => {
     it('should return user by ID', async () => {
       // Define expected interaction
@@ -306,21 +323,21 @@ describe('User API Contract', () => {
         uponReceiving: 'a request for user 123',
         withRequest: {
           method: 'GET',
-          path: '/users/123'
+          path: '/users/123',
         },
         willRespondWith: {
           status: 200,
           body: {
             id: '123',
             name: like('John Doe'),
-            email: like('john@example.com')
-          }
-        }
+            email: like('john@example.com'),
+          },
+        },
       });
-      
+
       // Execute request
       const response = await userClient.getUser('123');
-      
+
       // Verify
       expect(response.id).toBe('123');
       await provider.verify();
@@ -334,15 +351,18 @@ describe('User API Contract', () => {
 ## Performance Tests
 
 ### Purpose
+
 Verify system performance under load.
 
 ### Characteristics
+
 - Tests response times
 - Tests throughput
 - Tests under stress
 - Identifies bottlenecks
 
 ### Example (k6)
+
 ```javascript
 // tests/performance/api-load.js
 import http from 'k6/http';
@@ -350,26 +370,26 @@ import { check, sleep } from 'k6';
 
 export const options = {
   stages: [
-    { duration: '30s', target: 20 },   // Ramp up
-    { duration: '1m', target: 20 },    // Stay at 20
-    { duration: '30s', target: 50 },   // Ramp up more
-    { duration: '1m', target: 50 },    // Stay at 50
-    { duration: '30s', target: 0 },    // Ramp down
+    { duration: '30s', target: 20 }, // Ramp up
+    { duration: '1m', target: 20 }, // Stay at 20
+    { duration: '30s', target: 50 }, // Ramp up more
+    { duration: '1m', target: 50 }, // Stay at 50
+    { duration: '30s', target: 0 }, // Ramp down
   ],
   thresholds: {
-    http_req_duration: ['p(95)<200'],  // 95% < 200ms
-    http_req_failed: ['rate<0.01'],    // <1% errors
+    http_req_duration: ['p(95)<200'], // 95% < 200ms
+    http_req_failed: ['rate<0.01'], // <1% errors
   },
 };
 
-export default function() {
+export default function () {
   const response = http.get('http://api.example.com/users');
-  
+
   check(response, {
-    'status is 200': (r) => r.status === 200,
-    'response time < 200ms': (r) => r.timings.duration < 200,
+    'status is 200': r => r.status === 200,
+    'response time < 200ms': r => r.timings.duration < 200,
   });
-  
+
   sleep(1);
 }
 ```
@@ -379,6 +399,7 @@ export default function() {
 ## Test Naming Convention
 
 ### Format
+
 ```
 describe('[Subject]', () => {
   describe('[Method/Action]', () => {
@@ -388,16 +409,17 @@ describe('[Subject]', () => {
 ```
 
 ### Examples
+
 ```typescript
 // Good names
-it('should return user when credentials are valid')
-it('should throw InvalidCredentialsError when password is wrong')
-it('should send welcome email when user registers')
+it('should return user when credentials are valid');
+it('should throw InvalidCredentialsError when password is wrong');
+it('should send welcome email when user registers');
 
 // Bad names
-it('test login')
-it('works')
-it('should work correctly')
+it('test login');
+it('works');
+it('should work correctly');
 ```
 
 ---

package/src/templates/agents/claude-code/skills/traceability-auditor/coverage-matrix-template.md

@@ -17,42 +17,45 @@ Template for creating traceability coverage matrices that ensure 100% compliance
 
 ## Forward Traceability (Requirements → Implementation)
 
-| REQ ID | Description | Design Ref | Task ID | Code Files | Test Files | Status |
-|--------|-------------|------------|---------|------------|------------|--------|
-| REQ-001 | User login | AUTH-SVC | P1-001 | auth/login.ts | auth/login.test.ts | ✅ |
-| REQ-002 | Password reset | AUTH-SVC | P1-002 | auth/reset.ts | auth/reset.test.ts | ✅ |
-| REQ-003 | 2FA support | AUTH-SVC | - | - | - | ❌ |
+| REQ ID  | Description    | Design Ref | Task ID | Code Files    | Test Files         | Status |
+| ------- | -------------- | ---------- | ------- | ------------- | ------------------ | ------ |
+| REQ-001 | User login     | AUTH-SVC   | P1-001  | auth/login.ts | auth/login.test.ts | ✅     |
+| REQ-002 | Password reset | AUTH-SVC   | P1-002  | auth/reset.ts | auth/reset.test.ts | ✅     |
+| REQ-003 | 2FA support    | AUTH-SVC   | -       | -             | -                  | ❌     |
 
 ## Backward Traceability (Tests → Requirements)
 
-| Test ID | Test Description | Code File | REQ ID | Status |
-|---------|-----------------|-----------|--------|--------|
-| T-001 | Login success | auth/login.ts | REQ-001 | ✅ |
-| T-002 | Login failure | auth/login.ts | REQ-001 | ✅ |
-| T-003 | Session timeout | auth/session.ts | - | ⚠️ Orphan |
+| Test ID | Test Description | Code File       | REQ ID  | Status    |
+| ------- | ---------------- | --------------- | ------- | --------- |
+| T-001   | Login success    | auth/login.ts   | REQ-001 | ✅        |
+| T-002   | Login failure    | auth/login.ts   | REQ-001 | ✅        |
+| T-003   | Session timeout  | auth/session.ts | -       | ⚠️ Orphan |
 
 ## Coverage Summary
 
-| Metric | Current | Target | Status |
-|--------|---------|--------|--------|
-| Requirements with Design | 100% | 100% | ✅ |
-| Requirements with Code | 67% | 100% | ❌ |
-| Requirements with Tests | 67% | 100% | ❌ |
-| Overall Traceability | 67% | 100% | ❌ |
+| Metric                   | Current | Target | Status |
+| ------------------------ | ------- | ------ | ------ |
+| Requirements with Design | 100%    | 100%   | ✅     |
+| Requirements with Code   | 67%     | 100%   | ❌     |
+| Requirements with Tests  | 67%     | 100%   | ❌     |
+| Overall Traceability     | 67%     | 100%   | ❌     |
 
 ## Gaps Identified
 
 ### Missing Implementations
-| REQ ID | Description | Action Required |
-|--------|-------------|-----------------|
+
+| REQ ID  | Description | Action Required       |
+| ------- | ----------- | --------------------- |
 | REQ-003 | 2FA support | Create design & tasks |
 
 ### Orphaned Tests
-| Test ID | Description | Action Required |
-|---------|-------------|-----------------|
-| T-003 | Session timeout | Add requirement or remove |
+
+| Test ID | Description     | Action Required           |
+| ------- | --------------- | ------------------------- |
+| T-003   | Session timeout | Add requirement or remove |
 
 ## Recommendations
+
 1. Implement REQ-003 or mark as deferred
 2. Create requirement for session timeout test
 ```
@@ -68,12 +71,12 @@ Template for creating traceability coverage matrices that ensure 100% compliance
 
 📊 **Overall: 67%** ❌ (Target: 100%)
 
-| Stage | Coverage | 
-|-------|----------|
-| REQ → Design | ████████░░ 80% |
+| Stage          | Coverage        |
+| -------------- | --------------- |
+| REQ → Design   | ████████░░ 80%  |
 | Design → Tasks | ██████████ 100% |
-| Tasks → Code | ██████░░░░ 60% |
-| Code → Tests | ████████░░ 80% |
+| Tasks → Code   | ██████░░░░ 60%  |
+| Code → Tests   | ████████░░ 80%  |
 
 ## Critical Gaps
 
@@ -95,13 +98,13 @@ Template for creating traceability coverage matrices that ensure 100% compliance
 
 def generate_traceability_matrix(feature_name):
     """Generate traceability matrix for a feature."""
-    
+
     requirements = parse_requirements(f"storage/features/{feature_name}/requirements.md")
     design = parse_design(f"storage/features/{feature_name}/design.md")
     tasks = parse_tasks(f"storage/features/{feature_name}/tasks.md")
     code_files = find_code_files(f"src/{feature_name}/")
     test_files = find_test_files(f"tests/{feature_name}/")
-    
+
     matrix = []
     for req in requirements:
         row = {
@@ -114,7 +117,7 @@ def generate_traceability_matrix(feature_name):
             'status': calculate_status(row)
         }
         matrix.append(row)
-    
+
     return matrix
 ```
 
@@ -122,10 +125,10 @@ def generate_traceability_matrix(feature_name):
 
 ## Status Indicators
 
-| Icon | Meaning |
-|------|---------|
-| ✅ | Fully traced |
-| ⚠️ | Partially traced |
-| ❌ | Not traced |
-| 🔄 | In progress |
-| ⏸️ | Deferred |
+| Icon | Meaning          |
+| ---- | ---------------- |
+| ✅   | Fully traced     |
+| ⚠️   | Partially traced |
+| ❌   | Not traced       |
+| 🔄   | In progress      |
+| ⏸️   | Deferred         |

package/src/templates/agents/claude-code/skills/traceability-auditor/gap-detection-rules.md

@@ -13,10 +13,11 @@ Rules for detecting traceability gaps in MUSUBI SDD projects.
 **Definition**: Requirements with no design, code, or tests.
 
 **Detection Rule**:
+
 ```python
 for req in requirements:
     if req.id not in design.references:
-        report_gap("orphaned_requirement", req.id, 
+        report_gap("orphaned_requirement", req.id,
                    "Requirement not referenced in design")
 ```
 
@@ -27,6 +28,7 @@ for req in requirements:
 **Definition**: Tests with no corresponding requirement.
 
 **Detection Rule**:
+
 ```python
 for test in tests:
     if not has_requirement_reference(test):
@@ -41,6 +43,7 @@ for test in tests:
 **Definition**: Source files with no test coverage.
 
 **Detection Rule**:
+
 ```python
 for src_file in source_files:
     test_file = get_corresponding_test(src_file)
@@ -56,6 +59,7 @@ for src_file in source_files:
 **Definition**: Tasks with no code.
 
 **Detection Rule**:
+
 ```python
 for task in tasks:
     if not exists(task.target_file):
@@ -70,6 +74,7 @@ for task in tasks:
 **Definition**: References to non-existent items.
 
 **Detection Rule**:
+
 ```python
 for ref in all_references:
     if not exists(ref.target):
@@ -112,7 +117,7 @@ done < /tmp/reqs.txt
 for src_file in src/**/*.ts; do
     test_file="${src_file/src\//tests/}"
     test_file="${test_file/.ts/.test.ts}"
-    
+
     if [ ! -f "$test_file" ]; then
         echo "UNTESTED: $src_file"
     fi
@@ -132,27 +137,27 @@ done
 
 ## Summary
 
-| Gap Type | Count | Severity |
-|----------|-------|----------|
-| Orphaned Requirements | 2 | 🔴 Critical |
-| Orphaned Tests | 1 | 🟠 Warning |
-| Untested Code | 3 | 🔴 Critical |
-| Broken References | 0 | - |
+| Gap Type              | Count | Severity    |
+| --------------------- | ----- | ----------- |
+| Orphaned Requirements | 2     | 🔴 Critical |
+| Orphaned Tests        | 1     | 🟠 Warning  |
+| Untested Code         | 3     | 🔴 Critical |
+| Broken References     | 0     | -           |
 
 ## Detailed Gaps
 
 ### Orphaned Requirements
 
-| REQ ID | Description | Recommended Action |
-|--------|-------------|-------------------|
-| REQ-003 | 2FA login | Add to design or defer |
-| REQ-007 | Email notify | Add to design |
+| REQ ID  | Description  | Recommended Action     |
+| ------- | ------------ | ---------------------- |
+| REQ-003 | 2FA login    | Add to design or defer |
+| REQ-007 | Email notify | Add to design          |
 
 ### Untested Code
 
-| File | Functions | Action |
-|------|-----------|--------|
-| src/auth/otp.ts | generateOTP | Create tests |
+| File                | Functions    | Action       |
+| ------------------- | ------------ | ------------ |
+| src/auth/otp.ts     | generateOTP  | Create tests |
 | src/user/profile.ts | updateAvatar | Create tests |
 
 ## Resolution Plan
@@ -178,14 +183,14 @@ class GapDetector:
     def __init__(self, feature_path):
         self.feature_path = feature_path
         self.gaps = []
-    
+
     def detect_all(self):
         self.detect_orphaned_requirements()
         self.detect_orphaned_tests()
         self.detect_untested_code()
         self.detect_broken_references()
         return self.gaps
-    
+
     def get_report(self):
         return {
             "feature": self.feature_path,

package/src/templates/agents/claude-code/skills/ui-ux-designer/SKILL.md

@@ -50,6 +50,7 @@ musubi-browser generate-test --history ./user-flow.json --output tests/e2e/user-
 ```
 
 **UI/UXテストに活用**:
+
 - ワイヤーフレーム → 実装の視覚的比較
 - ユーザーフロー操作の自動化
 - レスポンシブデザインの確認（複数画面サイズ）