musubi-sdd 5.1.0 → 5.6.1

package/src/templates/architectures/hexagonal/README.md

@@ -0,0 +1,130 @@
+# Hexagonal Architecture Template
+
+## Overview
+
+Hexagonal Architecture (Ports & Adapters) focuses on isolating the application core from external concerns.
+
+## Directory Structure
+
+```
+src/
+├── core/                   # Application Core (Hexagon)
+│   ├── domain/             # Domain model
+│   │   ├── models/         # Entities and aggregates
+│   │   ├── events/         # Domain events
+│   │   └── services/       # Domain services
+│   │
+│   ├── ports/              # Ports (interfaces)
+│   │   ├── inbound/        # Driving ports (use cases)
+│   │   │   ├── UserService.ts
+│   │   │   └── OrderService.ts
+│   │   └── outbound/       # Driven ports (repositories, external)
+│   │       ├── UserRepository.ts
+│   │       └── PaymentGateway.ts
+│   │
+│   └── application/        # Application logic
+│       ├── commands/       # Command handlers
+│       ├── queries/        # Query handlers
+│       └── services/       # Application services
+│
+└── adapters/               # Adapters (outside the hexagon)
+    ├── inbound/            # Driving adapters
+    │   ├── http/           # REST API
+    │   ├── grpc/           # gRPC services
+    │   ├── graphql/        # GraphQL resolvers
+    │   └── cli/            # CLI interface
+    │
+    └── outbound/           # Driven adapters
+        ├── persistence/    # Database implementations
+        ├── messaging/      # Message queue clients
+        ├── http-clients/   # External API clients
+        └── cache/          # Cache implementations
+```
+
+## Port Types
+
+### Inbound Ports (Driving)
+
+Define what the application CAN DO:
+
+```typescript
+// ports/inbound/UserService.ts
+interface UserService {
+  createUser(command: CreateUserCommand): Promise<User>;
+  getUser(id: UserId): Promise<User | null>;
+  updateUser(command: UpdateUserCommand): Promise<User>;
+}
+```
+
+### Outbound Ports (Driven)
+
+Define what the application NEEDS:
+
+```typescript
+// ports/outbound/UserRepository.ts
+interface UserRepository {
+  save(user: User): Promise<void>;
+  findById(id: UserId): Promise<User | null>;
+  findByEmail(email: Email): Promise<User | null>;
+}
+```
+
+## Adapter Types
+
+### Inbound Adapters (Driving)
+
+Translate external input to port calls:
+
+```typescript
+// adapters/inbound/http/UserController.ts
+class UserController {
+  constructor(private userService: UserService) {}
+
+  async create(req: Request): Promise<Response> {
+    const user = await this.userService.createUser(req.body);
+    return Response.created(user);
+  }
+}
+```
+
+### Outbound Adapters (Driven)
+
+Implement ports with external systems:
+
+```typescript
+// adapters/outbound/persistence/PostgresUserRepository.ts
+class PostgresUserRepository implements UserRepository {
+  async save(user: User): Promise<void> {
+    await this.db.query('INSERT INTO users ...');
+  }
+}
+```
+
+## Key Principles
+
+1. **Core Independence**: The core knows nothing about adapters
+2. **Ports as Contracts**: Ports define the API between core and outside
+3. **Swappable Adapters**: Any adapter can be replaced without changing the core
+4. **Testability**: Core can be tested with mock adapters
+
+## Dependency Injection
+
+```typescript
+// Composition root
+const userRepository = new PostgresUserRepository(db);
+const userService = new UserServiceImpl(userRepository);
+const userController = new UserController(userService);
+```
+
+## Testing Strategy
+
+| Component   | Test Type   | Approach                 |
+| ----------- | ----------- | ------------------------ |
+| Domain      | Unit        | Pure functions, no mocks |
+| Ports       | Contract    | Interface compliance     |
+| Application | Unit        | Mock outbound ports      |
+| Adapters    | Integration | Real external systems    |
+
+---
+
+_Hexagonal Architecture Template - MUSUBI SDD_

package/src/templates/index.js

@@ -5,7 +5,12 @@
 
 'use strict';
 
-const { LocaleManager, SUPPORTED_LOCALES, LOCALE_NAMES, TEMPLATE_CATEGORIES } = require('./locale-manager');
+const {
+  LocaleManager,
+  SUPPORTED_LOCALES,
+  LOCALE_NAMES,
+  TEMPLATE_CATEGORIES,
+} = require('./locale-manager');
 
 module.exports = {
   LocaleManager,

package/src/templates/locale-manager.js

@@ -80,7 +80,7 @@ class LocaleManager {
    */
   async getTemplate(category, locale = this.defaultLocale) {
     const baseName = TEMPLATE_CATEGORIES[category] || category;
-    
+
     // Try exact locale match first
     let templatePath = this.getTemplatePath(baseName, locale);
     if (await fs.pathExists(templatePath)) {
@@ -123,19 +123,19 @@ class LocaleManager {
    */
   async listTemplates() {
     const result = {};
-    
-    if (!await fs.pathExists(this.templatesPath)) {
+
+    if (!(await fs.pathExists(this.templatesPath))) {
       return result;
     }
 
     const files = await fs.readdir(this.templatesPath);
-    
+
     for (const file of files) {
       if (!file.endsWith('.md')) continue;
-      
+
       const { category, locale } = this.parseTemplateFilename(file);
       if (!category) continue;
-      
+
       if (!result[category]) {
         result[category] = [];
       }
@@ -154,7 +154,7 @@ class LocaleManager {
    */
   parseTemplateFilename(filename) {
     const baseName = filename.replace('.md', '');
-    
+
     // Check for locale suffix
     for (const locale of SUPPORTED_LOCALES) {
       if (baseName.endsWith(`.${locale}`)) {
@@ -164,7 +164,7 @@ class LocaleManager {
         };
       }
     }
-    
+
     // No locale suffix means English
     return {
       category: baseName,
@@ -182,10 +182,10 @@ class LocaleManager {
   async createLocalizedTemplate(category, locale, content) {
     const baseName = TEMPLATE_CATEGORIES[category] || category;
     const templatePath = this.getTemplatePath(baseName, locale);
-    
+
     await fs.ensureDir(path.dirname(templatePath));
     await fs.writeFile(templatePath, content, 'utf-8');
-    
+
     return templatePath;
   }
 
@@ -199,19 +199,19 @@ class LocaleManager {
     // Extract translatable sections
     const sections = [];
     const lines = content.split('\n');
-    
+
     let inCodeBlock = false;
-    
+
     for (let i = 0; i < lines.length; i++) {
       const line = lines[i];
-      
+
       if (line.startsWith('```')) {
         inCodeBlock = !inCodeBlock;
         continue;
       }
-      
+
       if (inCodeBlock) continue;
-      
+
       // Headers
       if (line.startsWith('#')) {
         sections.push({
@@ -221,7 +221,7 @@ class LocaleManager {
           translate: true,
         });
       }
-      
+
       // Paragraphs (non-empty, non-special lines)
       if (line.trim() && !line.startsWith('-') && !line.startsWith('*') && !line.startsWith('|')) {
         sections.push({

package/src/templates/shared/delta-spec-template.md

@@ -10,12 +10,12 @@ Use this template for brownfield project change tracking.
 
 ### Delta Types
 
-| Type | Usage | Example |
-|------|-------|---------|
-| `ADDED` | New requirement/component | `[ADDED] REQ-AUTH-005: OAuth2 support` |
+| Type       | Usage                         | Example                                            |
+| ---------- | ----------------------------- | -------------------------------------------------- |
+| `ADDED`    | New requirement/component     | `[ADDED] REQ-AUTH-005: OAuth2 support`             |
 | `MODIFIED` | Changed requirement/component | `[MODIFIED] REQ-AUTH-001: Updated password policy` |
-| `REMOVED` | Deleted requirement/component | `[REMOVED] REQ-LEGACY-001: Deprecated feature` |
-| `RENAMED` | Renamed identifier | `[RENAMED] UserService → AuthenticationService` |
+| `REMOVED`  | Deleted requirement/component | `[REMOVED] REQ-LEGACY-001: Deprecated feature`     |
+| `RENAMED`  | Renamed identifier            | `[RENAMED] UserService → AuthenticationService`    |
 
 ---
 
@@ -43,15 +43,18 @@ Use this template for brownfield project change tracking.
 - {api | database | ui | backend | frontend | security | performance | testing | documentation | infrastructure | configuration}
 
 ## Before State (for MODIFIED/RENAMED/REMOVED)
-
 ```
+
 {Previous specification, code, or configuration}
+
 ```
 
 ## After State (for ADDED/MODIFIED/RENAMED)
 
 ```
+
 {New specification, code, or configuration}
+
 ```
 
 ## Acceptance Criteria
@@ -85,7 +88,7 @@ Use this template for brownfield project change tracking.
 
 ### ADDED Example
 
-```markdown
+````markdown
 # Delta Specification: DELTA-AUTH-001
 
 **Type**: ADDED
@@ -120,6 +123,7 @@ interface OAuthConfig {
 
 function authenticateOAuth(config: OAuthConfig): Promise<Session>;
 ```
+````
 
 ## Acceptance Criteria
 
@@ -127,7 +131,8 @@ function authenticateOAuth(config: OAuthConfig): Promise<Session>;
 - [ ] Session created with correct user data
 - [ ] Existing email accounts are linked
 - [ ] Failed auth shows appropriate error
-```
+
+````
 
 ### MODIFIED Example
 
@@ -158,7 +163,7 @@ Security audit (SEC-2025-042) identified weak password policy as high risk.
 
 ```typescript
 const PASSWORD_MIN_LENGTH = 8;
-```
+````
 
 ## After State
 
@@ -172,7 +177,8 @@ const PASSWORD_MIN_LENGTH = 12;
 - [ ] Existing passwords remain valid
 - [ ] UI displays updated requirements
 - [ ] Tests updated for new policy
-```
+
+````
 
 ### REMOVED Example
 
@@ -204,7 +210,7 @@ Feature unused (0 invocations in 6 months). Maintenance burden not justified.
 ```typescript
 // Deprecated since v2.0.0
 function exportToXML(data: Record[]): string;
-```
+````
 
 ## Acceptance Criteria
 
@@ -212,7 +218,8 @@ function exportToXML(data: Record[]): string;
 - [ ] Code and tests removed
 - [ ] Documentation updated
 - [ ] Changelog documents breaking change
-```
+
+````
 
 ---
 
@@ -230,7 +237,7 @@ musubi-change show DELTA-AUTH-001
 
 # Analyze impact
 musubi-change impact DELTA-AUTH-001
-```
+````
 
 ---
 

package/src/templates/shared/github-actions/musubi-issue-resolver.yml

@@ -55,7 +55,7 @@ jobs:
         run: |
           musubi-resolve analyze ${{ steps.issue.outputs.number }} \
             --output json > analysis.json
-          
+
           echo "result<<EOF" >> $GITHUB_OUTPUT
           cat analysis.json >> $GITHUB_OUTPUT
           echo "EOF" >> $GITHUB_OUTPUT
@@ -65,11 +65,11 @@ jobs:
         with:
           script: |
             const analysis = ${{ steps.analyze.outputs.result }};
-            
+
             let comment = `## 🤖 MUSUBI Issue Analysis\n\n`;
             comment += `**Type**: ${analysis.issueType}\n`;
             comment += `**Status**: ${analysis.status}\n\n`;
-            
+
             if (analysis.requirements && analysis.requirements.length > 0) {
               comment += `### Extracted Requirements\n\n`;
               analysis.requirements.forEach((req, i) => {
@@ -77,12 +77,12 @@ jobs:
               });
               comment += '\n';
             }
-            
+
             comment += `### Next Steps\n\n`;
             comment += `- Add label \`musubi-implement\` to create a branch and PR\n`;
             comment += `- Or comment \`/musubi implement\` to proceed\n\n`;
             comment += `---\n_Analyzed by MUSUBI Issue Resolver_`;
-            
+
             await github.rest.issues.createComment({
               owner: context.repo.owner,
               repo: context.repo.repo,

package/src/templates/shared/github-actions/musubi-security-check.yml

@@ -39,17 +39,17 @@ jobs:
           else
             FILES=$(git diff --name-only HEAD~1 HEAD | grep -E '\.(js|ts|py|json|yml|yaml)$' || true)
           fi
-          
+
           if [ -z "$FILES" ]; then
             echo "No relevant files changed"
             echo "risks=[]" >> $GITHUB_OUTPUT
             echo "blocked=false" >> $GITHUB_OUTPUT
             exit 0
           fi
-          
+
           # セキュリティ分析実行
           echo "$FILES" | xargs musubi-analyze security --format json > security-report.json 2>/dev/null || true
-          
+
           if [ -f security-report.json ]; then
             CRITICAL=$(jq '[.risks[] | select(.severity == "critical")] | length' security-report.json 2>/dev/null || echo "0")
             HIGH=$(jq '[.risks[] | select(.severity == "high")] | length' security-report.json 2>/dev/null || echo "0")

package/src/templates/shared/github-actions/musubi-validate.yml

@@ -37,7 +37,7 @@ jobs:
         run: |
           # Run constitutional validation with scoring
           npx musubi-validate score > validation-report.json 2>&1 || true
-          
+
           if [ -f validation-report.json ]; then
             SCORE=$(jq '.score // 0' validation-report.json 2>/dev/null || echo "0")
             PASS=$(jq '.pass // false' validation-report.json 2>/dev/null || echo "false")
@@ -53,7 +53,7 @@ jobs:
         id: trace
         run: |
           npx musubi-trace --verify > trace-report.json 2>&1 || true
-          
+
           if [ -f trace-report.json ]; then
             COVERAGE=$(jq '.coverage // 100' trace-report.json 2>/dev/null || echo "100")
             ORPHANS=$(jq '.orphanCount // 0' trace-report.json 2>/dev/null || echo "0")
@@ -74,11 +74,11 @@ jobs:
             const pass = '${{ steps.validate.outputs.pass }}';
             const coverage = '${{ steps.trace.outputs.coverage }}';
             const orphans = '${{ steps.trace.outputs.orphans }}';
-            
+
             const emoji = pass === 'true' ? '✅' : '⚠️';
             const scoreNum = parseFloat(score) || 0;
             const scoreBar = '█'.repeat(Math.floor(scoreNum / 10)) + '░'.repeat(10 - Math.floor(scoreNum / 10));
-            
+
             await github.rest.issues.createComment({
               owner: context.repo.owner,
               repo: context.repo.repo,

package/src/templates/shared/steering/structure.md

@@ -15,6 +15,101 @@
 
 ---
 
+## Architecture Layers (Language-Agnostic)
+
+The following layer definitions apply regardless of programming language:
+
+### Layer 1: Domain / Core
+
+**Purpose**: Business logic and domain models
+**Rules**:
+
+- MUST NOT depend on any other layer
+- Contains: Entities, Value Objects, Domain Services, Domain Events
+- No framework dependencies, no I/O
+
+**Language Examples**:
+| Language | Location | Pattern |
+|----------|----------|---------|
+| TypeScript | `lib/{feature}/domain/` | Classes/Types |
+| Rust | `{crate}/src/domain/` | Structs + Traits |
+| Python | `src/{pkg}/domain/` | Dataclasses |
+| Go | `internal/domain/` | Structs + Interfaces |
+| Java | `src/main/.../domain/` | Classes + Records |
+
+### Layer 2: Application / Use Cases
+
+**Purpose**: Orchestrate domain logic, implement use cases
+**Rules**:
+
+- Depends only on Domain layer
+- Contains: Application Services, Commands, Queries, DTOs
+- No direct I/O (uses ports/interfaces)
+
+**Language Examples**:
+| Language | Location | Pattern |
+|----------|----------|---------|
+| TypeScript | `lib/{feature}/application/` | Service classes |
+| Rust | `{crate}/src/application/` | Impl blocks |
+| Python | `src/{pkg}/application/` | Service functions |
+| Go | `internal/app/` | Service structs |
+| Java | `src/main/.../application/` | @Service classes |
+
+### Layer 3: Infrastructure / Adapters
+
+**Purpose**: External integrations (DB, APIs, messaging)
+**Rules**:
+
+- Depends on Application layer (implements ports)
+- Contains: Repositories, API Clients, Message Publishers
+- All I/O operations here
+
+**Language Examples**:
+| Language | Location | Pattern |
+|----------|----------|---------|
+| TypeScript | `lib/{feature}/infrastructure/` | Repository impls |
+| Rust | `{crate}/src/infrastructure/` | Trait impls |
+| Python | `src/{pkg}/infrastructure/` | Repository classes |
+| Go | `internal/infra/` | Interface impls |
+| Java | `src/main/.../infrastructure/` | @Repository classes |
+
+### Layer 4: Interface / Presentation
+
+**Purpose**: Entry points (CLI, API, Web UI)
+**Rules**:
+
+- Depends on Application layer
+- Contains: Controllers, CLI handlers, API routes
+- Input validation and response formatting
+
+**Language Examples**:
+| Language | Location | Pattern |
+|----------|----------|---------|
+| TypeScript | `app/api/` or `cli/` | Route handlers |
+| Rust | `{crate}/src/api/` or `cli/` | Axum handlers |
+| Python | `src/{pkg}/api/` or `cli/` | FastAPI routes |
+| Go | `cmd/` or `internal/api/` | HTTP handlers |
+| Java | `src/main/.../api/` | @RestController |
+
+### Layer Dependency Rules
+
+```
+┌─────────────────────────────────────────┐
+│        Interface / Presentation         │ ← Entry points
+├─────────────────────────────────────────┤
+│        Application / Use Cases          │ ← Orchestration
+├─────────────────────────────────────────┤
+│        Infrastructure / Adapters        │ ← I/O & External
+├─────────────────────────────────────────┤
+│            Domain / Core                │ ← Pure business logic
+└─────────────────────────────────────────┘
+
+Dependency Direction: ↓ (outer → inner)
+Domain layer has NO dependencies
+```
+
+---
+
 ## Directory Organization
 
 ### Root Structure

package/src/templates/skills/browser-agent.md

@@ -55,55 +55,61 @@ npx musubi browser generate-test --history actions.json --output tests/e2e/login
 ## サポートするコマンド
 
 ### ナビゲーション
+
 - `https://example.com を開く`
 - `go to https://example.com`
 - `ログインページにアクセス`
 
 ### クリック
+
 - `ログインボタンをクリック`
 - `click login button`
 - `送信ボタンを押す`
 
 ### 入力
+
 - `メール欄に「test@example.com」と入力`
 - `type "hello" in email field`
 - `パスワードに "secret" を入力`
 
 ### 待機
+
 - `3秒待つ`
 - `wait 5 seconds`
 - `ローディングが消えるまで待つ`
 
 ### スクリーンショット
+
 - `スクリーンショットを取る`
 - `画面を「login-page」として保存`
 - `take screenshot`
 
 ### 検証
+
 - `「ログイン成功」が表示される`
 - `verify "Welcome" is visible`
 - `ダッシュボードが表示されること`
 
 ## セッションコマンド（インタラクティブモード）
 
-| コマンド | 説明 |
-|---------|------|
-| `history` | アクション履歴を表示 |
-| `clear` | 履歴をクリア |
-| `save-test <file>` | 履歴から Playwright テストを保存 |
-| `exit` / `quit` / `q` | ブラウザを閉じて終了 |
-| `help` / `?` | ヘルプを表示 |
+| コマンド              | 説明                             |
+| --------------------- | -------------------------------- |
+| `history`             | アクション履歴を表示             |
+| `clear`               | 履歴をクリア                     |
+| `save-test <file>`    | 履歴から Playwright テストを保存 |
+| `exit` / `quit` / `q` | ブラウザを閉じて終了             |
+| `help` / `?`          | ヘルプを表示                     |
 
 ## オプション
 
-| オプション | 説明 | デフォルト |
-|-----------|------|-----------|
-| `--headless` | ヘッドレスモードで実行 | `true` |
-| `--no-headless` | ブラウザを表示 | - |
-| `-b, --browser` | ブラウザ種類 | `chromium` |
-| `-o, --output` | スクリーンショット保存先 | `./screenshots` |
-| `-t, --timeout` | タイムアウト（ms） | `30000` |
-| `--threshold` | 類似度閾値 | `0.95` |
+| オプション      | 説明                     | デフォルト      |
+| --------------- | ------------------------ | --------------- |
+| `--headless`    | ヘッドレスモードで実行   | `true`          |
+| `--no-headless` | ブラウザを表示           | -               |
+| `-b, --browser` | ブラウザ種類             | `chromium`      |
+| `-o, --output`  | スクリーンショット保存先 | `./screenshots` |
+| `-t, --timeout` | タイムアウト（ms）       | `30000`         |
+| `--threshold`   | 類似度閾値               | `0.95`          |
 
 ## MUSUBI 仕様連携
 
@@ -125,7 +131,6 @@ test('REQ-001: User Login', async ({ page }) => {
   // Pattern: event-driven
   // Trigger: the user clicks the login button with valid credentials
   // Action: display the dashboard page
-  
   // TODO: Implement test based on requirement
 });
 ```

package/src/templates/skills/web-gui.md

@@ -13,6 +13,7 @@ MUSUBI Web GUI provides a visual dashboard for Specification Driven Development
 ## Overview
 
 The Web GUI Dashboard provides:
+
 - **Real-time Project Monitoring**: Live updates via WebSocket
 - **Workflow Visualization**: Visual SDD stage tracking
 - **Traceability Matrix**: Requirements-to-implementation mapping
@@ -28,6 +29,7 @@ musubi-gui start
 ```
 
 Options:
+
 - `-p, --port <port>` - Server port (default: 3000)
 - `-d, --dir <directory>` - Project directory (default: current)
 - `--no-open` - Don't open browser automatically
@@ -113,10 +115,13 @@ src/gui/
 ## Dashboard Views
 
 ### Dashboard
+
 Overview of project status, statistics, and recent specifications.
 
 ### Workflow
+
 Visual representation of SDD workflow stages:
+
 1. Steering
 2. Requirements
 3. Design
@@ -127,12 +132,15 @@ Visual representation of SDD workflow stages:
 8. Completion
 
 ### Requirements
+
 List of all requirements with EARS pattern detection.
 
 ### Traceability
+
 Matrix showing links between requirements, designs, tasks, and implementations.
 
 ### Constitution
+
 Display of constitutional articles governing the project.
 
 ## Integration