musubix 3.6.0 → 3.7.3

package/.github/skills/eval-harness/examples/regression-eval.md

@@ -0,0 +1,228 @@
+# Regression Eval Examples
+
+## Example 1: User Service Regression
+
+```markdown
+[REGRESSION EVAL: user-service]
+
+Baseline: abc1234 (v3.6.0 release)
+Date: 2026-01-25
+
+Tests:
+  - user.create.test.ts: PASS
+  - user.update.test.ts: PASS
+  - user.delete.test.ts: FAIL
+  - user.search.test.ts: PASS
+  - user.auth.test.ts: PASS
+
+Result: 4/5 passed (previously 5/5)
+
+Regression Detected: Yes
+
+Failed Test Details:
+  - user.delete.test.ts:
+    - Error: "ValidationError: Cannot delete user with active sessions"
+    - Line: 45
+    - Expected: 204 No Content
+    - Actual: 400 Bad Request
+
+Root Cause:
+  - 新しいバリデーションルールが追加され、アクティブセッションを持つユーザーの削除が禁止された
+
+Resolution:
+  - [ ] テストを更新して新しい挙動を反映
+  - [ ] または、バリデーションルールの見直し
+
+Notes:
+  - この変更は意図的なセキュリティ強化
+  - テストケースの更新が必要
+```
+
+---
+
+## Example 2: API Endpoint Regression
+
+```markdown
+[REGRESSION EVAL: api-endpoints]
+
+Baseline: def5678 (v3.5.0 release)
+Date: 2026-01-25
+
+Tests:
+  - api.auth.test.ts: PASS
+  - api.users.test.ts: PASS
+  - api.products.test.ts: PASS
+  - api.orders.test.ts: PASS
+  - api.payments.test.ts: PASS
+
+Result: 5/5 passed (previously 5/5)
+
+Regression Detected: No
+
+Performance Comparison:
+  | Endpoint      | Baseline | Current | Change |
+  |---------------|----------|---------|--------|
+  | GET /users    | 45ms     | 42ms    | -6.7%  |
+  | POST /orders  | 120ms    | 115ms   | -4.2%  |
+  | GET /products | 30ms     | 28ms    | -6.7%  |
+
+Notes:
+  - パフォーマンスの改善を確認
+  - 機能的な回帰なし
+```
+
+---
+
+## Example 3: Database Migration Regression
+
+```markdown
+[REGRESSION EVAL: database-schema]
+
+Baseline: ghi9012 (pre-migration)
+Date: 2026-01-25
+
+Tests:
+  - migration.up.test.ts: PASS
+  - migration.down.test.ts: PASS
+  - schema.integrity.test.ts: FAIL
+  - data.consistency.test.ts: PASS
+  - index.performance.test.ts: PASS
+
+Result: 4/5 passed (previously 5/5)
+
+Regression Detected: Yes
+
+Failed Test Details:
+  - schema.integrity.test.ts:
+    - Error: "Foreign key constraint violation"
+    - Table: orders
+    - Constraint: fk_orders_users
+    - Reason: 孤立したorder レコードが存在
+
+Root Cause:
+  - マイグレーション前に外部キー制約がなかったため、不整合データが存在
+  - マイグレーションで制約を追加したことで検出
+
+Resolution:
+  - [x] 不整合データのクリーンアップスクリプトを実行
+  - [x] 制約を段階的に適用（まずソフト制約、その後ハード制約）
+  - [ ] データ検証の自動化テストを追加
+
+Notes:
+  - 本番環境適用前にデータクリーンアップが必須
+```
+
+---
+
+## Example 4: Frontend Component Regression
+
+```markdown
+[REGRESSION EVAL: ui-components]
+
+Baseline: jkl3456 (design-system-v2)
+Date: 2026-01-25
+
+Tests:
+  - button.visual.test.ts: PASS
+  - input.visual.test.ts: PASS
+  - modal.visual.test.ts: FAIL
+  - table.visual.test.ts: PASS
+  - form.visual.test.ts: PASS
+  - navigation.visual.test.ts: PASS
+
+Result: 5/6 passed (previously 6/6)
+
+Regression Detected: Yes
+
+Failed Test Details:
+  - modal.visual.test.ts:
+    - Error: "Visual diff exceeded threshold (15% vs 5% allowed)"
+    - Screenshot: .reports/screenshots/modal-diff.png
+    - Affected area: Close button position
+
+Root Cause:
+  - Flexboxのalign-items変更によりボタン位置が変化
+
+Resolution:
+  - [ ] CSSの修正
+  - [ ] または、ベースライン画像の更新（意図的変更の場合）
+
+Notes:
+  - デザインチームに確認が必要
+```
+
+---
+
+## Example 5: Security Regression
+
+```markdown
+[REGRESSION EVAL: security-scan]
+
+Baseline: mno7890 (security-audit-q4)
+Date: 2026-01-25
+
+Tests:
+  - auth.security.test.ts: PASS
+  - xss.prevention.test.ts: PASS
+  - csrf.protection.test.ts: PASS
+  - sql.injection.test.ts: PASS
+  - dependency.audit.test.ts: FAIL
+
+Result: 4/5 passed (previously 5/5)
+
+Regression Detected: Yes
+
+Failed Test Details:
+  - dependency.audit.test.ts:
+    - Error: "2 high severity vulnerabilities found"
+    - Packages:
+      1. lodash@4.17.20 → CVE-2021-23337 (Prototype Pollution)
+      2. axios@0.21.0 → CVE-2021-3749 (ReDoS)
+
+Resolution:
+  - [x] lodash を 4.17.21 に更新
+  - [x] axios を 0.21.4 に更新
+  - [x] npm audit を再実行して確認
+
+Notes:
+  - 依存関係の自動更新を検討
+  - Dependabotの設定を確認
+```
+
+---
+
+## Template for New Regression Eval
+
+```markdown
+[REGRESSION EVAL: <feature-name>]
+
+Baseline: <Git SHA または チェックポイント名> (<説明>)
+Date: YYYY-MM-DD
+
+Tests:
+  - <test-file-1>: <PASS|FAIL>
+  - <test-file-2>: <PASS|FAIL>
+  - <test-file-3>: <PASS|FAIL>
+  - <test-file-4>: <PASS|FAIL>
+
+Result: X/Y passed (previously Y/Y)
+
+Regression Detected: <Yes|No>
+
+Failed Test Details (if any):
+  - <test-file>:
+    - Error: "<エラーメッセージ>"
+    - Line: <行番号>
+    - Expected: <期待値>
+    - Actual: <実際の値>
+
+Root Cause:
+  - <回帰の原因分析>
+
+Resolution:
+  - [ ] <解決策1>
+  - [ ] <解決策2>
+
+Notes:
+  - <追加の注記>
+```

package/.github/skills/learning-hooks/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: learning-hooks
+description: セッションから再利用可能なパターンを自動抽出し、学習済みスキルとして保存。
+license: MIT
+version: 1.1.0
+triggers:
+  - セッション終了（10メッセージ以上）
+  - エラー解決後
+  - ユーザー修正後
+---
+
+# Learning Hooks
+
+> **要約**: セッションから再利用可能なパターンを自動抽出し、次回以降に活用。
+
+## 🔄 トリガーと即時アクション
+
+### パターン抽出 (REQ-LH-001)
+
+**WHEN** セッション終了時（条件: メッセージ10件以上 AND 15分以上）  
+**DO** 以下のパターンを抽出
+
+| タイプ | 説明 | 抽出条件 |
+|--------|------|---------|
+| `error_resolution` | エラー解決 | エラー→修正→解消の流れ |
+| `user_corrections` | ユーザー修正 | AI提案を修正→承認 |
+| `workarounds` | 回避策 | ライブラリ既知問題への対処 |
+| `debugging_techniques` | デバッグ技法 | 問題調査・解決手法 |
+| `project_specific` | プロジェクト固有 | アーキテクチャ、命名規則 |
+
+### 抽出フロー
+
+```
+セッション終了 → 条件チェック → 会話分析 → パターン候補 → 信頼度計算(≥0.7) → 保存
+```
+
+---
+
+## 📁 Learned Skills Storage (REQ-LH-002)
+
+**保存先**: `~/.musubix/skills/learned/<pattern-name>/SKILL.md`
+
+**フォーマット**:
+```markdown
+# [パターン名]
+
+**Extracted:** [日付]
+**Context:** [適用条件]
+**Confidence:** [信頼度]
+
+## Problem
+[解決する問題]
+
+## Solution
+[パターン/技法/回避策]
+
+## Example
+[コード例]
+
+## When to Use
+[トリガー条件]
+```
+
+---
+
+## 🚫 Pattern Ignore List (REQ-LH-003)
+
+**抽出しない**:
+- 単純なタイポ修正
+- 一時的な問題の修正
+- 外部API障害への対応
+
+---
+
+## 💡 抽出例
+
+### error_resolution
+```markdown
+# TypeScript TS2322 型不一致の解決
+
+**Problem:** `Type 'string' is not assignable to type 'number'`
+**Solution:** 明示的な型変換 `Number(value)` または型ガード追加
+**When:** TS2322エラーが発生し、型変換が必要な場合
+```
+
+### workaround
+```markdown
+# Vitest ESMモード設定
+
+**Problem:** ESMモジュールでVitestが動作しない
+**Solution:** `vitest.config.ts`に`deps.inline: [...]`を追加
+**When:** ESMパッケージをテストする際
+```
+
+---
+
+## トレーサビリティ
+
+- REQ-LH-001: Continuous Learning Evaluation
+- REQ-LH-002: Learned Skills Storage
+- REQ-LH-003: Pattern Ignore List

package/.github/skills/learning-hooks/templates/learned-skill-template.md

@@ -0,0 +1,79 @@
+# Learned Skill Template
+
+学習されたスキルのテンプレートです。
+
+---
+
+# [Descriptive Pattern Name]
+
+**Extracted:** [Date: YYYY-MM-DD]
+**Source:** [Session ID or Project]
+**Context:** [When this applies]
+**Confidence:** [0.0-1.0]
+**Category:** [error_resolution|user_corrections|workarounds|debugging_techniques|project_specific]
+
+---
+
+## Problem
+
+[What problem this solves]
+
+- 発生条件
+- エラーメッセージ（該当する場合）
+- 影響範囲
+
+---
+
+## Solution
+
+[The pattern/technique/workaround]
+
+### 手順
+
+1. ステップ1
+2. ステップ2
+3. ステップ3
+
+### 注意点
+
+- 注意点1
+- 注意点2
+
+---
+
+## Example
+
+```typescript
+// コード例（該当する場合）
+```
+
+---
+
+## When to Use
+
+[Trigger conditions]
+
+- トリガー1
+- トリガー2
+- トリガー3
+
+---
+
+## Related Patterns
+
+- [関連パターン1]
+- [関連パターン2]
+
+---
+
+## Metadata
+
+```yaml
+extracted_from: session-2026-01-25
+usage_count: 0
+last_used: null
+success_rate: null
+tags:
+  - tag1
+  - tag2
+```

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

@@ -0,0 +1,74 @@
+---
+name: musubix-adr-generation
+description: Architecture Decision Records作成ガイド。技術選定・設計判断のドキュメント化に使用。
+license: MIT
+---
+
+# ADR Generation Skill
+
+**Article VIII - Decision Records**に基づきADRを作成。
+
+## WHEN → DO
+
+| WHEN | DO |
+|------|-----|
+| 技術選定を記録したい | Technology Selection ADRを作成 |
+| 設計パターンを決定 | Architecture Pattern ADRを作成 |
+| トレードオフを文書化 | 選択肢の比較表を作成 |
+
+## ADR Template
+
+```markdown
+# ADR-[NUMBER]: [Decision Title]
+
+## ステータス
+[Proposed | Accepted | Deprecated | Superseded by ADR-XXX]
+
+## コンテキスト
+[決定の背景・動機]
+
+## 決定
+[採用する解決策]
+
+## 選択肢
+
+### Option 1: [Name]
+| メリット | デメリット |
+|---------|-----------|
+| [Advantage] | [Disadvantage] |
+
+## 結果
+[この決定による影響]
+
+## トレーサビリティ
+- 関連要件: REQ-XXX-NNN
+- 関連設計: DES-XXX-NNN
+```
+
+## 典型的ADRトピック
+
+| カテゴリ | 例 | 決定ポイント |
+|---------|-----|-------------|
+| **言語選定** | TypeScript vs Go | 型安全性, エコシステム, 学習曲線 |
+| **アーキテクチャ** | Layered vs Hexagonal | チームスキル, 複雑度, テスト容易性 |
+| **DB選定** | PostgreSQL vs MongoDB | ACID要件, スキーマ柔軟性 |
+| **認証方式** | JWT vs Session | ステートレス要件, セキュリティ |
+
+## CLI
+
+```bash
+npx musubix design adr <decision>   # ADR生成
+```
+
+## 出力例
+
+```
+┌─────────────────────────────────────────┐
+│ ADR Generated                           │
+├─────────────────────────────────────────┤
+│ ID:      ADR-001                        │
+│ Title:   Use TypeScript for Backend     │
+│ Status:  Proposed                       │
+│ Path:    docs/adr/ADR-001.md            │
+└─────────────────────────────────────────┘
+```

package/.github/skills/musubix-best-practices/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: musubix-best-practices
+description: MUSUBIX学習済み17ベストプラクティスガイド。コード・設計・テストパターンの適用に使用。
+license: MIT
+---
+
+# Best Practices Skill
+
+14以上のプロジェクトから学習した17のベストプラクティス。
+
+## Code Patterns (5)
+
+| ID | パターン | 概要 |
+|----|---------|------|
+| BP-CODE-001 | Entity Input DTO | 複数パラメータ→DTOオブジェクト |
+| BP-CODE-002 | Date-based ID | `PREFIX-YYYYMMDD-NNN`形式 |
+| BP-CODE-003 | Value Objects | ドメイン概念にVO使用 |
+| BP-CODE-004 | Function-based VO | interface + factory関数（classは非推奨） |
+| BP-CODE-005 | Result Type | `Result<T, E>`で失敗を表現 |
+
+### BP-CODE-004: Function-based VO
+
+```typescript
+// ✅ 推奨
+interface Price { readonly amount: number; readonly currency: 'JPY'; }
+function createPrice(amount: number): Result<Price, ValidationError> {
+  if (amount < 100) return err(new ValidationError('...'));
+  return ok({ amount, currency: 'JPY' });
+}
+
+// ❌ 非推奨: class-based
+```
+
+## Design Patterns (7)
+
+| ID | パターン | 概要 |
+|----|---------|------|
+| BP-DESIGN-001 | Status Transition Map | `Record<Status, Status[]>`で遷移定義 |
+| BP-DESIGN-002 | Repository Async | 将来DB移行に備えてasync化 |
+| BP-DESIGN-003 | Service Layer DI | リポジトリをDI |
+| BP-DESIGN-004 | Optimistic Locking | versionフィールドで同時編集検出 |
+| BP-DESIGN-005 | AuditService | データ変更の監査ログ |
+| BP-DESIGN-006 | Entity Counter Reset | テスト用resetXxxCounter() |
+| BP-DESIGN-007 | Expiry Time Logic | expiresAtで有効期限管理 |
+
+### BP-DESIGN-001: Status Transition Map
+
+```typescript
+const validTransitions: Record<Status, Status[]> = {
+  draft: ['active', 'cancelled'],
+  active: ['completed', 'cancelled'],
+  completed: [], cancelled: [],
+};
+```
+
+## Test Patterns (5)
+
+| ID | パターン | 概要 |
+|----|---------|------|
+| BP-TEST-001 | Counter Reset | beforeEachでIDカウンターリセット |
+| BP-TEST-002 | Verify API | テスト前にAPIシグネチャ確認 |
+| BP-TEST-003 | Vitest ESM | Vitest + TypeScript ESM構成 |
+| BP-TEST-004 | Result Type Test | isOk()/isErr()で両ケーステスト |
+| BP-TEST-005 | Status Transition | 有効・無効遷移を網羅テスト |
+
+## CLI
+
+```bash
+npx musubix learn best-practices               # 全パターン表示
+npx musubix learn best-practices --category code
+npx musubix learn best-practices --high-confidence
+```
+
+## 出力例
+
+```
+┌────────────────────────────────────────────────┐
+│ Best Practices Applied                         │
+├────────────────────────────────────────────────┤
+│ Code Patterns:   5 applied                     │
+│ Design Patterns: 7 applied                     │
+│ Test Patterns:   5 applied                     │
+│ Confidence:      95% average                   │
+└────────────────────────────────────────────────┘
+```

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

@@ -0,0 +1,86 @@
+---
+name: musubix-c4-design
+description: C4モデル設計ドキュメント作成ガイド。アーキテクチャ図・コンポーネント設計に使用。
+license: MIT
+---
+
+# C4 Design Skill
+
+C4モデル4レベルでアーキテクチャを構造化。
+
+## C4 Levels
+
+| Level | 名称 | 内容 |
+|-------|------|------|
+| **1** | Context | システム境界・外部アクター |
+| **2** | Container | 技術選択・デプロイ単位 |
+| **3** | Component | コンテナ内部構造 |
+| **4** | Code | 実装詳細（任意） |
+
+## WHEN → DO
+
+| WHEN | DO |
+|------|-----|
+| 設計開始前 | `storage/specs/`のREQ-*を確認 |
+| 新規システム設計 | Context→Container→Componentの順で作成 |
+| コンポーネント追加 | Component Levelを更新 |
+
+## Design Template
+
+```markdown
+# DES-[CATEGORY]-[NUMBER]: [Title]
+
+## メタデータ
+- 作成日: YYYY-MM-DD
+- トレーサビリティ: REQ-XXX-NNN
+
+## 1. Context Level
+| アクター | 説明 | インタラクション |
+|---------|------|-----------------|
+| User | システム利用者 | Web UI経由 |
+
+## 2. Container Level
+| コンテナ | 技術 | 責務 |
+|---------|------|------|
+| Web App | React | UI提供 |
+| API | Node.js | ビジネスロジック |
+| DB | PostgreSQL | データ永続化 |
+
+## 3. Component Level
+| コンポーネント | 種別 | 責務 | 依存先 |
+|---------------|------|------|--------|
+| XxxService | Service | ビジネスロジック | XxxRepository |
+| XxxRepository | Repository | データアクセス | Database |
+```
+
+## Design Patterns
+
+| パターン | 用途 | 適用場面 |
+|---------|------|---------|
+| 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検証
+```
+
+## 出力例
+
+```
+┌─────────────────────────────────────────┐
+│ C4 Design Generated                     │
+├─────────────────────────────────────────┤
+│ Design ID:   DES-SHOP-001              │
+│ Containers:  3 (Web, API, DB)          │
+│ Components:  8 (Services, Repos)       │
+│ Patterns:    Repository, Service       │
+│ Traceability: REQ-SHOP-001            │
+└─────────────────────────────────────────┘
+```