musubix 3.6.0 → 3.7.3

package/.github/skills/codemap/templates/codemap-index.md

@@ -0,0 +1,142 @@
+# Codemap Index Template
+
+MUSUBIX コードマップのインデックステンプレートです。
+
+---
+
+## 📍 Entry Points
+
+### CLI Commands
+| Command | Location | Description |
+|---------|----------|-------------|
+| `musubix init` | [packages/core/src/cli/commands/init.ts](packages/core/src/cli/commands/init.ts) | プロジェクト初期化 |
+| `musubix requirements` | [packages/core/src/cli/commands/requirements.ts](packages/core/src/cli/commands/requirements.ts) | 要件分析 |
+| `musubix design` | [packages/core/src/cli/commands/design.ts](packages/core/src/cli/commands/design.ts) | 設計生成 |
+| `musubix codegen` | [packages/core/src/cli/commands/codegen.ts](packages/core/src/cli/commands/codegen.ts) | コード生成 |
+
+### MCP Tools
+| Tool | Location | Description |
+|------|----------|-------------|
+| `sdd_create_requirements` | [packages/mcp-server/src/tools/](packages/mcp-server/src/tools/) | 要件作成 |
+| `pattern_extract` | [packages/pattern-mcp/src/](packages/pattern-mcp/src/) | パターン抽出 |
+| `knowledge_put_entity` | [packages/knowledge/src/](packages/knowledge/src/) | 知識グラフ操作 |
+
+---
+
+## 🔌 Integration Points
+
+### External Systems
+```
+┌──────────────────────────────────────────────────────────┐
+│                    MUSUBIX System                        │
+├──────────────────────────────────────────────────────────┤
+│  MCP Server ←→ Claude/Copilot                           │
+│  Knowledge Store ←→ .knowledge/graph.json               │
+│  Policy Engine ←→ steering/rules/                       │
+│  Codegraph ←→ TypeScript AST                            │
+└──────────────────────────────────────────────────────────┘
+```
+
+### Package Dependencies
+```
+core
+├── mcp-server (depends on)
+├── security (depends on)
+└── formal-verify (depends on)
+
+knowledge
+├── policy (depends on)
+└── decisions (depends on)
+
+agent-orchestrator
+├── workflow-engine (depends on)
+├── skill-manager (depends on)
+└── expert-delegation (depends on)
+```
+
+---
+
+## 📊 Key Data Flows
+
+### Requirements → Code Flow
+```
+1. Natural Language (User Input)
+   ↓
+2. EARS Requirements (REQ-*)
+   ↓ [packages/core/src/validators/ears-validator.ts]
+3. C4 Design (DES-*)
+   ↓ [packages/core/src/design/]
+4. Implementation Tasks (TSK-*)
+   ↓ [packages/core/src/codegen/]
+5. Generated Code
+```
+
+### Pattern Learning Flow
+```
+1. Code Observation
+   ↓
+2. Pattern Extraction [packages/pattern-mcp/]
+   ↓
+3. Pattern Storage [packages/library-learner/]
+   ↓
+4. Pattern Query & Reuse
+```
+
+---
+
+## 🧩 Core Abstractions
+
+### Entities
+- `Requirement`: EARS形式の要件
+- `Design`: C4モデルの設計
+- `Pattern`: 学習済みコードパターン
+- `Entity`: Knowledge Graph のエンティティ
+
+### Services
+- `EarsValidator`: EARS構文検証
+- `PatternLibrary`: パターン管理
+- `KnowledgeStore`: 知識グラフ操作
+- `PolicyEngine`: 憲法条項検証
+
+### Bridges (Integration)
+- `PatternBridge`: Core ↔ Pattern-MCP
+- `KnowledgeBridge`: Core ↔ Knowledge
+- `QualityGateBridge`: Core ↔ Policy
+- `CodemapBridge`: Core ↔ Codegraph
+- `RefactorCleanerBridge`: Core ↔ Security
+
+---
+
+## 🔍 Quick Navigation
+
+### "Where is X defined?"
+
+| Concept | Location |
+|---------|----------|
+| EARS Patterns | [packages/core/src/validators/ears-patterns.ts](packages/core/src/validators/ears-patterns.ts) |
+| 10 Constitution Articles | [steering/rules/constitution.md](steering/rules/constitution.md) |
+| MCP Tool Definitions | [packages/mcp-server/src/tools/](packages/mcp-server/src/tools/) |
+| Type Definitions | [packages/core/src/types/](packages/core/src/types/) |
+
+### "How does Y work?"
+
+| Feature | Key Files |
+|---------|-----------|
+| Pattern Learning | `packages/pattern-mcp/src/pattern-library.ts`, `packages/wake-sleep/src/` |
+| Traceability | `packages/core/src/traceability/` |
+| Formal Verification | `packages/formal-verify/src/`, `packages/lean/src/` |
+| Neural Search | `packages/neural-search/src/` |
+
+---
+
+## 📝 Update Instructions
+
+このファイルを更新する際の手順：
+
+1. 新しいパッケージ追加時 → Integration Points セクション更新
+2. 新しい CLI コマンド追加時 → Entry Points セクション更新
+3. 新しい Bridge 追加時 → Core Abstractions セクション更新
+4. 新しい型定義追加時 → Quick Navigation セクション更新
+
+**更新者**: 各パッケージのメンテナ
+**頻度**: リリースごと

package/.github/skills/codemap/templates/package-codemap.md

@@ -0,0 +1,160 @@
+# Package Codemap Template
+
+個別パッケージのコードマップテンプレートです。
+
+---
+
+## Package: `@nahisaho/musubix-{package-name}`
+
+### Overview
+
+| Property | Value |
+|----------|-------|
+| **Purpose** | {パッケージの目的} |
+| **Version** | {バージョン} |
+| **Dependencies** | {主要依存パッケージ} |
+| **Test Count** | {テスト数} |
+
+---
+
+### Directory Structure
+
+```
+packages/{package-name}/
+├── package.json
+├── tsconfig.json
+├── vitest.config.ts
+└── src/
+    ├── index.ts          # Public exports
+    ├── types.ts          # Type definitions
+    ├── {module}/         # Feature modules
+    │   ├── index.ts
+    │   ├── {service}.ts
+    │   └── __tests__/
+    │       └── {service}.test.ts
+    └── integration/      # Integration bridges
+        ├── index.ts
+        └── __tests__/
+```
+
+---
+
+### Public API
+
+#### Exports from `index.ts`
+
+```typescript
+// Main exports
+export { MainService } from './main-service';
+export { HelperFunction } from './helpers';
+
+// Types
+export type { MainConfig, MainResult } from './types';
+
+// Constants
+export { DEFAULT_CONFIG } from './constants';
+```
+
+#### Key Functions
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `createService` | `(config: Config) => Service` | サービスインスタンス生成 |
+| `processData` | `(data: Input) => Result<Output, Error>` | データ処理 |
+| `validateInput` | `(input: unknown) => boolean` | 入力検証 |
+
+---
+
+### Internal Modules
+
+#### `{module-name}/`
+
+**Purpose**: {モジュールの目的}
+
+**Key Files**:
+- `service.ts`: {説明}
+- `types.ts`: {説明}
+- `utils.ts`: {説明}
+
+**Dependencies**:
+- `../types`: 型定義
+- `external-package`: {用途}
+
+---
+
+### Data Flow
+
+```
+Input
+  ↓ [validate]
+Validated Input
+  ↓ [process]
+Intermediate State
+  ↓ [transform]
+Output
+```
+
+---
+
+### Integration Points
+
+#### Consumed By
+- `@nahisaho/musubix-{consumer-package}`: {用途}
+
+#### Consumes
+- `@nahisaho/musubix-{dependency-package}`: {用途}
+
+---
+
+### Configuration
+
+```typescript
+interface Config {
+  // Required
+  required: string;
+  
+  // Optional with defaults
+  optional?: number; // default: 10
+  
+  // Feature flags
+  enableFeature?: boolean; // default: false
+}
+```
+
+---
+
+### Error Handling
+
+| Error Class | When Thrown | Recovery |
+|-------------|-------------|----------|
+| `ValidationError` | Invalid input | Fix input |
+| `ProcessingError` | Processing failure | Retry |
+| `ConfigError` | Invalid config | Fix config |
+
+---
+
+### Testing Strategy
+
+| Type | Coverage Target | Location |
+|------|-----------------|----------|
+| Unit | 80%+ | `src/**/__tests__/*.test.ts` |
+| Integration | Key flows | `src/integration/__tests__/` |
+
+---
+
+### Change History
+
+| Version | Changes |
+|---------|---------|
+| v3.7.0 | Initial release |
+| v3.7.1 | Bug fixes |
+| v3.7.2 | Performance improvements |
+
+---
+
+## Update Instructions
+
+1. 新しい export 追加時 → Public API セクション更新
+2. 新しいモジュール追加時 → Internal Modules セクション更新
+3. 設定項目追加時 → Configuration セクション更新
+4. 新しいエラー追加時 → Error Handling セクション更新

package/.github/skills/context-optimizer/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: context-optimizer
+description: コンテキストウィンドウ最適化。圧縮提案、Pre/PostToolUse Hooks、モード注入。
+license: MIT
+version: 1.1.0
+triggers:
+  - ツール呼び出し50回超過
+  - ファイル編集後
+  - 危険なコマンド実行前
+  - /mode
+---
+
+# Context Optimizer
+
+> **要約**: コンテキストウィンドウを最適化し、効率的なセッション管理を支援。
+
+## 🔄 トリガーと即時アクション
+
+### 1. Strategic Compact (REQ-CO-001/002)
+
+**WHEN** ツール呼び出しが50回に到達  
+**DO** 圧縮を提案
+
+```
+💡 コンテキスト圧縮の提案
+━━━━━━━━━━━━━━━━━━━━━━
+ツール呼び出し: 50回
+フェーズ: [現在のフェーズ]
+━━━━━━━━━━━━━━━━━━━━━━
+圧縮前にsession-managerで状態を保存してください。
+```
+
+**リマインダースケジュール**:
+| 回数 | アクション |
+|------|----------|
+| 50回 | 圧縮提案 |
+| 75回 | リマインダー |
+| 100回 | 強い警告 |
+| 以降25回ごと | リマインダー |
+
+---
+
+### 2. PostToolUse Hooks (REQ-CO-004)
+
+**WHEN** ファイル編集後（Edit/Write）  
+**DO** ファイル種別に応じた自動チェック
+
+| 拡張子 | チェック | コマンド |
+|--------|---------|---------|
+| `.ts`, `.tsx` | 型チェック | `npx tsc --noEmit` |
+| `.ts`, `.tsx`, `.js` | フォーマット | `prettier --check` |
+| `.ts`, `.tsx`, `.js` | console.log検出 | `grep -n "console.log"` |
+
+**問題発見時**: ユーザーに報告し、修正を提案
+
+---
+
+### 3. PreToolUse Hooks (REQ-CO-005)
+
+**WHEN** 以下のコマンド実行前  
+**DO** 確認/警告を表示
+
+| パターン | アクション |
+|---------|----------|
+| `npm install`, `pnpm install` | tmux使用を提案 |
+| `npm run build`, `cargo build` | バックグラウンド実行を提案 |
+| `git push` | 変更差分の最終確認 |
+| `rm -rf`, `git reset --hard` | ⚠️ 破壊的操作の警告 |
+
+---
+
+### 4. Doc Blocker (REQ-CO-006)
+
+**WHEN** Markdownファイル作成時  
+**DO** 必要性を確認（以下は除外）
+
+**除外リスト**: `README.md`, `CHANGELOG.md`, `LICENSE`, `docs/**`, `.github/**`
+
+---
+
+## 🎯 Context Mode (REQ-CO-003)
+
+**WHEN** `/mode <name>` または モード切り替え要求  
+**DO** 対応するコンテキストを注入
+
+| モード | フォーカス | 推奨ツール |
+|--------|----------|----------|
+| `dev` | 実装・コーディング | Edit, Write, Bash |
+| `review` | コードレビュー | Read, Grep, Glob |
+| `research` | 調査・探索 | Read, Grep, semantic_search |
+
+**モード切り替え時の出力**:
+```
+🎯 Mode: [モード名]
+━━━━━━━━━━━━━━━━
+フォーカス: [説明]
+推奨ツール: [ツールリスト]
+```
+
+---
+
+## トレーサビリティ
+
+- REQ-CO-001: Strategic Compact Suggestion
+- REQ-CO-002: Tool Call Counter
+- REQ-CO-003: Context Mode Injection
+- REQ-CO-004: PostToolUse Hooks
+- REQ-CO-005: PreToolUse Hooks
+- REQ-CO-006: Doc Blocker

package/.github/skills/context-optimizer/contexts/dev.md

@@ -0,0 +1,40 @@
+# Development Mode Context
+
+このコンテキストはアクティブな開発・コーディングセッションに最適化されています。
+
+## フォーカス
+
+- 実装とコーディング
+- 機能開発
+- バグ修正
+- コード変更
+
+## 推奨ツール
+
+| ツール | 用途 |
+|--------|------|
+| `Edit` | ファイル編集 |
+| `Write` | 新規ファイル作成 |
+| `Bash` | コマンド実行、ビルド、テスト |
+| `Grep` | コード検索 |
+
+## ベストプラクティス
+
+1. **テスト駆動開発**: 実装前にテストを書く
+2. **小さな変更**: 一度に1つの変更に集中
+3. **頻繁なビルド確認**: 変更後は `npm run build` で確認
+4. **型チェック**: TypeScriptファイル編集後は `npx tsc --noEmit`
+
+## 自動チェック
+
+ファイル編集後、以下を自動実行：
+
+- `.ts`, `.tsx` → `npx tsc --noEmit`
+- `.js`, `.ts`, `.tsx` → Prettier確認
+- console.log検出 → 警告表示
+
+## 避けるべきこと
+
+- 大規模なリファクタリングを一度に行う
+- テストなしでコードをコミット
+- 型エラーを無視する

package/.github/skills/context-optimizer/contexts/research.md

@@ -0,0 +1,55 @@
+# Research Mode Context
+
+このコンテキストは調査・探索セッションに最適化されています。
+
+## フォーカス
+
+- コードベースの理解
+- アーキテクチャの把握
+- 依存関係の調査
+- ドキュメントの確認
+
+## 推奨ツール
+
+| ツール | 用途 |
+|--------|------|
+| `Read` | ファイル内容の確認 |
+| `Grep` | テキスト検索 |
+| `semantic_search` | 意味的なコード検索 |
+| `Glob` | ファイル構造の把握 |
+| `list_dir` | ディレクトリ構造の確認 |
+
+## 調査パターン
+
+### コードベース理解
+1. `README.md` を確認
+2. `package.json` で依存関係を把握
+3. エントリーポイント（`src/index.ts` 等）を確認
+4. ディレクトリ構造を把握
+
+### 機能調査
+1. 関連するファイルを特定（grep/semantic_search）
+2. 主要な関数・クラスを確認
+3. テストファイルで使用例を確認
+4. 型定義を確認
+
+### 依存関係調査
+1. `package.json` で直接依存を確認
+2. `import` 文をgrep検索
+3. 内部モジュール間の依存を追跡
+
+## 質問テンプレート
+
+調査中に以下の質問を意識：
+
+- このコードの目的は何か？
+- 誰がこのコードを使用するか？
+- どのような前提条件があるか？
+- 既知の制限事項は何か？
+- 関連するドキュメントはどこにあるか？
+
+## 避けるべきこと
+
+- 調査中にコードを変更する
+- 理解が不十分なまま結論を出す
+- 関連コードを見落とす

package/.github/skills/context-optimizer/contexts/review.md

@@ -0,0 +1,49 @@
+# Review Mode Context
+
+このコンテキストはコードレビューセッションに最適化されています。
+
+## フォーカス
+
+- コード品質の評価
+- 潜在的なバグの発見
+- ベストプラクティスの確認
+- セキュリティ問題の検出
+
+## 推奨ツール
+
+| ツール | 用途 |
+|--------|------|
+| `Read` | ファイル内容の確認 |
+| `Grep` | パターン検索 |
+| `Glob` | ファイル一覧取得 |
+| `semantic_search` | 関連コードの検索 |
+
+## レビューチェックリスト
+
+### コード品質
+- [ ] 命名規則が一貫している
+- [ ] 関数が単一責任原則に従っている
+- [ ] エラーハンドリングが適切
+- [ ] ログ出力が適切
+
+### セキュリティ
+- [ ] ユーザー入力のバリデーション
+- [ ] SQLインジェクション対策
+- [ ] XSS対策
+- [ ] 認証・認可の確認
+
+### パフォーマンス
+- [ ] N+1クエリがない
+- [ ] 不要なループがない
+- [ ] メモリリークの可能性がない
+
+### テスト
+- [ ] 十分なテストカバレッジ
+- [ ] エッジケースのテスト
+- [ ] エラーケースのテスト
+
+## 避けるべきこと
+
+- レビュー中にコードを直接編集する
+- 細かいスタイルの問題に時間をかけすぎる
+- コンテキストなしで批判する

package/.github/skills/e2e-runner/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: e2e-runner
+description: Playwrightを使用してE2Eテストを生成・実行。クリティカルユーザーフローの検証。
+license: MIT
+version: 1.1.0
+triggers:
+  - /e2e
+  - /playwright
+  - E2Eテスト
+---
+
+# E2E Runner
+
+> **要約**: PlaywrightでE2Eテストを生成・実行。テスト結果のレポートとスクリーンショット管理。
+
+## 📌 コマンド
+
+| コマンド | 説明 |
+|---------|------|
+| `/e2e generate <flow>` | テスト生成 |
+| `/e2e run [flow]` | テスト実行 |
+| `/e2e report` | レポート表示 |
+
+---
+
+## 🎬 テスト生成 (REQ-E2E-001)
+
+**WHEN** `/e2e generate <flow>` 実行  
+**DO** テストファイルを生成
+
+**出力構造**:
+```
+tests/e2e/
+├── <flow>.spec.ts     # テストファイル
+├── fixtures/
+│   └── <flow>.json    # テストデータ
+└── pages/
+    └── <flow>.page.ts # Page Object
+```
+
+**テストテンプレート**:
+```typescript
+import { test, expect } from '@playwright/test';
+
+test.describe('<Flow>', () => {
+  test('should complete flow', async ({ page }) => {
+    // Step 1: Navigate
+    await page.goto('/');
+    
+    // Step 2: Action
+    await page.click('[data-testid="button"]');
+    
+    // Step 3: Assert
+    await expect(page.locator('.success')).toBeVisible();
+  });
+});
+```
+
+---
+
+## ▶️ テスト実行 (REQ-E2E-002)
+
+**WHEN** `/e2e run [flow]` 実行  
+**DO** Playwrightでテスト実行
+
+| オプション | 説明 |
+|-----------|------|
+| `--headed` | ブラウザ表示 |
+| `--debug` | デバッグモード |
+| `--trace` | トレース記録 |
+| `--browser <name>` | ブラウザ指定 |
+
+```bash
+# 全テスト
+npx playwright test
+
+# 特定フロー
+npx playwright test tests/e2e/login.spec.ts
+
+# デバッグ
+npx playwright test --debug
+```
+
+---
+
+## 📊 レポート (REQ-E2E-003)
+
+**WHEN** テスト完了  
+**DO** レポート生成
+
+```
+📊 E2E Test Report
+━━━━━━━━━━━━━━━━━━━━━━━━
+Total:   10 tests
+Passed:  8 ✅
+Failed:  2 ❌
+Skipped: 0
+
+Duration: 45.2s
+━━━━━━━━━━━━━━━━━━━━━━━━
+
+Failed Tests:
+1. login.spec.ts > should login
+   Error: Timeout waiting for selector
+   Screenshot: playwright-report/login-1.png
+
+2. checkout.spec.ts > should pay
+   Error: Element not found
+   Screenshot: playwright-report/checkout-1.png
+```
+
+**HTMLレポート**:
+```bash
+npx playwright show-report
+```
+
+---
+
+## 📁 設定
+
+**playwright.config.ts**:
+```typescript
+export default defineConfig({
+  testDir: './tests/e2e',
+  timeout: 30000,
+  retries: 2,
+  use: {
+    baseURL: 'http://localhost:3000',
+    screenshot: 'only-on-failure',
+    trace: 'retain-on-failure',
+  },
+  projects: [
+    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
+    { name: 'firefox', use: { ...devices['Desktop Firefox'] } },
+  ],
+});
+```
+
+---
+
+## トレーサビリティ
+
+- REQ-E2E-001: E2E Test Generation
+- REQ-E2E-002: E2E Test Execution
+- REQ-E2E-003: E2E Report