musubix 3.4.1 → 3.4.3

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

@@ -1,255 +0,0 @@
-# MUSUBIX Tasks Command
-
-Break down design into actionable implementation tasks.
-
----
-
-## Instructions for AI Agent
-
-You are executing the `musubix tasks [feature-name]` command to create a task breakdown document.
-
-### Command Format
-
-```bash
-npx musubix tasks generate design.md
-```
-
-### Your Task
-
-Generate a comprehensive task breakdown that transforms the design into actionable implementation tasks with full requirements traceability.
-
----
-
-## Process
-
-### 1. Read Context
-
-**CRITICAL**: Read these files first:
-
-```bash
-# Design and Requirements
-storage/specs/DES-{{FEATURE}}-001.md
-storage/specs/REQ-{{FEATURE}}-001.md
-
-# Steering Context
-steering/structure.ja.md
-steering/tech.ja.md
-steering/product.ja.md
-```
-
----
-
-### 2. Verify Prerequisites
-
-**Check design file exists**:
-
-```markdown
-❌ **Error**: Design document not found
-
-Expected: storage/specs/DES-{{FEATURE}}-001.md
-
-Please run `npx musubix design generate` first.
-
-Tasks cannot be created without design (Article V: Traceability).
-```
-
----
-
-### 3. Generate Task Breakdown
-
-**Output**: `storage/specs/TSK-{{FEATURE}}-001.md`
-
-#### Task Structure
-
-```markdown
-### TSK-{{FEATURE}}-NNN: [Task Title]
-
-**Priority**: P0/P1/P2/P3
-**Story Points**: 1/2/3/5/8/13
-**Estimated Hours**: N
-**Status**: Not Started
-
-**Description**:
-[Clear description]
-
-**Requirements Coverage**:
-- REQ-{{COMPONENT}}-NNN: [Requirement title]
-
-**Package**: packages/core/ | packages/mcp-server/ | packages/yata-client/
-
-**Files to Create/Modify**:
-- `packages/core/src/{{feature}}/index.ts`
-- `packages/core/__tests__/unit/{{feature}}.test.ts`
-
-**Acceptance Criteria**:
-- [ ] [Criterion 1]
-- [ ] [Criterion 2]
-
-**Test-First Checklist** (Article III):
-- [ ] Tests written BEFORE implementation
-- [ ] Red: Failing test committed
-- [ ] Green: Minimal implementation passes
-- [ ] Blue: Refactored with confidence
-
-**Dependencies**:
-- TSK-{{FEATURE}}-NNN: [Dependency]
-```
-
----
-
-### 4. Task Categories (MUSUBIX-specific)
-
-**P0 Tasks (Critical)**:
-
-1. **TSK-001: Set Up Package Structure**
-   - Create in `packages/{{package}}/src/{{feature}}/`
-   - Follow Article I (Library-First)
-
-2. **TSK-002: Write Tests (RED)**
-   - Location: `packages/{{package}}/__tests__/unit/{{feature}}.test.ts`
-   - Test all acceptance criteria
-
-3. **TSK-003: Implement Code (GREEN)**
-   - Minimal implementation to pass tests
-   - Location: `packages/{{package}}/src/{{feature}}/`
-
-4. **TSK-004: Refactor (BLUE)**
-   - Improve design while tests pass
-   - Apply SOLID principles
-
-5. **TSK-005: Add CLI Command (Article II)**
-   - Location: `packages/core/src/cli/commands/{{feature}}.ts`
-   - Register in `packages/core/src/cli/index.ts`
-
-6. **TSK-006: Add MCP Tool (if needed)**
-   - Location: `packages/mcp-server/src/tools/{{feature}}-tools.ts`
-   - Register in `packages/mcp-server/src/server.ts`
-
-**P1 Tasks (High)**:
-
-7. **TSK-007: Integration Tests**
-   - Location: `packages/{{package}}/__tests__/integration/`
-
-8. **TSK-008: Documentation**
-   - Update `docs/USER-GUIDE.md`
-   - Update `docs/API-REFERENCE.md`
-
----
-
-### 5. Test-First Mandate (Article III)
-
-For EVERY implementation task, create 3 separate tasks:
-
-```markdown
-### TSK-002: Write Tests for REQ-{{COMPONENT}}-001 (RED) 🔴
-
-**Priority**: P0
-**Story Points**: 2
-
-**Description**:
-Write failing tests for requirement REQ-{{COMPONENT}}-001
-
-**Test File**: `packages/core/__tests__/unit/{{feature}}.test.ts`
-
-**Acceptance Criteria**:
-- [ ] Tests compile successfully
-- [ ] Tests FAIL (no implementation yet)
-- [ ] Tests cover all acceptance criteria
-
----
-
-### TSK-003: Implement REQ-{{COMPONENT}}-001 (GREEN) 💚
-
-**Priority**: P0
-**Story Points**: 3
-**Depends On**: TSK-002
-
-**Description**:
-Implement minimal code to pass tests
-
-**Acceptance Criteria**:
-- [ ] All tests from TSK-002 pass
-- [ ] No extra functionality added
-
----
-
-### TSK-004: Refactor REQ-{{COMPONENT}}-001 (BLUE) 💙
-
-**Priority**: P0
-**Story Points**: 2
-**Depends On**: TSK-003
-
-**Description**:
-Refactor while keeping tests green
-
-**Acceptance Criteria**:
-- [ ] All tests still pass
-- [ ] SOLID principles applied
-- [ ] Code quality improved
-```
-
----
-
-### 6. Task Document Template
-
-```markdown
-# Task Breakdown: {{FEATURE_NAME}}
-
-**Document ID**: TSK-{{FEATURE}}-001
-**Version**: 1.0.0
-**Date**: {{DATE}}
-**Design**: DES-{{FEATURE}}-001
-**Requirements**: REQ-{{FEATURE}}-001
-
-## Summary
-
-| Priority | Count | Story Points |
-|----------|-------|--------------|
-| P0 | X | XX |
-| P1 | X | XX |
-| Total | X | XX |
-
-## Sprint Plan
-
-### Sprint 1 (Week 1)
-- TSK-{{FEATURE}}-001: Setup
-- TSK-{{FEATURE}}-002: Tests (RED)
-- TSK-{{FEATURE}}-003: Implementation (GREEN)
-
-### Sprint 2 (Week 2)
-- TSK-{{FEATURE}}-004: Refactor (BLUE)
-- TSK-{{FEATURE}}-005: CLI Command
-
-## Task Details
-
-### TSK-{{FEATURE}}-001: [Title]
-...
-
-## Traceability Matrix
-
-| Task | Requirement | Design | Test |
-|------|-------------|--------|------|
-| TSK-001 | REQ-XXX-001 | DES-XXX-001 | xxx.test.ts |
-
-## Definition of Done
-
-- [ ] All tests pass
-- [ ] Code reviewed
-- [ ] Documentation updated
-- [ ] Traceability verified
-```
-
----
-
-### 7. MCP Tool Integration
-
-Use MUSUBIX MCP tools:
-
-```
-sdd_create_tasks - Generate tasks from design
-```
-
----
-
-**MUSUBIX**: https://github.com/nahisaho/MUSUBIX
-**Version**: 1.0.0

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

@@ -1,230 +0,0 @@
-# MUSUBIX Test Generation Command
-
-Generate comprehensive tests following Test-First (Red-Green-Blue) methodology.
-
----
-
-## Instructions for AI Agent
-
-You are executing the `musubix test [feature-name]` command to generate tests.
-
-### Command Format
-
-```bash
-npx musubix test generate <file>
-npx musubix test coverage <dir>
-```
-
-### Your Task
-
-Generate comprehensive tests following:
-
-1. Test-First (Red-Green-Blue) methodology
-2. EARS requirements coverage
-3. Result Type testing patterns
-4. Status transition testing
-
----
-
-## Process
-
-### 1. Read Requirements and Design
-
-```bash
-# Requirements (for test cases)
-storage/specs/REQ-{{FEATURE}}-001.md
-
-# Design (for component structure)
-storage/specs/DES-{{FEATURE}}-001.md
-
-# Existing implementation
-packages/core/src/{{feature}}/**/*.ts
-```
-
-### 2. Test Categories
-
-Generate tests for each category:
-
-| Category | Coverage Target | Priority |
-|----------|-----------------|----------|
-| Unit Tests | Functions, Value Objects | P0 |
-| Integration Tests | Services, Repositories | P0 |
-| E2E Tests | Full workflows | P1 |
-| Edge Cases | Boundary conditions | P0 |
-| Error Cases | Error handling | P0 |
-
-### 3. Test Structure
-
-```typescript
-import { describe, it, expect, beforeEach } from 'vitest';
-
-describe('FeatureName', () => {
-  beforeEach(() => {
-    // Reset counters for deterministic IDs
-    resetFeatureCounter();
-  });
-
-  describe('creation', () => {
-    it('should create valid entity', () => {
-      // Arrange
-      const input = { ... };
-      
-      // Act
-      const result = createEntity(input);
-      
-      // Assert
-      expect(result.isOk()).toBe(true);
-      if (result.isOk()) {
-        expect(result.value.id).toMatch(/^ENT-\d{8}-001$/);
-      }
-    });
-
-    it('should reject invalid input', () => {
-      // Arrange
-      const input = { invalid: true };
-      
-      // Act
-      const result = createEntity(input);
-      
-      // Assert
-      expect(result.isErr()).toBe(true);
-      if (result.isErr()) {
-        expect(result.error.message).toContain('validation');
-      }
-    });
-  });
-});
-```
-
-### 4. EARS Requirements Mapping
-
-Each requirement must have corresponding tests:
-
-```typescript
-/**
- * REQ-AUTH-001: WHEN user provides valid credentials,
- * THEN the system SHALL authenticate the user.
- */
-describe('REQ-AUTH-001: User Authentication', () => {
-  it('should authenticate user with valid credentials', async () => {
-    // Test implementation
-  });
-});
-```
-
-### 5. Result Type Test Patterns
-
-```typescript
-// ✅ Test both success and failure cases
-describe('createPrice', () => {
-  it('should create valid price', () => {
-    const result = createPrice(1000);
-    expect(result.isOk()).toBe(true);
-    if (result.isOk()) {
-      expect(result.value.amount).toBe(1000);
-    }
-  });
-
-  it('should reject price below minimum', () => {
-    const result = createPrice(50);
-    expect(result.isErr()).toBe(true);
-    if (result.isErr()) {
-      expect(result.error.message).toContain('100');
-    }
-  });
-});
-```
-
-### 6. Status Transition Testing
-
-```typescript
-describe('Status Transitions', () => {
-  const validTransitions: [Status, Status][] = [
-    ['draft', 'active'],
-    ['active', 'completed'],
-    ['active', 'cancelled'],
-  ];
-
-  const invalidTransitions: [Status, Status][] = [
-    ['completed', 'active'],
-    ['cancelled', 'draft'],
-  ];
-
-  validTransitions.forEach(([from, to]) => {
-    it(`should allow transition from ${from} to ${to}`, () => {
-      const entity = createEntityWithStatus(from);
-      const result = entity.transitionTo(to);
-      expect(result.isOk()).toBe(true);
-    });
-  });
-
-  invalidTransitions.forEach(([from, to]) => {
-    it(`should reject transition from ${from} to ${to}`, () => {
-      const entity = createEntityWithStatus(from);
-      const result = entity.transitionTo(to);
-      expect(result.isErr()).toBe(true);
-    });
-  });
-});
-```
-
----
-
-## Output Format
-
-```markdown
-# Test Generation Report: {{FEATURE}}
-
-## Summary
-- **Test Files Created**: X
-- **Test Cases**: X total (X unit, X integration, X e2e)
-- **Requirements Covered**: X/Y (Z%)
-
-## Generated Test Files
-
-### packages/core/__tests__/{{feature}}/entity.test.ts
-- X test cases
-- Covers: REQ-XXX-001, REQ-XXX-002
-
-### packages/core/__tests__/{{feature}}/service.test.ts
-- X test cases
-- Covers: REQ-XXX-003, REQ-XXX-004
-
-## Requirements Coverage Matrix
-
-| Requirement | Test File | Test Cases | Status |
-|-------------|-----------|------------|--------|
-| REQ-XXX-001 | entity.test.ts | 3 | ✅ |
-| REQ-XXX-002 | entity.test.ts | 2 | ✅ |
-| REQ-XXX-003 | service.test.ts | 4 | ✅ |
-
-## Run Tests
-
-\`\`\`bash
-npm run test -- packages/core/__tests__/{{feature}}/
-npm run test:coverage
-\`\`\`
-```
-
----
-
-## Traceability
-
-This skill implements:
-- **Article III**: Test-First Imperative (テスト先行開発)
-- **Article V**: Traceability Mandate (要件↔テストの追跡)
-
----
-
-## Related Commands
-
-```bash
-# Generate tests
-npx musubix test generate <file>
-
-# Run tests with coverage
-npm run test:coverage
-
-# Validate traceability
-npx musubix trace validate
-```