musubix 1.0.1 → 1.0.2

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

@@ -0,0 +1,241 @@
+# MUSUBIX Change Archive Command
+
+Archive a completed change proposal.
+
+---
+
+## Instructions for AI Agent
+
+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}}/
+```
+
+---
+
+### 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)
+```
+
+---
+
+### 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
+```
+
+---
+
+### 6. Generate Archive Summary
+
+**Output**: `storage/archive/changes/{{CHANGE_NAME}}/SUMMARY.md`
+
+```markdown
+# Change Archive Summary: {{CHANGE_NAME}}
+
+**Document 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
+
+### Test Coverage
+
+- Before: XX%
+- After: XX%
+
+## Documents Archived
+
+1. {{CHANGE_NAME}}-proposal.md
+2. {{CHANGE_NAME}}-implementation.md
+3. SUMMARY.md (this file)
+
+## Lessons Learned
+
+1. [Lesson 1]
+2. [Lesson 2]
+
+## Related Changes
+
+- CHG-XXX-001: [Related change]
+```
+
+---
+
+### 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
+
+# Git commit
+git add storage/archive/changes/{{CHANGE_NAME}}/
+git add storage/traceability/
+git add 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
+```
+
+---
+
+**MUSUBIX**: https://github.com/nahisaho/MUSUBIX
+**Version**: 1.0.0

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

@@ -0,0 +1,269 @@
+# MUSUBIX Change Init Command
+
+Initialize a change proposal for brownfield projects (existing codebase).
+
+---
+
+## Instructions for AI Agent
+
+You are executing the `musubix change init [change-name]` command to create a change proposal for an existing codebase.
+
+### Command Format
+
+```bash
+npx musubix change init add-2fa
+npx musubix change init migrate-to-graphql
+npx musubix change init refactor-auth-service
+```
+
+### Your Task
+
+Generate a change proposal specification that documents what will be added, modified, or removed in the existing MUSUBIX system.
+
+---
+
+## Process
+
+### 1. Read Steering Context (Article VI)
+
+**IMPORTANT**: Before starting, read steering files:
+
+```bash
+steering/product.ja.md      # Current product context
+steering/structure.ja.md    # Existing architecture
+steering/tech.ja.md         # Current technology stack
+```
+
+---
+
+### 2. Analyze Existing System
+
+**Research Current Implementation**:
+
+```bash
+# Search for related code
+grep -r "{{related-feature}}" packages/
+
+# Find existing requirements
+ls storage/specs/REQ-*.md
+
+# Check existing design documents
+ls storage/specs/DES-*.md
+```
+
+**Document Current State**:
+
+- What exists now?
+- What packages are affected?
+- What dependencies exist?
+- What tests cover this area?
+
+---
+
+### 3. Gather Change Requirements
+
+**Ask User**:
+
+- Why is this change needed?
+- What problem does it solve?
+- What must NOT change (backward compatibility)?
+- What is the timeline?
+
+**Impact Analysis**:
+
+- [ ] packages/core/ components
+- [ ] packages/mcp-server/ tools
+- [ ] packages/yata-client/ integration
+- [ ] CLI commands
+- [ ] Tests
+- [ ] Documentation
+
+---
+
+### 4. Generate Change Proposal
+
+**Output**: `storage/changes/{{CHANGE_NAME}}-proposal.md`
+
+```markdown
+# Change Proposal: {{CHANGE_NAME}}
+
+**Document ID**: CHG-{{CHANGE}}-001
+**Version**: 1.0.0
+**Date**: {{DATE}}
+**Status**: Proposed
+
+## Summary
+
+**Change Type**: Feature / Enhancement / Refactor / Bug Fix
+**Affected Packages**: packages/core/, packages/mcp-server/
+**Risk Level**: Low / Medium / High
+
+## Motivation
+
+**Problem Statement**:
+[Why is this change needed?]
+
+**Business Value**:
+[What value does this provide?]
+
+## Current State
+
+### Existing Implementation
+
+| Component | Location | Description |
+|-----------|----------|-------------|
+| AuthService | packages/core/src/auth/ | Current auth implementation |
+
+### Existing Tests
+
+| Test File | Coverage |
+|-----------|----------|
+| auth.test.ts | 85% |
+
+## Proposed Changes
+
+### ADDED Requirements
+
+#### REQ-{{COMPONENT}}-NEW-001: [New Feature]
+
+> [EARS statement]
+
+**Priority**: P1
+**Acceptance Criteria**:
+- [ ] [Criterion 1]
+
+### MODIFIED Requirements
+
+#### REQ-{{COMPONENT}}-001: [Modified Feature]
+
+**Current**:
+> [Current EARS statement]
+
+**Proposed**:
+> [New EARS statement]
+
+**Change Reason**: [Why modify?]
+
+### REMOVED Requirements
+
+#### REQ-{{COMPONENT}}-OLD-001: [Deprecated Feature]
+
+**Reason**: [Why remove?]
+**Migration Path**: [How to migrate?]
+
+## Impact Analysis
+
+### Affected Components
+
+| Package | Component | Impact |
+|---------|-----------|--------|
+| core | auth/service.ts | Modified |
+| mcp-server | tools/auth-tools.ts | Modified |
+
+### Breaking Changes
+
+- [ ] CLI API changes
+- [ ] MCP tool changes
+- [ ] Type changes
+
+### Migration Requirements
+
+1. [Migration step 1]
+2. [Migration step 2]
+
+## Implementation Plan
+
+### Phase 1: Preparation
+
+- [ ] Create feature branch
+- [ ] Write tests for new requirements
+- [ ] Update documentation
+
+### Phase 2: Implementation
+
+- [ ] Implement changes
+- [ ] Update affected components
+- [ ] Add feature flag (if needed)
+
+### Phase 3: Validation
+
+- [ ] Run all tests
+- [ ] Validate traceability
+- [ ] Code review
+
+## Rollback Plan
+
+1. Revert feature flag
+2. Deploy previous version
+3. Restore database (if needed)
+
+## Approval
+
+| Role | Name | Date | Status |
+|------|------|------|--------|
+| Architect | | | Pending |
+| Lead Dev | | | Pending |
+```
+
+---
+
+### 5. Delta Specification
+
+For modifications, create delta spec:
+
+```markdown
+## Delta Specification
+
+### packages/core/src/auth/service.ts
+
+**Change Type**: Modified
+
+**Current Implementation**:
+\`\`\`typescript
+export class AuthService {
+  async login(email: string, password: string): Promise<Session> {
+    // Current implementation
+  }
+}
+\`\`\`
+
+**Proposed Implementation**:
+\`\`\`typescript
+export class AuthService {
+  async login(email: string, password: string, mfaCode?: string): Promise<Session> {
+    // New implementation with MFA support
+    if (this.config.mfaEnabled && !mfaCode) {
+      throw new MFARequiredError();
+    }
+  }
+}
+\`\`\`
+
+**Breaking Change**: Yes - New optional parameter
+**Migration**: Update all callers to handle MFARequiredError
+```
+
+---
+
+### 6. Traceability
+
+Link to existing documents:
+
+```markdown
+## Traceability
+
+### Related Requirements
+- REQ-AUTH-001: User authentication (MODIFIED)
+- REQ-AUTH-NEW-001: MFA support (ADDED)
+
+### Related Design
+- DES-AUTH-001: Authentication design (UPDATE REQUIRED)
+
+### Related Tasks
+- TSK-AUTH-001: Implement MFA (NEW)
+```
+
+---
+
+**MUSUBIX**: https://github.com/nahisaho/MUSUBIX
+**Version**: 1.0.0