musubix 3.6.0 → 3.7.3

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

@@ -0,0 +1,90 @@
+---
+name: musubix-code-generation
+description: 設計仕様からコード生成ガイド。実装・機能作成に使用。
+license: MIT
+---
+
+# Code Generation Skill
+
+設計ドキュメントからコードを生成し、トレーサビリティを維持。
+
+## Supported Languages
+
+| 言語 | 拡張子 | サポート機能 |
+|------|--------|-------------|
+| TypeScript | `.ts` | フル型サポート |
+| JavaScript | `.js` | ES6+ modules |
+| Python | `.py` | 型ヒント |
+| Java/Go/Rust/C# | 各種 | Interface/Struct生成 |
+
+## WHEN → DO
+
+| WHEN | DO |
+|------|-----|
+| コード生成前 | DES-*とREQ-*の存在確認 |
+| 実装開始 | テスト先行（Article III） |
+| コード作成 | @see タグでトレーサビリティ追加 |
+
+## Traceability Comment
+
+```typescript
+/**
+ * UserService - Handles user operations
+ * @see REQ-INT-001 - Neuro-Symbolic Integration
+ * @see DES-INT-001 - Integration Layer Design
+ */
+export class UserService { ... }
+```
+
+## Design Pattern Templates
+
+| パターン | 用途 |
+|---------|------|
+| **Singleton** | グローバルインスタンス管理 |
+| **Factory** | 型に応じたオブジェクト生成 |
+| **Repository** | データアクセス抽象化 |
+
+### Repository Pattern
+
+```typescript
+/** @pattern Repository */
+export interface Repository<T> {
+  findById(id: string): Promise<T | null>;
+  save(entity: T): Promise<T>;
+  delete(id: string): Promise<void>;
+}
+```
+
+## CLI
+
+```bash
+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)
+
+- [ ] No `any` types
+- [ ] @see references on all classes/functions
+- [ ] Test coverage ≥ 80%
+- [ ] `npm run lint` passes
+- [ ] `npm run build` succeeds
+
+## 出力例
+
+```
+┌─────────────────────────────────────────┐
+│ Code Generated                          │
+├─────────────────────────────────────────┤
+│ Source:     DES-AUTH-001               │
+│ Files:      4 generated                │
+│ Patterns:   Repository, Service        │
+│ Coverage:   @see tags added            │
+│ Tests:      test stubs generated       │
+└─────────────────────────────────────────┘
+```

package/.github/skills/musubix-domain-inference/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: musubix-domain-inference
+description: 自動ドメイン検出・コンポーネント推論ガイド。プロジェクトドメイン特定に使用。
+license: MIT
+---
+
+# Domain Inference Skill
+
+**62ドメイン**・**224コンポーネント**を自動検出・推奨。
+
+## Domain Categories
+
+| カテゴリ | ドメイン数 | 例 |
+|---------|-----------|-----|
+| **Business** | 8 | ecommerce, finance, crm, hr |
+| **Healthcare** | 3 | healthcare, pharmacy, veterinary |
+| **Service** | 20+ | booking, hotel, restaurant, gym |
+| **Technology** | 8 | iot, security, ai, analytics |
+
+## Key Domains
+
+| Domain | 名称 | Key Components |
+|--------|------|----------------|
+| ecommerce | EC・通販 | CartService, ProductCatalog, OrderProcessor |
+| finance | 金融 | AccountService, TransactionManager |
+| veterinary | 動物病院 | PetService, VetScheduleService |
+| booking | 予約 | ReservationService, SlotManager |
+| iot | IoT | DeviceManager, TelemetryProcessor |
+
+## WHEN → DO
+
+| WHEN | DO |
+|------|-----|
+| 新規プロジェクト開始 | 要件テキストからドメイン検出 |
+| 複数ドメインの場合 | primaryとsecondaryを特定 |
+| コンポーネント設計 | 推奨コンポーネントを適用 |
+
+## Detection Example
+
+```typescript
+const result = domainDetector.detect(`
+  ペットの予約管理システム。
+  獣医師のスケジュール管理とワクチン接種記録。
+`);
+// {
+//   primaryDomain: { id: 'veterinary' },
+//   confidence: 0.92,
+//   matchedKeywords: ['ペット', '獣医', 'ワクチン'],
+//   suggestedComponents: ['PetService', 'ReservationService']
+// }
+```
+
+## Architecture by Category
+
+| カテゴリ | アーキテクチャ | スケーリング |
+|---------|---------------|-------------|
+| Business | Layered + DDD | Vertical + Cache |
+| Technology | Microservices | Horizontal |
+| Healthcare | Layered + Audit | Vertical + Compliance |
+
+## CLI
+
+```bash
+npx musubix design patterns --detect-domain <file>  # ドメイン検出
+npx musubix design generate <file> --infer-components  # コンポーネント推論
+```
+
+## 出力例
+
+```
+┌─────────────────────────────────────────┐
+│ Domain Detected                         │
+├─────────────────────────────────────────┤
+│ Primary:    veterinary (動物病院)       │
+│ Confidence: 92%                         │
+│ Keywords:   ペット, 獣医, ワクチン      │
+│ Components: 5 recommended               │
+│ - PetService                            │
+│ - ReservationService                    │
+│ - VetScheduleService                    │
+└─────────────────────────────────────────┘
+```

package/.github/skills/musubix-ears-validation/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: musubix-ears-validation
+description: EARS形式要件の検証・作成ガイド。要件記述・構文検証に使用。
+license: MIT
+---
+
+# EARS Validation Skill
+
+EARS (Easy Approach to Requirements Syntax) で要件を形式化・検証。
+
+## EARS Patterns
+
+| パターン | 構文 | 用途 |
+|---------|------|------|
+| **Ubiquitous** | `THE [system] SHALL [requirement]` | 常に満たす要件 |
+| **Event-driven** | `WHEN [event], THE [system] SHALL [response]` | イベント発生時 |
+| **State-driven** | `WHILE [state], THE [system] SHALL [behavior]` | 特定状態中 |
+| **Unwanted** | `THE [system] SHALL NOT [behavior]` | 禁止事項 |
+| **Optional** | `IF [cond], THEN THE [system] SHALL [response]` | 条件付き |
+
+## WHEN → DO
+
+| WHEN | DO |
+|------|-----|
+| 自然言語の要件 | EARS形式に変換 |
+| 要件レビュー | 6項目チェックリスト実施 |
+| 要件文書作成 | テンプレートに従って記述 |
+
+## Validation Checklist
+
+- [ ] **Pattern Compliance**: 5パターンのいずれかに準拠
+- [ ] **System Name**: システム名が明確
+- [ ] **SHALL Keyword**: 必須要件に「SHALL」使用
+- [ ] **Measurable**: テスト可能・測定可能
+- [ ] **Atomic**: 単一の要件を記述
+- [ ] **No Ambiguity**: 曖昧な表現がない
+
+## Conversion Examples
+
+| 自然言語 | EARS形式 |
+|---------|---------|
+| ユーザーがログインできる | `THE AuthModule SHALL authenticate users with valid credentials.` |
+| パスワードが間違っている時エラー表示 | `WHEN invalid credentials are provided, THE AuthModule SHALL display an error.` |
+| SQLインジェクションを許可しない | `THE InputValidator SHALL NOT accept SQL injection patterns.` |
+
+## Priority Levels
+
+| 優先度 | 説明 | 用途 |
+|--------|------|------|
+| **P0** | 必須 | リリースブロッカー |
+| **P1** | 重要 | 可能な限り実装 |
+| **P2** | 任意 | 時間があれば |
+
+## CLI
+
+```bash
+npx musubix requirements validate <file>  # EARS検証
+npx musubix requirements analyze <file>   # 自然言語→EARS変換
+npx musubix requirements map <file>       # オントロジーマッピング
+```
+
+## 出力例
+
+```
+┌─────────────────────────────────────────┐
+│ EARS Validation Result                  │
+├─────────────────────────────────────────┤
+│ Requirements: 5 validated               │
+│ ✅ Ubiquitous:   2 passed               │
+│ ✅ Event-driven: 2 passed               │
+│ ✅ Unwanted:     1 passed               │
+│ Issues: 0                               │
+└─────────────────────────────────────────┘
+```

package/.github/skills/musubix-sdd-workflow/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: musubix-sdd-workflow
+description: MUSUBIX SDD開発ワークフローガイド。10憲法条項に従った開発プロセスに使用。
+license: MIT
+---
+
+# SDD Workflow Skill
+
+10憲法条項に基づくSDD (Specification-Driven Development) ワークフロー。
+
+## Prerequisites
+
+1. `steering/`を確認
+2. `steering/rules/constitution.md`の10条項を確認
+3. `storage/specs/`の既存specを確認
+
+## 5 Phases
+
+| Phase | 内容 | 成果物 |
+|-------|------|--------|
+| **1** | 要件定義 | REQ-* (EARS形式) |
+| **2** | 設計 | DES-* (C4モデル) |
+| **3** | タスク分解 | TSK-* (≤4時間) |
+| **4** | 実装 | Code + Tests (TDD) |
+| **5** | 完了 | CHANGELOG, Docs |
+
+## Phase Flow
+
+```
+Phase 1 → Review → Phase 2 → Review → Phase 3 → Review → Phase 4 → Phase 5
+   ↑___________↓     ↑___________↓     ↑___________↓
+     修正ループ         修正ループ         修正ループ
+```
+
+**⛔ 禁止**: Phase 2 → Phase 4 の直接遷移（必ずPhase 3を経由）
+
+## WHEN → DO
+
+| WHEN | DO |
+|------|-----|
+| 機能開発開始 | Phase 1から順に実行 |
+| レビューで問題発見 | 修正して再レビュー |
+| Phase 3完了前に実装要求 | 「Phase 3が必要」と回答 |
+| 実装フェーズ | TDD (Red→Green→Blue) |
+
+## Article X: Implementation Prerequisites
+
+**絶対ルール**: 要件・設計・タスクが承認されていない限り、実装禁止。
+
+```
+⛔ 禁止: Phase 2 → Phase 4
+✅ 必須: Phase 1 → 2 → 3 → 4
+```
+
+## CLI
+
+```bash
+# Requirements
+npx musubix requirements analyze <file>
+npx musubix requirements validate <file>
+
+# Design
+npx musubix design generate <file>
+npx musubix design traceability
+
+# Code
+npx musubix codegen generate <file>
+npx musubix codegen status <spec>
+
+# Scaffold
+npx musubix scaffold domain-model <name>
+npx musubix scaffold domain-model <name> -v "Price,Email"
+npx musubix scaffold domain-model <name> -s "Order,Task"
+```
+
+## Traceability Chain
+
+```
+REQ-* → DES-* → TSK-* → Code → Tests
+```
+
+## 出力例
+
+```
+┌─────────────────────────────────────────┐
+│ Workflow Status                         │
+├─────────────────────────────────────────┤
+│ Phase 1: ✅ Requirements (3 REQs)       │
+│ Phase 2: ✅ Design (1 DES)              │
+│ Phase 3: ✅ Tasks (5 TSKs)              │
+│ Phase 4: 🔄 Implementation (2/5 done)   │
+│ Phase 5: ⏸️ Pending                     │
+│ Traceability: 100%                      │
+└─────────────────────────────────────────┘
+```

package/.github/skills/musubix-technical-writing/SKILL.md

@@ -0,0 +1,108 @@
+---
+name: musubix-technical-writing
+description: 技術ドキュメント作成ガイド。README、ユーザーガイド、API参照に使用。
+license: MIT
+---
+
+# Technical Writing Skill
+
+高品質な技術ドキュメントを一貫した構造で作成。
+
+## Document Types
+
+| 種類 | 目的 | ファイル |
+|------|------|---------|
+| **README** | プロジェクト概要 | README.md |
+| **Install Guide** | セットアップ手順 | INSTALL-GUIDE.md |
+| **User Guide** | 使用方法詳細 | USER-GUIDE.md |
+| **API Reference** | API完全ドキュメント | API-REFERENCE.md |
+| **Changelog** | バージョン履歴 | CHANGELOG.md |
+
+## WHEN → DO
+
+| WHEN | DO |
+|------|-----|
+| 新規プロジェクト | READMEテンプレート適用 |
+| 機能追加 | User GuideとAPI Reference更新 |
+| リリース | Changelog更新 |
+| セットアップ手順変更 | Install Guide更新 |
+
+## README Template
+
+```markdown
+# Project Name
+
+> One-line description
+
+## 🎯 Features
+- Feature 1
+- Feature 2
+
+## 📦 Installation
+\`\`\`bash
+npm install package-name
+\`\`\`
+
+## 🚀 Quick Start
+\`\`\`typescript
+import { MainClass } from 'package-name';
+const instance = new MainClass();
+\`\`\`
+
+## 📖 Documentation
+- [Installation](docs/INSTALL-GUIDE.md)
+- [User Guide](docs/USER-GUIDE.md)
+- [API Reference](docs/API-REFERENCE.md)
+```
+
+## API Reference Template
+
+```markdown
+### `methodName(param1, param2)`
+
+Description.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `param1` | `string` | Yes | First param |
+| `param2` | `number` | No | Optional |
+
+**Returns**: `Promise<Result>`
+
+**Example**:
+\`\`\`typescript
+const result = await instance.methodName('value', 42);
+\`\`\`
+```
+
+## Changelog Format
+
+[Keep a Changelog](https://keepachangelog.com/)準拠:
+
+```markdown
+## [1.2.0] - 2026-01-15
+
+### Added
+- New feature description
+
+### Changed
+- Modified behavior
+
+### Fixed
+- Bug fix description
+```
+
+## 出力例
+
+```
+┌─────────────────────────────────────────┐
+│ Documentation Generated                 │
+├─────────────────────────────────────────┤
+│ README.md:        Updated              │
+│ INSTALL-GUIDE.md: Created              │
+│ USER-GUIDE.md:    Updated              │
+│ API-REFERENCE.md: Updated              │
+│ CHANGELOG.md:     Updated              │
+│ Total Sections:   15                   │
+└─────────────────────────────────────────┘
+```

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

@@ -0,0 +1,88 @@
+---
+name: musubix-test-generation
+description: テストコード生成ガイド。TDD/BDDによるユニット・統合テスト作成に使用。
+license: MIT
+---
+
+# Test Generation Skill
+
+**Article III - Test-First**: Red-Green-Blue TDDサイクルでテストを生成。
+
+## TDD Cycle
+
+```
+🔴 Red (Failing Test) → 🟢 Green (Minimal Code) → 🔵 Blue (Refactor)
+```
+
+## Test Categories
+
+| カテゴリ | 目的 | 場所 |
+|---------|------|------|
+| Unit | 単一コンポーネント | `__tests__/unit/` |
+| Integration | 複数コンポーネント連携 | `__tests__/integration/` |
+| E2E | フルユーザーフロー | `__tests__/e2e/` |
+
+## WHEN → DO
+
+| WHEN | DO |
+|------|-----|
+| 機能実装前 | テストを先に書く（Red） |
+| テスト失敗 | 最小限のコードで通す（Green） |
+| テスト成功 | リファクタリング（Blue） |
+
+## Test Template
+
+```typescript
+/**
+ * @requirement REQ-XXX-NNN
+ * @design DES-XXX-NNN
+ */
+describe('XxxService', () => {
+  let service: XxxService;
+  
+  beforeEach(() => {
+    resetXxxCounter();  // BP-TEST-001
+    service = new XxxService(new MockRepository());
+  });
+
+  it('should create entity with valid input', async () => {
+    const result = await service.create({ name: 'Test' });
+    expect(result.isOk()).toBe(true);
+  });
+
+  it('should return error for invalid input', async () => {
+    const result = await service.create({ name: '' });
+    expect(result.isErr()).toBe(true);
+  });
+});
+```
+
+## Best Practices
+
+| ID | パターン | 内容 |
+|----|---------|------|
+| BP-TEST-001 | Counter Reset | beforeEachでIDカウンターリセット |
+| BP-TEST-004 | Result Type | isOk()/isErr()で両ケーステスト |
+| BP-TEST-005 | Status Transition | 有効・無効遷移を網羅 |
+
+## CLI
+
+```bash
+npx musubix test generate <design-file>  # テスト生成
+npm test                                  # 全テスト実行
+npx musubix test coverage src/            # カバレッジ計測
+```
+
+## 出力例
+
+```
+┌─────────────────────────────────────────┐
+│ Test Generation Result                  │
+├─────────────────────────────────────────┤
+│ Source:     DES-AUTH-001               │
+│ Unit Tests: 8 generated                 │
+│ Coverage:   @requirement tags added     │
+│ Patterns:   BP-TEST-001, 004, 005       │
+│ Status:     Ready for TDD cycle         │
+└─────────────────────────────────────────┘
+```

package/.github/skills/musubix-traceability/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: musubix-traceability
+description: 要件・設計・コード・テスト間のトレーサビリティ管理ガイド。影響分析・マトリクス作成に使用。
+license: MIT
+---
+
+# Traceability Skill
+
+**Article V - Traceability**: 100%双方向トレーサビリティを維持。
+
+## Traceability Chain
+
+```
+REQ-* ↔ DES-* ↔ TSK-* ↔ Code ↔ Tests
+```
+
+## WHEN → DO
+
+| WHEN | DO |
+|------|-----|
+| 要件作成 | REQ-* IDを付与 |
+| 設計作成 | DES-* IDを付与、REQ-*に紐付け |
+| タスク作成 | TSK-* IDを付与、DES-*・REQ-*に紐付け |
+| コード作成 | @requirement, @design タグ追加 |
+| テスト作成 | @requirement, @design タグ追加 |
+| 要件変更 | 影響分析を実施 |
+
+## Traceability Matrix
+
+```markdown
+| 要件ID | 設計ID | タスクID | コード | テスト |
+|--------|--------|---------|--------|--------|
+| REQ-AUTH-001 | DES-AUTH-001 | TSK-001 | auth-service.ts | auth.test.ts |
+| REQ-AUTH-002 | DES-AUTH-001 | TSK-002 | token-manager.ts | token.test.ts |
+```
+
+## Code Traceability
+
+```typescript
+/**
+ * AuthService - 認証サービス
+ * @requirement REQ-AUTH-001
+ * @design DES-AUTH-001
+ * @task TSK-001
+ */
+export class AuthService { ... }
+```
+
+## Impact Analysis
+
+要件変更時の影響範囲特定:
+
+```
+REQ-AUTH-001 変更
+    ↓
+DES-AUTH-001 (設計)
+    ↓
+TSK-001, TSK-002 (タスク)
+    ↓
+auth-service.ts, token-manager.ts (コード)
+    ↓
+auth.test.ts, token.test.ts (テスト)
+```
+
+## Verification Checklist
+
+- [ ] 全要件に設計がリンク
+- [ ] 全設計にタスクがリンク
+- [ ] 全コードにトレーサビリティコメント
+- [ ] 全テストに@requirementタグ
+
+## CLI
+
+```bash
+npx musubix trace matrix           # マトリクス生成
+npx musubix trace impact REQ-*     # 影響分析
+npx musubix trace validate         # リンク検証
+npx musubix trace sync             # 自動更新
+```
+
+## 出力例
+
+```
+┌─────────────────────────────────────────┐
+│ Traceability Report                     │
+├─────────────────────────────────────────┤
+│ Requirements: 5 (100% linked)           │
+│ Designs:      3 (100% linked)           │
+│ Tasks:        8 (100% linked)           │
+│ Code Files:   12 (100% tagged)          │
+│ Test Files:   12 (100% tagged)          │
+│ Coverage:     100%                      │
+└─────────────────────────────────────────┘
+```