musubix 3.6.0 → 3.7.3

package/.github/prompts/sdd-validate.prompt.md

@@ -0,0 +1,304 @@
+# MUSUBIX Validate Command
+
+Validate constitutional compliance and requirements coverage.
+
+---
+
+## Instructions for AI Agent
+
+You are executing the `musubix validate [feature-name]` command to validate constitutional compliance.
+
+### Command Format
+
+```bash
+npx musubix validate authentication
+npx musubix trace validate
+npx musubix trace matrix
+```
+
+### Your Task
+
+Perform comprehensive validation of the feature implementation against:
+
+1. 9 Constitutional Articles
+2. Requirements coverage (100% traceability)
+3. Code quality standards
+4. Test coverage
+
+---
+
+## Process
+
+### 1. Read All Documentation
+
+```bash
+# Requirements and Design
+storage/specs/REQ-{{FEATURE}}-001.md
+storage/specs/DES-{{FEATURE}}-001.md
+storage/specs/TSK-{{FEATURE}}-001.md
+
+# Steering Context
+steering/structure.ja.md
+steering/tech.ja.md
+steering/rules/constitution.md
+
+# Source Code
+packages/core/src/{{feature}}/**/*.ts
+packages/core/__tests__/**/*.test.ts
+packages/mcp-server/src/tools/**/*.ts
+```
+
+---
+
+### 2. Constitutional Validation
+
+Validate each of the 9 Constitutional Articles:
+
+#### Article I: Library-First Principle
+
+**Requirement**: Features as independent packages
+
+**Validation**:
+- [ ] Feature in `packages/` directory
+- [ ] Has `package.json` (monorepo workspace)
+- [ ] Exports public API via `index.ts`
+- [ ] No circular dependencies
+
+```markdown
+### Article I: Library-First Principle
+
+**Status**: ✅ PASS / ❌ FAIL
+
+**Evidence**:
+- Location: `packages/core/src/{{feature}}/`
+- Public API: `packages/core/src/{{feature}}/index.ts`
+- Exports: {{Feature}}Service, {{Feature}}Options
+```
+
+---
+
+#### Article II: CLI Interface Mandate
+
+**Requirement**: CLI interface for all libraries
+
+**Validation**:
+- [ ] CLI command exists in `packages/core/src/cli/commands/`
+- [ ] `--help` flag works
+- [ ] Documented in CLI help
+
+```markdown
+### Article II: CLI Interface Mandate
+
+**Status**: ✅ PASS / ❌ FAIL
+
+**Evidence**:
+- CLI: `npx musubix {{feature}}`
+- Help: `npx musubix {{feature}} --help`
+- Registered: packages/core/src/cli/index.ts
+```
+
+---
+
+#### Article III: Test-First Imperative
+
+**Requirement**: Tests before implementation (Red-Green-Blue)
+
+**Validation**:
+- [ ] Tests in `packages/core/__tests__/unit/`
+- [ ] Tests cover all requirements
+- [ ] Coverage ≥ 80%
+
+```bash
+npm run test:coverage
+```
+
+```markdown
+### Article III: Test-First Imperative
+
+**Status**: ✅ PASS / ❌ FAIL
+
+**Coverage**: XX%
+**Test Files**:
+- packages/core/__tests__/unit/{{feature}}.test.ts
+- packages/core/__tests__/integration/{{feature}}.integration.test.ts
+```
+
+---
+
+#### Article IV: EARS Requirements Format
+
+**Requirement**: All requirements in EARS format
+
+**Validation**:
+- [ ] All requirements use EARS patterns
+- [ ] Each has unique ID (REQ-XXX-NNN)
+- [ ] Each has acceptance criteria
+
+```markdown
+### Article IV: EARS Requirements Format
+
+**Status**: ✅ PASS / ❌ FAIL
+
+**Requirements Checked**: X
+**EARS Patterns Used**:
+- Ubiquitous: X
+- Event-driven: X
+- State-driven: X
+- Unwanted: X
+- Optional: X
+```
+
+---
+
+#### Article V: Traceability Mandate
+
+**Requirement**: 100% traceability REQ↔DES↔TSK↔CODE↔TEST
+
+**Validation**:
+
+```markdown
+### Article V: Traceability Mandate
+
+**Status**: ✅ PASS / ❌ FAIL
+
+**Traceability Matrix**:
+
+| Requirement | Design | Task | Code | Test |
+|-------------|--------|------|------|------|
+| REQ-XXX-001 | DES-XXX-001 | TSK-XXX-001 | {{feature}}/service.ts | {{feature}}.test.ts |
+
+**Coverage**: 100%
+**Unmapped Requirements**: None
+```
+
+---
+
+#### Article VI: Project Memory (Steering)
+
+**Requirement**: Consult steering before decisions
+
+**Validation**:
+- [ ] Design references steering files
+- [ ] Tech stack matches `steering/tech.ja.md`
+- [ ] Architecture matches `steering/structure.ja.md`
+
+---
+
+#### Article VII: Design Patterns
+
+**Requirement**: Document pattern applications
+
+**Validation**:
+- [ ] Patterns documented in design
+- [ ] ADRs created for decisions
+
+---
+
+#### Article VIII: Decision Records
+
+**Requirement**: All decisions as ADRs
+
+**Validation**:
+- [ ] ADRs in design document
+- [ ] Each ADR has: Status, Context, Decision, Consequences
+
+---
+
+#### Article IX: Quality Gates
+
+**Requirement**: Validate before phase transitions
+
+**Validation**:
+- [ ] Requirements validated before design
+- [ ] Design validated before implementation
+- [ ] Tests pass before deployment
+
+---
+
+### 3. Generate Validation Report
+
+```markdown
+# Validation Report: {{FEATURE_NAME}}
+
+**Date**: {{DATE}}
+**Validator**: AI Agent
+
+## Summary
+
+| Article | Status | Score |
+|---------|--------|-------|
+| I. Library-First | ✅ | 100% |
+| II. CLI Interface | ✅ | 100% |
+| III. Test-First | ✅ | 85% |
+| IV. EARS Format | ✅ | 100% |
+| V. Traceability | ✅ | 100% |
+| VI. Project Memory | ✅ | 100% |
+| VII. Design Patterns | ✅ | 100% |
+| VIII. Decision Records | ✅ | 100% |
+| IX. Quality Gates | ✅ | 100% |
+
+**Overall Compliance**: ✅ PASS (97%)
+
+## Test Coverage
+
+- Unit Tests: XX%
+- Integration Tests: XX%
+- Total: XX%
+
+## Traceability Coverage
+
+- Requirements → Design: 100%
+- Design → Tasks: 100%
+- Tasks → Code: 100%
+- Code → Tests: 100%
+
+## Issues Found
+
+### Critical (P0)
+None
+
+### High (P1)
+None
+
+### Medium (P2)
+- [Issue description]
+
+## Recommendations
+
+1. [Recommendation 1]
+2. [Recommendation 2]
+```
+
+---
+
+### 4. MCP Tool Integration
+
+Use MUSUBIX MCP tools:
+
+```
+sdd_validate_constitution - Validate constitutional compliance
+sdd_validate_traceability - Validate traceability matrix
+```
+
+---
+
+### 5. Validation Commands
+
+```bash
+# Run all validations
+npm test
+npm run typecheck
+npm run lint
+
+# Check coverage
+npm run test:coverage
+
+# Traceability
+npx musubix trace matrix
+npx musubix trace validate
+```
+
+---
+
+**MUSUBIX**: https://github.com/nahisaho/MUSUBIX
+**Version**: 1.0.0

package/.github/skills/build-fix/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: build-fix
+description: ビルドエラーを分析し、反復的に修正。TypeScript/ESLint/依存関係エラーに対応。
+license: MIT
+version: 1.1.0
+triggers:
+  - ビルドエラー発生
+  - /build-fix
+  - npm run build 失敗
+---
+
+# Build Fix
+
+> **要約**: ビルドエラーを自動分類し、反復的な修正戦略で段階的に解決。
+
+## 🔍 エラー分析 (REQ-BF-001)
+
+**WHEN** ビルドエラー発生  
+**DO** カテゴリ分類と優先度付け
+
+| カテゴリ | 例 | 優先度 |
+|---------|-----|--------|
+| **Type Error** | TS2322, TS2339 | 🔴 高 |
+| **Import Error** | Module not found | 🔴 高 |
+| **Syntax Error** | Unexpected token | 🔴 高 |
+| **Lint Error** | ESLint errors | 🟡 中 |
+| **Config Error** | tsconfig, webpack | 🟡 中 |
+| **Dependency** | Version mismatch | 🟢 低 |
+
+### 分析出力
+
+```
+🔍 Build Error Analysis
+━━━━━━━━━━━━━━━━━━━━━━
+Total: 8 errors
+
+By Category:
+  🔴 Type Error:   4 (High)
+  🔴 Import Error: 2 (High)
+  🟡 Lint Error:   2 (Medium)
+
+Root Cause:
+  1. src/user.ts:45 - Missing 'email' property
+     → Causes 2 downstream errors
+
+Fix Order:
+  1. src/user.ts:45 (root cause)
+  2. Remaining may resolve automatically
+```
+
+---
+
+## 🔄 修正ループ (REQ-BF-002)
+
+**WHILE** ビルドエラーが存在 (最大10回)  
+**DO** 以下のループを実行
+
+```
+1. エラーリスト取得
+   ↓
+2. Root Cause特定（影響範囲最大のエラー）
+   ↓
+3. 修正適用（1エラーに集中）
+   ↓
+4. ビルド再実行
+   ↓
+5. 結果確認
+   ↓
+エラーあり → 1へ戻る
+```
+
+### 優先順位
+
+1. **Root Cause First** - 連鎖エラーの根本原因
+2. **Import/Module First** - コンパイル阻害要因
+3. **Type Errors** - 下流エラーの原因
+4. **Syntax Errors** - 局所的だが致命的
+5. **Lint Errors** - 最後に対応
+
+---
+
+## 📋 TypeScriptエラーリファレンス
+
+| コード | 説明 | 解決策 |
+|--------|------|--------|
+| TS2322 | Type not assignable | 型の修正/アサーション |
+| TS2339 | Property not exist | プロパティ追加/型定義修正 |
+| TS2345 | Argument mismatch | 引数の型修正 |
+| TS2304 | Cannot find name | import追加/定義追加 |
+| TS2307 | Module not found | パス修正/インストール |
+| TS2531 | Possibly null | nullチェック追加 |
+
+---
+
+## 📊 Fix Report (REQ-BF-003)
+
+**WHEN** 修正完了  
+**DO** レポート生成
+
+```
+🔧 Build Fix Report
+━━━━━━━━━━━━━━━━━━━━━━━━
+Iterations: 2
+Errors Fixed: 8
+
+Changes:
+  • src/user.ts (+5 -2)
+  • tsconfig.json (+1 -0)
+
+Progress:
+  Iteration 1: 8 → 4 errors
+  Iteration 2: 4 → 0 errors
+
+Status: ✅ Build successful
+Remaining Warnings: 3
+```
+
+---
+
+## トレーサビリティ
+
+- REQ-BF-001: Build Error Analysis
+- REQ-BF-002: Iterative Fix Strategy
+- REQ-BF-003: Fix Report

package/.github/skills/checkpoint/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: checkpoint
+description: セーフポイントの作成・復元・比較。Gitと統合して状態を追跡。
+license: MIT
+version: 1.1.0
+triggers:
+  - /checkpoint
+  - 危険な操作前
+  - マイルストーン達成時
+---
+
+# Checkpoint
+
+> **要約**: 開発作業のセーフポイントを提供。作成・復元・比較をサポート。
+
+## 📌 コマンド
+
+### /checkpoint create (REQ-CP-001)
+
+**WHEN** `/checkpoint create <name>` 実行  
+**DO** 以下を順次実行
+
+1. Quick検証（`/verify quick`）
+2. Git commit/stash作成
+3. ログ記録
+
+```bash
+# 未コミット変更がある場合
+git stash push -m "checkpoint: <name>"
+# または
+git add -A && git commit -m "checkpoint: <name>"
+```
+
+**出力**:
+```
+📍 Checkpoint: <name>
+━━━━━━━━━━━━━━━━━━━━
+✅ Verification: PASS
+✅ Git: abc1234
+✅ Logged
+━━━━━━━━━━━━━━━━━━━━
+Time: 2026-01-25 14:30
+```
+
+---
+
+### /checkpoint verify (REQ-CP-002)
+
+**WHEN** `/checkpoint verify <name>` 実行  
+**DO** チェックポイントとの差分を報告
+
+| 項目 | 計算 |
+|------|------|
+| 変更ファイル数 | `git diff --stat <sha>..HEAD` |
+| テスト合格率 | 現在 vs チェックポイント時 |
+| カバレッジ | 現在 vs チェックポイント時 |
+| ビルド状態 | 現在のビルド結果 |
+
+**出力**:
+```
+📊 Verify: <name> (abc1234)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+| Metric   | Checkpoint | Current | Change |
+|----------|------------|---------|--------|
+| Tests    | 42/42      | 45/45   | +3 ✅  |
+| Coverage | 85%        | 87%     | +2% ✅ |
+| Build    | PASS       | PASS    | -      |
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Status: ✅ Quality maintained
+```
+
+---
+
+### /checkpoint list (REQ-CP-003)
+
+**WHEN** `/checkpoint list` 実行  
+**DO** 全チェックポイントを表示
+
+```
+📋 Checkpoints
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+| Name                    | Time       | SHA     |
+|-------------------------|------------|---------|
+| feature-auth-complete   | 01-25 14:30| abc1234 |
+| before-migration        | 01-25 10:00| def5678 |
+| fix-123-done            | 01-24 16:45| ghi9012 |
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+### /checkpoint restore (REQ-CP-004)
+
+**WHEN** `/checkpoint restore <name>` 実行  
+**DO** 安全に復元
+
+**復元前チェック**:
+- 未コミット変更 → stash/commit確認
+- 復元後 → `/verify quick` 提案
+
+---
+
+## 📁 Storage (REQ-CP-005)
+
+| パス | 内容 |
+|------|------|
+| `~/.musubix/checkpoints/checkpoints.log` | メタデータ |
+| 保持数 | 最新10件（超過時は古いものを整理） |
+
+**ログ形式**: `YYYY-MM-DD-HH:MM | <name> | <sha>`
+
+---
+
+## 🏷️ 命名規則
+
+| パターン | 例 |
+|---------|-----|
+| `feature-<name>-<state>` | `feature-auth-complete` |
+| `fix-<issue>-<state>` | `fix-123-done` |
+| `before-<action>` | `before-migration` |
+| `after-<action>` | `after-refactor` |
+
+---
+
+## トレーサビリティ
+
+- REQ-CP-001: Checkpoint Creation
+- REQ-CP-002: Checkpoint Verification
+- REQ-CP-003: Checkpoint Listing
+- REQ-CP-004: Checkpoint Restore
+- REQ-CP-005: Checkpoint Retention & Location

package/.github/skills/codemap/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: codemap
+description: リポジトリ構造を分析し、アーキテクチャドキュメントを自動生成。
+license: MIT
+version: 1.1.0
+triggers:
+  - /codemap
+  - /map
+  - アーキテクチャ可視化
+---
+
+# Codemap
+
+> **要約**: コードベースのアーキテクチャを分析し、構造化ドキュメントを自動生成。
+
+## 📌 コマンド
+
+| コマンド | 説明 |
+|---------|------|
+| `/codemap generate` | 全体マップ生成 |
+| `/codemap analyze <path>` | 特定パス分析 |
+| `/codemap diff` | 既存との差分表示 |
+
+---
+
+## 🔍 分析内容
+
+### REQ-CM-001: リポジトリ構造
+
+1. **ワークスペース検出**
+   ```bash
+   cat package.json | jq '.workspaces'
+   ```
+
+2. **エントリーポイント識別**
+   - `src/index.ts`, `src/main.ts`
+   - `bin/` 配下
+   - `package.json` の `main`, `exports`
+
+3. **フレームワーク検出**
+   - Next.js: `next.config.js`, `app/`
+   - Express: `app.ts`, `routes/`
+
+### REQ-CM-002: モジュール分析
+
+| 分析項目 | 検索方法 |
+|---------|---------|
+| エクスポート | `grep "^export" src/index.ts` |
+| インポート | `grep "from '" src/*.ts` |
+| APIルート | `ls pages/api/` or `grep router.` |
+| DBモデル | `grep "^model" prisma/schema.prisma` |
+
+---
+
+## 📁 出力構造 (REQ-CM-003)
+
+```
+docs/CODEMAPS/
+├── INDEX.md        # 全体概要
+├── packages.md     # パッケージ一覧
+├── backend.md      # バックエンド構造
+├── frontend.md     # フロントエンド構造
+├── database.md     # DBスキーマ
+└── integrations.md # 外部サービス
+```
+
+### INDEX.md テンプレート
+
+```markdown
+# Codemap: [Project Name]
+
+**Generated:** [日時]
+**Version:** [バージョン]
+
+## Overview
+[プロジェクト概要]
+
+## Structure
+[ディレクトリ構造]
+
+## Packages
+| Package | Description |
+|---------|-------------|
+| core | コア機能 |
+| api | APIサーバー |
+
+## Entry Points
+- `bin/cli.js` - CLI
+- `src/index.ts` - Library
+```
+
+---
+
+## 📊 Diff Threshold (REQ-CM-004)
+
+**WHEN** 既存マップ更新時  
+**DO** 差分率を計算し、30%超過時はユーザー承認
+
+**出力**:
+```
+📊 Codemap Diff
+━━━━━━━━━━━━━━
+Diff: 35% ⚠️
+New: 5 modules
+Removed: 2 modules
+Changed: 8 modules
+━━━━━━━━━━━━━━
+Update? (y/n)
+```
+
+**レポート保存**: `.reports/codemap-diff.txt`
+
+---
+
+## トレーサビリティ
+
+- REQ-CM-001: Repository Structure Analysis
+- REQ-CM-002: Module Analysis
+- REQ-CM-003: Codemap Generation
+- REQ-CM-004: Codemap Diff Threshold