@nahisaho/shikigami 1.19.1 → 1.19.3

package/.github/prompts/sdd-change-apply.prompt.md

@@ -1,203 +1,59 @@
 # MUSUBIX Change Apply Command
 
-Apply a change proposal to the codebase.
+> 承認済み変更提案をコードベースに適用
 
 ---
 
-## Instructions for AI Agent
+## WHEN/DO トリガー
 
-You are executing the `musubix change apply [change-name]` command to implement an approved change proposal.
-
-### Command Format
-
-```bash
-npx musubix change apply add-2fa
-npx musubix change apply migrate-to-graphql
-```
-
-### Your Task
-
-Implement the changes defined in the change proposal, following constitutional governance.
-
----
-
-## Process
-
-### 1. Read Change Proposal
-
-**IMPORTANT**: Read the approved change proposal first:
-
-```bash
-storage/changes/{{CHANGE_NAME}}-proposal.md
-```
-
-**Extract**:
-
-- ADDED requirements
-- MODIFIED requirements
-- REMOVED requirements
-- Implementation plan
-
-**Verify Approval**:
-
-- Status must be "Approved" (not "Proposed")
-- If not approved, abort and notify user
+| WHEN | DO |
+|------|-----|
+| `npx musubix change apply <change-name>` 実行時 | 変更実装 |
+| 提案ステータスが"Proposed"の場合 | エラー→承認必要 |
 
 ---
 
-### 2. Read Steering Context (Article VI)
+## プロセス
 
-```bash
-steering/product.ja.md
-steering/structure.ja.md
-steering/tech.ja.md
-```
+| Step | Action | Output |
+|------|--------|--------|
+| 1 | 変更提案読込 | Status: Approved確認 |
+| 2 | Feature branch作成 | `feature/{{CHANGE}}` |
+| 3 | 要件更新 | ADDED/MODIFIED/REMOVED適用 |
+| 4 | 設計更新 | DESファイル更新 |
+| 5 | Test-First実装（Article III） | 🔴→💚→💙 |
+| 6 | 検証 | テスト・型・Lint |
+| 7 | レポート生成 | `{{CHANGE}}-implementation.md` |
 
 ---
 
-### 3. Execute Implementation Plan
-
-Follow the phases defined in the change proposal:
-
-#### Phase 1: Preparation
-
-```bash
-# Create feature branch
-git checkout -b feature/{{CHANGE_NAME}}
-
-# Create implementation tracking document
-touch storage/changes/{{CHANGE_NAME}}-implementation.md
-```
-
-#### Phase 2: Update Requirements
-
-For ADDED requirements:
-- Create new requirement files in `storage/specs/`
-
-For MODIFIED requirements:
-- Update existing requirement files
-- Mark version change
-
-For REMOVED requirements:
-- Archive to `storage/archive/`
-- Update traceability
-
-#### Phase 3: Update Design
-
-- Update `storage/specs/DES-*.md` files
-- Add new ADRs for significant changes
-
-#### Phase 4: Implement Code
-
-Follow Test-First (Article III):
-
-1. **Write Tests (RED)**
-   ```typescript
-   // packages/core/__tests__/unit/{{feature}}.test.ts
-   describe('REQ-{{COMPONENT}}-NEW-001: [New Feature]', () => {
-     it('should [new behavior]', () => {
-       // Test new functionality
-     });
-   });
-   ```
-
-2. **Implement (GREEN)**
-   ```typescript
-   // packages/core/src/{{feature}}/service.ts
-   // Minimal implementation to pass tests
-   ```
+## 前提条件チェック
 
-3. **Refactor (BLUE)**
-   - Improve design
-   - Ensure tests still pass
+| Check | Required |
+|-------|----------|
+| 提案ファイル存在 | `storage/changes/{{CHANGE}}-proposal.md` |
+| ステータス | "Approved" |
+| 影響分析完了 | Breaking Changes把握 |
 
 ---
 
-### 4. Feature Flag (Optional)
-
-For gradual rollout:
+## Feature Flag（段階的ロールアウト用）
 
 ```typescript
-// packages/core/src/config/feature-flags.ts
-
+// config/feature-flags.ts
 export const FEATURE_FLAGS = {
-  enable_{{feature}}: {
-    enabled: false,  // Start disabled
-    description: '{{CHANGE_DESCRIPTION}}',
-  },
-} as const;
-```
-
-```typescript
-// Usage in code
-import { FEATURE_FLAGS } from '../config/feature-flags.js';
-
-if (FEATURE_FLAGS.enable_{{feature}}.enabled) {
-  // New implementation
-} else {
-  // Old implementation
-}
-```
-
----
-
-### 5. Update CLI (Article II)
-
-If CLI changes:
-
-```typescript
-// packages/core/src/cli/commands/{{feature}}.ts
-
-export function register{{Feature}}Command(program: Command): void {
-  program
-    .command('{{feature}}')
-    .description('{{New/Updated description}}')
-    .option('--new-option', 'New option from change')
-    .action(async (options) => {
-      // Updated implementation
-    });
-}
-```
-
----
-
-### 6. Update MCP Tools
-
-If MCP tools change:
-
-```typescript
-// packages/mcp-server/src/tools/{{feature}}-tools.ts
-
-export const {{feature}}Tool: ToolDefinition = {
-  name: 'sdd_{{feature}}',
-  description: '{{Updated description}}',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      // Updated schema
-      newProperty: {
-        type: 'string',
-        description: 'New property from change',
-      },
-    },
-  },
-  handler: async (args) => {
-    // Updated implementation
-  },
+  enable_{{feature}}: { enabled: false, description: '...' },
 };
 ```
 
 ---
 
-### 7. Generate Implementation Report
-
-**Output**: `storage/changes/{{CHANGE_NAME}}-implementation.md`
+## 出力テンプレート
 
 ```markdown
 # Implementation Report: {{CHANGE_NAME}}
 
-**Date**: {{DATE}}
-**Status**: In Progress / Completed
+**Date**: {{DATE}} | **Status**: In Progress/Completed
 
 ## Summary
 
@@ -207,77 +63,46 @@ export const {{feature}}Tool: ToolDefinition = {
 | Design Updated | ✅ |
 | Tests Written | ✅ |
 | Code Implemented | ✅ |
-| Documentation Updated | ⏳ |
+| Documentation | ⏳ |
 
 ## Changes Made
 
 ### Files Created
-
-- `packages/core/src/{{feature}}/new-module.ts`
-- `packages/core/__tests__/unit/new-module.test.ts`
+- `packages/core/src/{{feature}}/new.ts`
 
 ### Files Modified
-
 - `packages/core/src/{{feature}}/service.ts`
-- `packages/mcp-server/src/tools/{{feature}}-tools.ts`
 
 ### Files Deleted
-
 - `packages/core/src/{{feature}}/deprecated.ts`
 
 ## Test Results
+Tests: X passed | Coverage: XX%
 
-\`\`\`
-npm test
-
-✓ packages/core/__tests__/unit/{{feature}}.test.ts (10 tests)
-✓ packages/core/__tests__/integration/{{feature}}.integration.test.ts (5 tests)
-
-Test Suites: 2 passed
-Tests: 15 passed
-Coverage: 87%
-\`\`\`
-
-## Traceability Verification
+## Traceability
 
 | Requirement | Design | Code | Test |
 |-------------|--------|------|------|
 | REQ-XXX-NEW-001 | DES-XXX-001 | ✅ | ✅ |
-| REQ-XXX-001 (mod) | DES-XXX-001 | ✅ | ✅ |
-
-## Deployment Notes
-
-1. Run migrations (if any)
-2. Enable feature flag
-3. Monitor metrics
-
-## Rollback Instructions
-
-1. Disable feature flag
-2. Revert to previous release
 ```
 
 ---
 
-### 8. Validation
-
-Run all validations:
+## 検証コマンド
 
 ```bash
-# Tests
-npm test
-
-# Type check
-npm run typecheck
-
-# Lint
-npm run lint
-
-# Traceability
-npx musubix trace validate
+npm test                    # テスト
+npm run typecheck           # 型チェック
+npm run lint                # Lint
+npx musubix trace validate  # トレーサビリティ
 ```
 
 ---
 
-**MUSUBIX**: https://github.com/nahisaho/MUSUBIX
-**Version**: 1.0.0
+## Quality Checklist
+
+- [ ] Proposal status is "Approved"
+- [ ] Feature branch created
+- [ ] Test-First followed (Article III)
+- [ ] All tests pass
+- [ ] Traceability maintained (Article V)

package/.github/prompts/sdd-change-archive.prompt.md

@@ -1,241 +1,99 @@
 # MUSUBIX Change Archive Command
 
-Archive a completed change proposal.
+> 完了した変更提案をアーカイブ
 
 ---
 
-## Instructions for AI Agent
+## WHEN/DO トリガー
 
-You are executing the `musubix change archive [change-name]` command to archive a completed change.
-
-### Command Format
-
-```bash
-npx musubix change archive add-2fa
-npx musubix change archive migrate-to-graphql
-```
-
-### Your Task
-
-Archive the change proposal and implementation, update documentation, and clean up.
-
----
-
-## Process
-
-### 1. Verify Change Completion
-
-**Read Implementation Report**:
-
-```bash
-storage/changes/{{CHANGE_NAME}}-implementation.md
-```
-
-**Verify Status**:
-
-- [ ] Implementation report exists
-- [ ] All requirements implemented
-- [ ] Tests passing
-- [ ] Feature flag enabled (or deprecated feature removed)
-
-**If Not Complete**:
-
-```markdown
-⚠️ **Change not ready for archival**
-
-Status Check:
-- [ ] Implementation complete
-- [ ] Tests passing
-- [ ] Deployed
-- [ ] Stable period passed
-
-Please complete all steps before archiving.
-```
-
----
-
-### 2. Collect Final Metrics
-
-```markdown
-## Final Metrics: {{CHANGE_NAME}}
-
-### Test Results
-
-- Unit Tests: XX passed
-- Integration Tests: XX passed
-- Coverage: XX%
-
-### Code Quality
-
-- Lint: ✅ No errors
-- TypeScript: ✅ No errors
-
-### Traceability
-
-- Requirements Coverage: 100%
-- Design Coverage: 100%
-- Test Coverage: XX%
-```
-
----
-
-### 3. Archive Documents
-
-Move change documents to archive:
-
-```bash
-# Create archive directory
-mkdir -p storage/archive/changes/{{CHANGE_NAME}}
-
-# Move change documents
-mv storage/changes/{{CHANGE_NAME}}-proposal.md storage/archive/changes/{{CHANGE_NAME}}/
-mv storage/changes/{{CHANGE_NAME}}-implementation.md storage/archive/changes/{{CHANGE_NAME}}/
-```
+| WHEN | DO |
+|------|-----|
+| `npx musubix change archive <change-name>` 実行時 | アーカイブ実行 |
+| 実装レポートが未完了の場合 | エラー→完了待ち |
 
 ---
 
-### 4. Update Main Documentation
+## プロセス
 
-**Update Traceability Matrix**:
-
-Add entries to `storage/traceability/`:
-
-```markdown
-## Change: {{CHANGE_NAME}}
-
-**Archived**: {{DATE}}
-
-| Requirement | Design | Task | Code | Test |
-|-------------|--------|------|------|------|
-| REQ-XXX-NEW-001 | DES-XXX-001 | TSK-XXX-001 | service.ts | service.test.ts |
-```
-
-**Update CHANGELOG.md**:
-
-```markdown
-## [1.x.x] - {{DATE}}
-
-### Added
-- {{Feature description}} (CHG-{{CHANGE}}-001)
-
-### Changed
-- {{Modified feature}} (CHG-{{CHANGE}}-001)
-
-### Removed
-- {{Deprecated feature}} (CHG-{{CHANGE}}-001)
-```
+| Step | Action | Output |
+|------|--------|--------|
+| 1 | 完了状態確認 | Implementation Report検証 |
+| 2 | 最終メトリクス収集 | テスト・カバレッジ |
+| 3 | ドキュメント移動 | `storage/archive/changes/{{CHANGE}}/` |
+| 4 | CHANGELOG更新 | Added/Changed/Removed |
+| 5 | Feature Flag削除（該当時） | コードクリーンアップ |
+| 6 | サマリ生成 | SUMMARY.md |
 
 ---
 
-### 5. Remove Feature Flags (if applicable)
+## 完了チェックリスト
 
-If feature flag was used:
-
-```typescript
-// packages/core/src/config/feature-flags.ts
-
-// REMOVE:
-// enable_{{feature}}: {
-//   enabled: true,
-//   description: '{{CHANGE_DESCRIPTION}}',
-// },
-
-// Update code to remove flag checks
-```
+| Check | Required |
+|-------|----------|
+| Implementation report存在 | ✅ |
+| 全要件実装済み | ✅ |
+| テスト全パス | ✅ |
+| デプロイ完了 | ✅ |
+| 安定期間経過 | ✅ |
 
 ---
 
-### 6. Generate Archive Summary
-
-**Output**: `storage/archive/changes/{{CHANGE_NAME}}/SUMMARY.md`
+## 出力テンプレート
 
 ```markdown
-# Change Archive Summary: {{CHANGE_NAME}}
+# Archive Summary: {{CHANGE_NAME}}
 
-**Document ID**: CHG-{{CHANGE}}-001
-**Archived**: {{DATE}}
+**ID**: CHG-{{CHANGE}}-001 | **Archived**: {{DATE}}
 **Duration**: X weeks
 
-## Overview
-
-**Change Type**: Feature / Enhancement / Refactor
-**Packages Affected**: packages/core/, packages/mcp-server/
-
 ## Final State
 
 ### Requirements
-
 | ID | Title | Status |
 |----|-------|--------|
-| REQ-XXX-NEW-001 | [New Feature] | Implemented |
-| REQ-XXX-001 | [Modified Feature] | Updated |
-
-### Files Changed
-
-**Created**: X files
-**Modified**: X files
-**Deleted**: X files
+| REQ-XXX-NEW-001 | [Title] | Implemented |
 
-### Test Coverage
+### Metrics
+- Tests: XX passed
+- Coverage: XX%
+- Lint: ✅
 
-- Before: XX%
-- After: XX%
+## Files Changed
+**Created**: X | **Modified**: X | **Deleted**: X
 
 ## Documents Archived
-
-1. {{CHANGE_NAME}}-proposal.md
-2. {{CHANGE_NAME}}-implementation.md
-3. SUMMARY.md (this file)
+1. {{CHANGE}}-proposal.md
+2. {{CHANGE}}-implementation.md
+3. SUMMARY.md
 
 ## Lessons Learned
-
-1. [Lesson 1]
-2. [Lesson 2]
-
-## Related Changes
-
-- CHG-XXX-001: [Related change]
+1. [Lesson]
 ```
 
 ---
 
-### 7. Clean Up
+## クリーンアップ
 
 ```bash
-# Remove any temporary files
-rm -rf storage/changes/{{CHANGE_NAME}}-*.tmp
-
-# Verify archive is complete
-ls storage/archive/changes/{{CHANGE_NAME}}/
-# Expected:
-# - {{CHANGE_NAME}}-proposal.md
-# - {{CHANGE_NAME}}-implementation.md
-# - SUMMARY.md
+# アーカイブ移動
+mkdir -p storage/archive/changes/{{CHANGE}}
+mv storage/changes/{{CHANGE}}-*.md storage/archive/changes/{{CHANGE}}/
 
 # Git commit
-git add storage/archive/changes/{{CHANGE_NAME}}/
-git add storage/traceability/
-git add CHANGELOG.md
+git add storage/archive/ CHANGELOG.md
 git commit -m "chore: archive change CHG-{{CHANGE}}-001"
-```
-
----
-
-### 8. Final Verification
 
-```bash
-# Ensure no orphaned references
-grep -r "CHG-{{CHANGE}}-001" packages/
-# Should only find documentation references
-
-# Ensure tests still pass
-npm test
-
-# Ensure build succeeds
-npm run build
+# 検証
+npm test && npm run build
 ```
 
 ---
 
-**MUSUBIX**: https://github.com/nahisaho/MUSUBIX
-**Version**: 1.0.0
+## Quality Checklist
+
+- [ ] Implementation complete
+- [ ] All tests pass
+- [ ] Documents archived
+- [ ] CHANGELOG updated
+- [ ] Feature flags removed (if any)
+- [ ] No orphaned references