musubix 3.6.1 → 3.7.3

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

@@ -1,212 +1,88 @@
 ---
 name: musubix-test-generation
-description: Guide for generating test code from designs and requirements. Use this when asked to create unit tests, integration tests, or test coverage analysis following TDD/BDD practices.
+description: テストコード生成ガイド。TDD/BDDによるユニット・統合テスト作成に使用。
 license: MIT
 ---
 
-# MUSUBIX Test Generation Skill
+# Test Generation Skill
 
-This skill guides you through generating comprehensive test suites that maintain traceability.
+**Article III - Test-First**: Red-Green-Blue TDDサイクルでテストを生成。
 
-## Overview
+## TDD Cycle
 
-MUSUBIX follows **Article III - Test-First**: Red-Green-Blue TDD cycle.
-
-```mermaid
-flowchart LR
-    RED[🔴 Red<br/>Failing Test] --> GREEN[🟢 Green<br/>Minimal Code]
-    GREEN --> BLUE[🔵 Blue<br/>Refactor]
-    BLUE --> RED
+```
+🔴 Red (Failing Test) → 🟢 Green (Minimal Code) → 🔵 Blue (Refactor)
 ```
 
-## Test Structure
+## Test Categories
 
-### Unit Test Template
+| カテゴリ | 目的 | 場所 |
+|---------|------|------|
+| Unit | 単一コンポーネント | `__tests__/unit/` |
+| Integration | 複数コンポーネント連携 | `__tests__/integration/` |
+| E2E | フルユーザーフロー | `__tests__/e2e/` |
 
-```typescript
-/**
- * @requirement REQ-XXX-NNN
- * @design DES-XXX-NNN
- */
-import { describe, it, expect, beforeEach } from 'vitest';
-import { XxxService } from './xxx-service.js';
-import { resetXxxCounter } from './xxx-entity.js';
+## WHEN → DO
 
-describe('XxxService', () => {
-  let service: XxxService;
-  let repository: MockXxxRepository;
+| WHEN | DO |
+|------|-----|
+| 機能実装前 | テストを先に書く（Red） |
+| テスト失敗 | 最小限のコードで通す（Green） |
+| テスト成功 | リファクタリング（Blue） |
 
-  beforeEach(() => {
-    // BP-TEST-001: Reset counters before each test
-    resetXxxCounter();
-    repository = new MockXxxRepository();
-    service = new XxxService(repository);
-  });
-
-  describe('create', () => {
-    it('should create entity with valid input', async () => {
-      // Arrange
-      const input = { name: 'Test', value: 100 };
-      
-      // Act
-      const result = await service.create(input);
-      
-      // Assert
-      expect(result.isOk()).toBe(true);
-      if (result.isOk()) {
-        expect(result.value.name).toBe('Test');
-      }
-    });
-
-    it('should return error for invalid input', async () => {
-      // Arrange
-      const input = { name: '', value: -1 };
-      
-      // Act
-      const result = await service.create(input);
-      
-      // Assert
-      expect(result.isErr()).toBe(true);
-    });
-  });
-});
-```
-
-### Integration Test Template
+## Test Template
 
 ```typescript
 /**
  * @requirement REQ-XXX-NNN
  * @design DES-XXX-NNN
  */
-import { describe, it, expect, beforeAll, afterAll } from 'vitest';
-
-describe('XxxService Integration', () => {
-  beforeAll(async () => {
-    // Setup test environment
+describe('XxxService', () => {
+  let service: XxxService;
+  
+  beforeEach(() => {
+    resetXxxCounter();  // BP-TEST-001
+    service = new XxxService(new MockRepository());
   });
 
-  afterAll(async () => {
-    // Cleanup
+  it('should create entity with valid input', async () => {
+    const result = await service.create({ name: 'Test' });
+    expect(result.isOk()).toBe(true);
   });
 
-  it('should complete full workflow', async () => {
-    // Test full user journey
+  it('should return error for invalid input', async () => {
+    const result = await service.create({ name: '' });
+    expect(result.isErr()).toBe(true);
   });
 });
 ```
 
-## Best Practices for Testing
-
-### BP-TEST-001: Test Counter Reset
-
-```typescript
-beforeEach(() => {
-  resetPetCounter();  // Reset ID counters
-  resetReservationCounter();
-});
-```
-
-### BP-TEST-002: Verify API Before Test
+## Best Practices
 
-```typescript
-// ✅ Check actual API signature first
-const service = new PetService(repository);
-// Verify method exists and parameters match
-```
+| ID | パターン | 内容 |
+|----|---------|------|
+| BP-TEST-001 | Counter Reset | beforeEachでIDカウンターリセット |
+| BP-TEST-004 | Result Type | isOk()/isErr()で両ケーステスト |
+| BP-TEST-005 | Status Transition | 有効・無効遷移を網羅 |
 
-### BP-TEST-004: Result Type Test Pattern
-
-```typescript
-// ✅ Test both success and failure cases
-it('should handle success', async () => {
-  const result = await service.create(validInput);
-  expect(result.isOk()).toBe(true);
-  if (result.isOk()) {
-    expect(result.value.id).toBeDefined();
-  }
-});
-
-it('should handle failure', async () => {
-  const result = await service.create(invalidInput);
-  expect(result.isErr()).toBe(true);
-  if (result.isErr()) {
-    expect(result.error.message).toContain('validation');
-  }
-});
-```
-
-### BP-TEST-005: Status Transition Testing
-
-```typescript
-describe('status transitions', () => {
-  // Valid transitions
-  it('should allow draft -> active', () => {
-    const result = workflow.transition('draft', 'activate');
-    expect(result).toBe('active');
-  });
-
-  // Invalid transitions
-  it('should reject completed -> draft', () => {
-    expect(() => workflow.transition('completed', 'revert'))
-      .toThrow('Invalid transition');
-  });
-});
-```
-
-## Test Categories
-
-| Category | Purpose | Location |
-|----------|---------|----------|
-| Unit | Single component | `__tests__/unit/` |
-| Integration | Multiple components | `__tests__/integration/` |
-| E2E | Full user flows | `__tests__/e2e/` |
-
-## CLI Commands
+## CLI
 
 ```bash
-# Generate tests from design
-npx musubix test generate storage/design/DES-XXX.md
-
-# Run all tests
-npm test
-
-# Coverage report
-npx musubix test coverage src/
-
-# Run specific test file
-npm test -- xxx.test.ts
+npx musubix test generate <design-file>  # テスト生成
+npm test                                  # 全テスト実行
+npx musubix test coverage src/            # カバレッジ計測
 ```
 
-## Vitest Configuration
+## 出力例
 
-```typescript
-// vitest.config.ts
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['**/*.test.ts'],
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'json', 'html'],
-    },
-  },
-});
 ```
-
-## Coverage Targets
-
-| Metric | Target |
-|--------|--------|
-| Line Coverage | ≥80% |
-| Branch Coverage | ≥75% |
-| Function Coverage | ≥90% |
-
-## Related Skills
-
-- `musubix-sdd-workflow` - Full SDD workflow with TDD
-- `musubix-code-generation` - Generate code to test
-- `musubix-traceability` - Link tests to requirements
+┌─────────────────────────────────────────┐
+│ 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

@@ -1,50 +1,40 @@
 ---
 name: musubix-traceability
-description: Guide for managing traceability between requirements, designs, code, and tests. Use this when asked to verify traceability, create traceability matrices, or perform impact analysis.
+description: 要件・設計・コード・テスト間のトレーサビリティ管理ガイド。影響分析・マトリクス作成に使用。
 license: MIT
 ---
 
-# MUSUBIX Traceability Skill
+# Traceability Skill
 
-This skill guides you through maintaining full traceability across the development lifecycle.
+**Article V - Traceability**: 100%双方向トレーサビリティを維持。
 
-## Overview
-
-MUSUBIX enforces **Article V - Traceability**: Complete bidirectional tracing between:
+## Traceability Chain
 
 ```
-Requirements (REQ-*) ↔ Design (DES-*) ↔ Tasks (TSK-*) ↔ Code ↔ Tests
+REQ-* ↔ DES-* ↔ TSK-* ↔ Code ↔ Tests
 ```
 
-## Traceability Matrix
+## WHEN → DO
 
-### Creating a Traceability Matrix
+| WHEN | DO |
+|------|-----|
+| 要件作成 | REQ-* IDを付与 |
+| 設計作成 | DES-* IDを付与、REQ-*に紐付け |
+| タスク作成 | TSK-* IDを付与、DES-*・REQ-*に紐付け |
+| コード作成 | @requirement, @design タグ追加 |
+| テスト作成 | @requirement, @design タグ追加 |
+| 要件変更 | 影響分析を実施 |
 
-```markdown
-# Traceability Matrix
+## Traceability Matrix
 
+```markdown
 | 要件ID | 設計ID | タスクID | コード | テスト |
 |--------|--------|---------|--------|--------|
-| REQ-AUTH-001 | DES-AUTH-001 | TSK-001 | src/auth/auth-service.ts | auth.test.ts |
-| REQ-AUTH-002 | DES-AUTH-001 | TSK-002 | src/auth/token-manager.ts | token.test.ts |
-```
-
-### CLI Commands
-
-```bash
-# Generate traceability matrix
-npx musubix trace matrix
-
-# Impact analysis for a specific requirement
-npx musubix trace impact REQ-AUTH-001
-
-# Validate all traceability links
-npx musubix trace validate
+| 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 |
 ```
 
-## Traceability in Code
-
-### Adding Traceability Comments
+## Code Traceability
 
 ```typescript
 /**
@@ -53,89 +43,52 @@ npx musubix trace validate
  * @design DES-AUTH-001
  * @task TSK-001
  */
-export class AuthService {
-  /**
-   * ユーザー認証
-   * @requirement REQ-AUTH-001
-   */
-  async authenticate(credentials: Credentials): Promise<Result<Token, AuthError>> {
-    // Implementation
-  }
-}
-```
-
-### Test Traceability
-
-```typescript
-/**
- * @requirement REQ-AUTH-001
- * @design DES-AUTH-001
- */
-describe('AuthService', () => {
-  describe('authenticate', () => {
-    it('should return token for valid credentials', async () => {
-      // Test implementation
-    });
-  });
-});
+export class AuthService { ... }
 ```
 
 ## Impact Analysis
 
-When a requirement changes, identify all affected artifacts:
-
-```mermaid
-flowchart LR
-    REQ[REQ-AUTH-001<br/>変更] --> DES[DES-AUTH-001<br/>設計]
-    DES --> TSK1[TSK-001<br/>タスク]
-    DES --> TSK2[TSK-002<br/>タスク]
-    TSK1 --> CODE1[auth-service.ts]
-    TSK2 --> CODE2[token-manager.ts]
-    CODE1 --> TEST1[auth.test.ts]
-    CODE2 --> TEST2[token.test.ts]
-```
-
-### Impact Analysis Steps
-
-1. Identify changed requirement (REQ-*)
-2. Find linked designs (DES-*)
-3. Find linked tasks (TSK-*)
-4. Locate affected code files
-5. Identify tests to update
-6. Update all artifacts
-
-## Traceability Storage
+要件変更時の影響範囲特定:
 
 ```
-storage/traceability/
-├── matrix.json           # Full traceability matrix
-├── requirements-map.json # REQ -> DES mappings
-├── design-map.json       # DES -> TSK mappings
-└── code-map.json         # TSK -> Code mappings
+REQ-AUTH-001 変更
+    ↓
+DES-AUTH-001 (設計)
+    ↓
+TSK-001, TSK-002 (タスク)
+    ↓
+auth-service.ts, token-manager.ts (コード)
+    ↓
+auth.test.ts, token.test.ts (テスト)
 ```
 
 ## Verification Checklist
 
-Before completing any feature:
+- [ ] 全要件に設計がリンク
+- [ ] 全設計にタスクがリンク
+- [ ] 全コードにトレーサビリティコメント
+- [ ] 全テストに@requirementタグ
 
-- [ ] All requirements have linked designs
-- [ ] All designs have linked tasks
-- [ ] All tasks have linked code
-- [ ] All code has linked tests
-- [ ] Traceability comments in code
-- [ ] Matrix updated
+## CLI
 
-## MCP Tool
+```bash
+npx musubix trace matrix           # マトリクス生成
+npx musubix trace impact REQ-*     # 影響分析
+npx musubix trace validate         # リンク検証
+npx musubix trace sync             # 自動更新
+```
 
-Use MCP tool for automated validation:
+## 出力例
 
 ```
-Tool: sdd_validate_traceability
-Description: Validates bidirectional traceability across all artifacts
+┌─────────────────────────────────────────┐
+│ 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%                      │
+└─────────────────────────────────────────┘
 ```
-
-## Related Skills
-
-- `musubix-sdd-workflow` - Full SDD workflow
-- `musubix-ears-validation` - Requirements validation
-- `musubix-test-generation` - Generate tests with traceability

package/.github/skills/refactor-cleaner/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: refactor-cleaner
+description: デッドコード検出・安全な削除。knip/depcheck/ts-pruneと連携。
+license: MIT
+version: 1.1.0
+triggers:
+  - /refactor
+  - /cleanup
+  - /deadcode
+---
+
+# Refactor Cleaner
+
+> **要約**: デッドコードを検出し、安全に削除。すべての削除操作をログに記録。
+
+## 📌 コマンド
+
+| コマンド | 説明 |
+|---------|------|
+| `/refactor analyze` | デッドコード検出 |
+| `/refactor clean [--safe-only]` | 安全な削除 |
+| `/refactor report` | レポート表示 |
+
+---
+
+## 🔍 検出ツール (REQ-RC-001)
+
+| ツール | 検出内容 | コマンド |
+|--------|---------|---------|
+| **knip** | 未使用ファイル/エクスポート/依存 | `npx knip` |
+| **depcheck** | 未使用npm依存 | `npx depcheck` |
+| **ts-prune** | 未使用TSエクスポート | `npx ts-prune` |
+
+---
+
+## ⚠️ 安全な削除 (REQ-RC-002)
+
+**BEFORE** 削除実行  
+**DO** 以下を検証
+
+| チェック | コマンド |
+|---------|---------|
+| 動的インポート | `grep -rn "import(" src/` |
+| テスト参照 | `grep -rn "<name>" tests/` |
+| ドキュメント参照 | `grep -rn "<name>" docs/` |
+
+**検出された場合**: 削除対象から除外
+
+---
+
+## 📊 リスク分類 (REQ-RC-004)
+
+| レベル | 説明 | アクション |
+|--------|------|----------|
+| 🟢 **SAFE** | 静的解析で参照なし | 自動削除可 |
+| 🟡 **CAUTION** | 動的参照の可能性 | 確認必要 |
+| 🔴 **DANGER** | 公開API/エントリーポイント | 自動削除禁止 |
+
+**出力例**:
+```
+🔍 Dead Code Analysis
+━━━━━━━━━━━━━━━━━━━━━━━━
+🟢 SAFE (5):
+  • src/utils/deprecated.ts
+  • src/helpers/old.ts
+
+🟡 CAUTION (2):
+  • src/lib/maybe-used.ts
+
+🔴 DANGER (1):
+  • src/index.ts (entry point)
+━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## 📝 Deletion Log (REQ-RC-003)
+
+**WHEN** コード削除  
+**DO** `docs/DELETION_LOG.md`に記録
+
+```markdown
+## [日付]
+
+### Deleted
+- `src/utils/deprecated.ts`
+- `src/helpers/old.ts`
+
+### Reason
+knip検出: 未使用エクスポート
+
+### Restore
+`git checkout abc1234 -- <file>`
+```
+
+**レポート保存**: `.reports/dead-code-analysis.md`
+
+---
+
+## トレーサビリティ
+
+- REQ-RC-001: Dead Code Detection
+- REQ-RC-002: Safe Deletion
+- REQ-RC-003: Deletion Log
+- REQ-RC-004: Risk Classification

package/.github/skills/session-manager/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: session-manager
+description: セッション開始時にコンテキスト復元、終了時に状態保存。TodoWrite統合でタスク追跡。
+license: MIT
+version: 1.1.0
+triggers:
+  - セッション開始
+  - セッション終了
+  - /session
+  - マルチステップタスク
+---
+
+# Session Manager
+
+> **要約**: セッション間の継続性を提供。開始時に過去コンテキストを復元、終了時に状態を永続化。
+
+## 🔄 トリガーと即時アクション
+
+### セッション開始時
+
+**WHEN** 新しいセッションが開始される  
+**DO** 以下を順に実行:
+
+1. `~/.musubix/sessions/` から過去7日間のファイルを検索
+2. 直近セッションの「Notes for Next Session」を読む
+3. ユーザーに引き継ぎ内容を通知
+
+```bash
+find ~/.musubix/sessions/ -name "*.md" -mtime -7 2>/dev/null | head -5
+```
+
+**出力フォーマット**:
+```
+📋 前回セッションからの引き継ぎ
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📅 日時: [YYYY-MM-DD HH:MM]
+📝 未完了: [タスクリスト]
+💡 メモ: [重要コンテキスト]
+📂 推奨ファイル: [パスリスト]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+続きから再開しますか？
+```
+
+---
+
+### セッション終了時
+
+**WHEN** セッション終了/長時間中断  
+**DO** 状態を `~/.musubix/sessions/YYYY-MM-DD-HH-MM.md` に保存
+
+**保存フォーマット**:
+```markdown
+# Session: [日付]
+**Project:** [名前] | **Started:** [HH:MM] | **Updated:** [HH:MM]
+
+## Completed
+- [x] 完了タスク
+
+## In Progress
+- [ ] 進行中タスク
+
+## Notes for Next Session
+- 重要コンテキスト
+
+## Context to Load
+- `path/to/file`
+```
+
+---
+
+### コンテキスト圧縮前
+
+**WHEN** コンテキスト圧縮がトリガーされる  
+**DO** 圧縮前に重要な状態をセッションファイルに追記
+
+**保存項目**: 現在のタスク状態、重要な変数/設定、次のアクション
+
+---
+
+## ✅ TodoWrite統合
+
+**WHEN** マルチステップタスク（3ステップ以上）を開始  
+**DO** TodoWriteツールで進捗を追跡
+
+### ベストプラクティス
+
+| やること | 理由 |
+|---------|------|
+| タスク開始時にリスト作成 | 実行順序を明示 |
+| 完了ごとにチェック | 進捗を可視化 |
+| 欠落ステップを検出 | 抜け漏れ防止 |
+| 終了時に未完了を記録 | 次回引き継ぎ |
+
+**例**:
+```
+□ 1. 要件定義の確認
+□ 2. 設計ドキュメント作成
+☑ 3. 実装（完了）
+□ 4. テスト作成
+□ 5. レビュー依頼
+```
+
+---
+
+## 📁 ストレージ
+
+| パス | 内容 |
+|------|------|
+| `~/.musubix/sessions/` | セッションファイル（30日保持） |
+| `~/.musubix/sessions/YYYY-MM-DD-HH-MM.md` | 個別セッション |
+
+---
+
+## トレーサビリティ
+
+- REQ-SM-001: SessionStart Hook
+- REQ-SM-002: SessionEnd Hook  
+- REQ-SM-003: Pre-Compact State Saving
+- REQ-SM-004: TodoWrite統合