musubix 3.6.1 → 3.7.3

package/.github/skills/musubix-c4-design/SKILL.md

@@ -1,162 +1,86 @@
 ---
 name: musubix-c4-design
-description: Guide for creating C4 model design documents. Use this when asked to create architecture designs, system context diagrams, container diagrams, or component diagrams following the C4 model methodology.
+description: C4モデル設計ドキュメント作成ガイド。アーキテクチャ図・コンポーネント設計に使用。
 license: MIT
 ---
 
-# MUSUBIX C4 Design Skill
+# C4 Design Skill
 
-This skill guides you through creating C4 model architecture designs for MUSUBIX projects.
+C4モデル4レベルでアーキテクチャを構造化。
 
-## Overview
+## C4 Levels
 
-The C4 model provides four levels of abstraction for describing software architecture:
+| Level | 名称 | 内容 |
+|-------|------|------|
+| **1** | Context | システム境界・外部アクター |
+| **2** | Container | 技術選択・デプロイ単位 |
+| **3** | Component | コンテナ内部構造 |
+| **4** | Code | 実装詳細（任意） |
 
-1. **Context** - System boundaries and external actors
-2. **Container** - Technology choices and deployable units
-3. **Component** - Internal structure of containers
-4. **Code** - Implementation details (optional)
+## WHEN → DO
 
-## Prerequisites
+| WHEN | DO |
+|------|-----|
+| 設計開始前 | `storage/specs/`のREQ-*を確認 |
+| 新規システム設計 | Context→Container→Componentの順で作成 |
+| コンポーネント追加 | Component Levelを更新 |
 
-Before creating designs:
-
-1. Read requirements from `storage/specs/` (REQ-* files)
-2. Check `steering/structure.ja.md` for architecture guidelines
-3. Review `steering/tech.ja.md` for technology constraints
-
-## Design Document Template
+## Design Template
 
 ```markdown
-# DES-[CATEGORY]-[NUMBER]: [Design Title]
+# DES-[CATEGORY]-[NUMBER]: [Title]
 
 ## メタデータ
-- **作成日**: YYYY-MM-DD
-- **トレーサビリティ**: REQ-XXX-NNN
+- 作成日: YYYY-MM-DD
+- トレーサビリティ: REQ-XXX-NNN
 
 ## 1. Context Level
-
-### システムコンテキスト図
-[External actors and systems that interact with our system]
-
-### 外部アクター
 | アクター | 説明 | インタラクション |
 |---------|------|-----------------|
-| User | システム利用者 | Web UI経由でアクセス |
+| User | システム利用者 | Web UI経由 |
 
 ## 2. Container Level
-
-### コンテナ構成
 | コンテナ | 技術 | 責務 |
 |---------|------|------|
-| Web App | React/Next.js | UI提供 |
-| API Server | Node.js/Express | ビジネスロジック |
-| Database | PostgreSQL | データ永続化 |
-
-### コンテナ間通信
-[Describe how containers communicate]
+| Web App | React | UI提供 |
+| API | Node.js | ビジネスロジック |
+| DB | PostgreSQL | データ永続化 |
 
 ## 3. Component Level
-
-### [Container Name] コンポーネント
-
 | コンポーネント | 種別 | 責務 | 依存先 |
 |---------------|------|------|--------|
 | XxxService | Service | ビジネスロジック | XxxRepository |
 | XxxRepository | Repository | データアクセス | Database |
-| XxxController | Controller | リクエスト処理 | XxxService |
-
-## 4. 設計パターン
-
-### 適用パターン
-| パターン | 適用箇所 | 理由 |
-|---------|---------|------|
-| Repository | データアクセス層 | 永続化の抽象化 |
-| Service | ビジネス層 | ロジックの集約 |
-| Factory | オブジェクト生成 | 生成ロジックの分離 |
-
-## 5. 非機能要件への対応
-
-### セキュリティ
-- 認証: [方式]
-- 認可: [方式]
-- データ保護: [方式]
-
-### スケーラビリティ
-- [スケーリング戦略]
-
-### 可用性
-- [可用性設計]
-```
-
-## C4 Diagram Syntax (Mermaid)
-
-### Context Diagram
-```mermaid
-flowchart TB
-    subgraph External["外部システム"]
-        User[ユーザー]
-        ExtAPI[外部API]
-    end
-    
-    subgraph System["対象システム"]
-        App[アプリケーション]
-    end
-    
-    User --> App
-    App --> ExtAPI
-```
-
-### Container Diagram
-```mermaid
-flowchart TB
-    subgraph Containers["コンテナ構成"]
-        Web[Web App<br/>React]
-        API[API Server<br/>Node.js]
-        DB[(Database<br/>PostgreSQL)]
-    end
-    
-    Web --> API
-    API --> DB
-```
-
-### Component Diagram
-```mermaid
-flowchart TB
-    subgraph APIServer["API Server"]
-        Controller[Controller]
-        Service[Service]
-        Repository[Repository]
-    end
-    
-    Controller --> Service
-    Service --> Repository
 ```
 
-## Design Patterns Reference
+## Design Patterns
 
 | パターン | 用途 | 適用場面 |
 |---------|------|---------|
-| **Repository** | データアクセス抽象化 | DB操作 |
-| **Service** | ビジネスロジック集約 | ユースケース実装 |
-| **Factory** | オブジェクト生成 | 複雑な生成ロジック |
-| **Strategy** | アルゴリズム切替 | 認証方式、計算方式 |
-| **Observer** | イベント通知 | 状態変更の伝播 |
-| **Decorator** | 機能追加 | ログ、キャッシュ |
-
-## Domain-Specific Components
-
-Use `npx musubix design generate` to get domain-specific component recommendations for 62 domains.
+| Repository | データアクセス抽象化 | DB操作 |
+| Service | ビジネスロジック集約 | ユースケース |
+| Factory | オブジェクト生成 | 複雑な生成 |
+| Strategy | アルゴリズム切替 | 認証・計算方式 |
+
+## CLI
+
+```bash
+npx musubix design generate <file>    # 設計生成
+npx musubix design patterns <context> # パターン検出
+npx musubix design c4 <file>          # C4ダイアグラム
+npx musubix design traceability       # REQ↔DES検証
+```
 
-## Output Location
+## 出力例
 
-Save design documents to:
 ```
-storage/design/DES-[CATEGORY]-[NUMBER].md
+┌─────────────────────────────────────────┐
+│ C4 Design Generated                     │
+├─────────────────────────────────────────┤
+│ Design ID:   DES-SHOP-001              │
+│ Containers:  3 (Web, API, DB)          │
+│ Components:  8 (Services, Repos)       │
+│ Patterns:    Repository, Service       │
+│ Traceability: REQ-SHOP-001            │
+└─────────────────────────────────────────┘
 ```
-
-## Related Skills
-
-- `musubix-ears-validation` - Requirements validation
-- `musubix-code-generation` - Generate code from design
-- `musubix-adr-generation` - Document architecture decisions

package/.github/skills/musubix-code-generation/SKILL.md

@@ -1,237 +1,90 @@
 ---
 name: musubix-code-generation
-description: Guide for generating code from design specifications using MUSUBIX. Use this when asked to generate code, implement features, or create components following design documents.
+description: 設計仕様からコード生成ガイド。実装・機能作成に使用。
 license: MIT
 ---
 
-# MUSUBIX Code Generation Skill
+# Code Generation Skill
 
-This skill guides you through generating code from design specifications following MUSUBIX methodology.
-
-## Prerequisites
-
-Before generating code:
-
-1. Verify design document exists (`DES-*`)
-2. Verify requirements are traceable (`REQ-*`)
-3. Check `steering/tech.ja.md` for technology stack
+設計ドキュメントからコードを生成し、トレーサビリティを維持。
 
 ## Supported Languages
 
-| Language | Extension | Features |
-|----------|-----------|----------|
-| TypeScript | `.ts` | Full support with types |
+| 言語 | 拡張子 | サポート機能 |
+|------|--------|-------------|
+| TypeScript | `.ts` | フル型サポート |
 | JavaScript | `.js` | ES6+ modules |
-| Python | `.py` | Type hints support |
-| Java | `.java` | Interface/Class generation |
-| Go | `.go` | Struct/Interface generation |
-| Rust | `.rs` | Trait/Struct generation |
-| C# | `.cs` | Interface/Class generation |
-
-## Code Generation Workflow
+| Python | `.py` | 型ヒント |
+| Java/Go/Rust/C# | 各種 | Interface/Struct生成 |
 
-### Step 1: Read Design Document
-
-```bash
-# Generate code from design
-npx musubix codegen generate <design-file>
-```
+## WHEN → DO
 
-### Step 2: Generate with Traceability
+| WHEN | DO |
+|------|-----|
+| コード生成前 | DES-*とREQ-*の存在確認 |
+| 実装開始 | テスト先行（Article III） |
+| コード作成 | @see タグでトレーサビリティ追加 |
 
-Always include requirement references:
+## Traceability Comment
 
 ```typescript
 /**
  * UserService - Handles user operations
- * 
  * @see REQ-INT-001 - Neuro-Symbolic Integration
  * @see DES-INT-001 - Integration Layer Design
  */
-export class UserService {
-  // Implementation
-}
-```
-
-### Step 3: Follow Test-First (Article III)
-
-1. **Write test first**:
-```typescript
-describe('UserService', () => {
-  it('should create user', async () => {
-    const service = new UserService();
-    const user = await service.create({ name: 'Test' });
-    expect(user.id).toBeDefined();
-  });
-});
-```
-
-2. **Implement minimal code**:
-```typescript
-export class UserService {
-  async create(data: CreateUserDto): Promise<User> {
-    return { id: generateId(), ...data };
-  }
-}
+export class UserService { ... }
 ```
 
-3. **Refactor**
-
 ## Design Pattern Templates
 
-### Singleton Pattern
-```typescript
-/**
- * @see REQ-DES-001 - Pattern Detection
- * @pattern Singleton
- */
-export class ConfigManager {
-  private static instance: ConfigManager;
-  
-  private constructor() {}
-  
-  static getInstance(): ConfigManager {
-    if (!ConfigManager.instance) {
-      ConfigManager.instance = new ConfigManager();
-    }
-    return ConfigManager.instance;
-  }
-}
-```
-
-### Factory Pattern
-```typescript
-/**
- * @see REQ-DES-001 - Pattern Detection
- * @pattern Factory
- */
-export interface ServiceFactory {
-  create(type: string): Service;
-}
-
-export class DefaultServiceFactory implements ServiceFactory {
-  create(type: string): Service {
-    switch (type) {
-      case 'auth': return new AuthService();
-      case 'user': return new UserService();
-      default: throw new Error(`Unknown service: ${type}`);
-    }
-  }
-}
-```
+| パターン | 用途 |
+|---------|------|
+| **Singleton** | グローバルインスタンス管理 |
+| **Factory** | 型に応じたオブジェクト生成 |
+| **Repository** | データアクセス抽象化 |
 
 ### Repository Pattern
+
 ```typescript
-/**
- * @see REQ-COD-001 - Code Generation
- * @pattern Repository
- */
+/** @pattern Repository */
 export interface Repository<T> {
   findById(id: string): Promise<T | null>;
-  findAll(): Promise<T[]>;
   save(entity: T): Promise<T>;
   delete(id: string): Promise<void>;
 }
-
-export class UserRepository implements Repository<User> {
-  async findById(id: string): Promise<User | null> {
-    // Implementation
-  }
-  // ... other methods
-}
 ```
 
-## CLI Commands
+## CLI
 
 ```bash
-# Generate code from design
-npx musubix codegen generate <design-file>
-
-# Generate status transition code (v3.1.0)
-npx musubix codegen status <spec>
-npx musubix codegen status <spec> --enum   # Use enum type
-
-# Analyze existing code
-npx musubix codegen analyze <file>
-
-# Security scan
-npx musubix codegen security <path>
-
-# Scaffold with Value Objects and Status machines (v3.1.0)
-npx musubix scaffold domain-model <name> -v "Price,Email"
-npx musubix scaffold domain-model <name> -s "Order,Task"
+npx musubix codegen generate <design-file>    # コード生成
+npx musubix codegen generate <file> --full-skeleton  # 4ファイル生成
+npx musubix codegen generate <file> --with-tests     # テスト付き
+npx musubix codegen status <spec>             # ステータス遷移コード
+npx musubix codegen status <spec> --enum      # enum型
+npx musubix codegen analyze <file>            # 静的解析
+npx musubix codegen security <path>           # セキュリティスキャン
 ```
 
 ## Quality Checks (Article IX)
 
-Before committing code:
-
-- [ ] **Type Safety**: No `any` types (TypeScript)
-- [ ] **Traceability**: All classes/functions have `@see` references
-- [ ] **Tests**: Test coverage ≥ 80%
-- [ ] **Linting**: `npm run lint` passes
-- [ ] **Build**: `npm run build` succeeds
-
-## Neuro-Symbolic Integration (REQ-INT-002)
-
-When generating code that involves decision-making:
+- [ ] No `any` types
+- [ ] @see references on all classes/functions
+- [ ] Test coverage ≥ 80%
+- [ ] `npm run lint` passes
+- [ ] `npm run build` succeeds
 
-```typescript
-/**
- * @see REQ-INT-002 - Confidence Evaluation
- */
-async function integrateResults(
-  neuralResult: NeuralResult,
-  symbolicResult: SymbolicResult
-): Promise<FinalResult> {
-  // Decision rules from REQ-INT-002
-  if (symbolicResult.status === 'invalid') {
-    return rejectNeural(neuralResult);
-  }
-  
-  if (neuralResult.confidence >= 0.8) {
-    return adoptNeural(neuralResult);
-  }
-  
-  return prioritizeSymbolic(symbolicResult);
-}
-```
-
-## File Structure Convention
+## 出力例
 
 ```
-packages/
-├── core/
-│   └── src/
-│       ├── [feature]/
-│       │   ├── index.ts        # Public exports
-│       │   ├── [feature].ts    # Main implementation
-│       │   ├── types.ts        # Type definitions
-│       │   └── __tests__/      # Tests
-│       └── index.ts            # Package exports
-```
-
-## Error Handling Pattern
-
-```typescript
-/**
- * @see REQ-ERR-001 - Graceful Degradation
- */
-export class MuSubixError extends Error {
-  constructor(
-    message: string,
-    public code: string,
-    public recoverable: boolean = true
-  ) {
-    super(message);
-    this.name = 'MuSubixError';
-  }
-}
-
-// Usage
-throw new MuSubixError(
-  'Failed to connect to YATA',
-  'YATA_CONNECTION_ERROR',
-  true // Can retry
-);
+┌─────────────────────────────────────────┐
+│ Code Generated                          │
+├─────────────────────────────────────────┤
+│ Source:     DES-AUTH-001               │
+│ Files:      4 generated                │
+│ Patterns:   Repository, Service        │
+│ Coverage:   @see tags added            │
+│ Tests:      test stubs generated       │
+└─────────────────────────────────────────┘
 ```