musubix 1.0.1 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "musubix",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Neuro-Symbolic AI Coding System - MUSUBI × YATA Integration",
   "type": "module",
   "workspaces": [
@@ -13,8 +13,14 @@
   "files": [
     "packages/*/dist",
     "packages/*/bin",
+    "AGENTS.md",
     "README.md",
-    "LICENSE"
+    "README.ja.md",
+    "LICENSE",
+    "docs/",
+    "steering/",
+    "templates/",
+    ".github/"
   ],
   "scripts": {
     "build": "npm run build --workspaces --if-present",
@@ -55,9 +61,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.25.1",
-    "@nahisaho/musubix-core": "^1.0.0",
-    "@nahisaho/musubix-mcp-server": "^1.0.0",
-    "@nahisaho/musubix-yata-client": "^1.0.0",
-    "musubix": "^1.0.0"
+    "@nahisaho/musubix-core": "^1.0.2",
+    "@nahisaho/musubix-mcp-server": "^1.0.2",
+    "@nahisaho/musubix-yata-client": "^1.0.2"
   }
 }

package/steering/.musubi-version

@@ -0,0 +1 @@
+6.2.1

package/steering/product.ja.md

@@ -0,0 +1,572 @@
+# Product Context
+
+**Project**: MUSUBIX
+**Last Updated**: 2026-01-01
+**Version**: 1.0
+
+---
+
+## Product Vision
+
+**Vision Statement**: {{VISION_STATEMENT}}
+
+> [1-2 paragraph description of what this product aims to achieve and why it exists]
+
+**Mission**: {{MISSION_STATEMENT}}
+
+> [How the product achieves its vision]
+
+---
+
+## Product Overview
+
+### What is MUSUBIX?
+
+A software project using MUSUBI SDD
+
+> [2-3 paragraphs explaining the product, its purpose, and core value proposition]
+
+### Problem Statement
+
+**Problem**: {{PROBLEM_STATEMENT}}
+
+> [What problem does this product solve? What pain points does it address?]
+
+### Solution
+
+**Solution**: {{SOLUTION_STATEMENT}}
+
+> [How does this product solve the problem? What makes it unique?]
+
+---
+
+## Target Users
+
+### Primary Users
+
+#### User Persona 1: {{PERSONA_1_NAME}}
+
+**Demographics**:
+
+- **Role**: {{ROLE}}
+- **Organization Size**: {{ORG_SIZE}}
+- **Technical Level**: {{TECH_LEVEL}}
+
+**Goals**:
+
+- [Goal 1]
+- [Goal 2]
+- [Goal 3]
+
+**Pain Points**:
+
+- [Pain point 1]
+- [Pain point 2]
+- [Pain point 3]
+
+**Use Cases**:
+
+- [Use case 1]
+- [Use case 2]
+- [Use case 3]
+
+---
+
+#### User Persona 2: {{PERSONA_2_NAME}}
+
+**Demographics**:
+
+- **Role**: {{ROLE}}
+- **Organization Size**: {{ORG_SIZE}}
+- **Technical Level**: {{TECH_LEVEL}}
+
+**Goals**:
+
+- [Goal 1]
+- [Goal 2]
+
+**Pain Points**:
+
+- [Pain point 1]
+- [Pain point 2]
+
+**Use Cases**:
+
+- [Use case 1]
+- [Use case 2]
+
+---
+
+### Secondary Users
+
+- **{{SECONDARY_USER_1}}**: [Description and role]
+- **{{SECONDARY_USER_2}}**: [Description and role]
+
+---
+
+## Market & Business Context
+
+### Market Opportunity
+
+**Market Size**: {{MARKET_SIZE}}
+
+**Target Market**: {{TARGET_MARKET}}
+
+> [Description of the market opportunity, competitive landscape, and positioning]
+
+### Business Model
+
+**Revenue Model**: {{REVENUE_MODEL}}
+
+> Examples: SaaS subscription, One-time purchase, Freemium, Usage-based
+
+**Pricing Tiers** (if applicable):
+
+- **Free Tier**: [Features, limitations]
+- **Pro Tier**: ${{PRICE}}/month - [Features]
+- **Enterprise Tier**: Custom pricing - [Features]
+
+### Competitive Landscape
+
+| Competitor       | Strengths   | Weaknesses   | Our Differentiation   |
+| ---------------- | ----------- | ------------ | --------------------- |
+| {{COMPETITOR_1}} | [Strengths] | [Weaknesses] | [How we're different] |
+| {{COMPETITOR_2}} | [Strengths] | [Weaknesses] | [How we're different] |
+
+---
+
+## Core Product Capabilities
+
+### Must-Have Features (MVP)
+
+1. **{{FEATURE_1}}**
+   - **Description**: [What it does]
+   - **User Value**: [Why users need it]
+   - **Priority**: P0 (Critical)
+
+2. **{{FEATURE_2}}**
+   - **Description**: [What it does]
+   - **User Value**: [Why users need it]
+   - **Priority**: P0 (Critical)
+
+3. **{{FEATURE_3}}**
+   - **Description**: [What it does]
+   - **User Value**: [Why users need it]
+   - **Priority**: P0 (Critical)
+
+### High-Priority Features (Post-MVP)
+
+4. **{{FEATURE_4}}**
+   - **Description**: [What it does]
+   - **User Value**: [Why users need it]
+   - **Priority**: P1 (High)
+
+5. **{{FEATURE_5}}**
+   - **Description**: [What it does]
+   - **User Value**: [Why users need it]
+   - **Priority**: P1 (High)
+
+### Future Features (Roadmap)
+
+6. **{{FEATURE_6}}**
+   - **Description**: [What it does]
+   - **User Value**: [Why users need it]
+   - **Priority**: P2 (Medium)
+
+7. **{{FEATURE_7}}**
+   - **Description**: [What it does]
+   - **User Value**: [Why users need it]
+   - **Priority**: P3 (Low)
+
+---
+
+## Product Principles
+
+### Design Principles
+
+1. **{{PRINCIPLE_1}}**
+   - [Description of what this means for product decisions]
+
+2. **{{PRINCIPLE_2}}**
+   - [Description]
+
+3. **{{PRINCIPLE_3}}**
+   - [Description]
+
+**Examples**:
+
+- **Simplicity First**: Favor simple solutions over complex ones
+- **User Empowerment**: Give users control and flexibility
+- **Speed & Performance**: Fast response times (< 200ms)
+
+### User Experience Principles
+
+1. **{{UX_PRINCIPLE_1}}**
+   - [How this guides UX decisions]
+
+2. **{{UX_PRINCIPLE_2}}**
+   - [How this guides UX decisions]
+
+**Examples**:
+
+- **Progressive Disclosure**: Show advanced features only when needed
+- **Accessibility First**: WCAG 2.1 AA compliance
+- **Mobile-First**: Design for mobile, enhance for desktop
+
+---
+
+## Success Metrics
+
+### Key Performance Indicators (KPIs)
+
+#### Business Metrics
+
+| Metric                              | Target            | Measurement    |
+| ----------------------------------- | ----------------- | -------------- |
+| **Monthly Active Users (MAU)**      | {{MAU_TARGET}}    | [How measured] |
+| **Monthly Recurring Revenue (MRR)** | ${{MRR_TARGET}}   | [How measured] |
+| **Customer Acquisition Cost (CAC)** | ${{CAC_TARGET}}   | [How measured] |
+| **Customer Lifetime Value (LTV)**   | ${{LTV_TARGET}}   | [How measured] |
+| **Churn Rate**                      | < {{CHURN_RATE}}% | [How measured] |
+
+#### Product Metrics
+
+| Metric                       | Target                | Measurement    |
+| ---------------------------- | --------------------- | -------------- |
+| **Daily Active Users (DAU)** | {{DAU_TARGET}}        | [How measured] |
+| **Feature Adoption Rate**    | > {{ADOPTION_RATE}}%  | [How measured] |
+| **User Retention (Day 7)**   | > {{RETENTION_RATE}}% | [How measured] |
+| **Net Promoter Score (NPS)** | > {{NPS_TARGET}}      | [How measured] |
+
+#### Technical Metrics
+
+| Metric                      | Target  | Measurement             |
+| --------------------------- | ------- | ----------------------- |
+| **API Response Time (p95)** | < 200ms | Monitoring dashboard    |
+| **Uptime**                  | 99.9%   | Status page             |
+| **Error Rate**              | < 0.1%  | Error tracking (Sentry) |
+| **Page Load Time**          | < 2s    | Web vitals              |
+
+---
+
+## Product Roadmap
+
+### Phase 1: MVP (Months 1-3)
+
+**Goal**: Launch minimum viable product
+
+**Features**:
+
+- [Feature 1]
+- [Feature 2]
+- [Feature 3]
+
+**Success Criteria**:
+
+- [Criterion 1]
+- [Criterion 2]
+
+---
+
+### Phase 2: Growth (Months 4-6)
+
+**Goal**: Achieve product-market fit
+
+**Features**:
+
+- [Feature 4]
+- [Feature 5]
+- [Feature 6]
+
+**Success Criteria**:
+
+- [Criterion 1]
+- [Criterion 2]
+
+---
+
+### Phase 3: Scale (Months 7-12)
+
+**Goal**: Scale to {{USER_TARGET}} users
+
+**Features**:
+
+- [Feature 7]
+- [Feature 8]
+- [Feature 9]
+
+**Success Criteria**:
+
+- [Criterion 1]
+- [Criterion 2]
+
+---
+
+## User Workflows
+
+### Primary Workflow 1: {{WORKFLOW_1_NAME}}
+
+**User Goal**: {{USER_GOAL}}
+
+**Steps**:
+
+1. User [action 1]
+2. System [response 1]
+3. User [action 2]
+4. System [response 2]
+5. User achieves [goal]
+
+**Success Criteria**:
+
+- User completes workflow in < {{TIME}} minutes
+- Success rate > {{SUCCESS_RATE}}%
+
+---
+
+### Primary Workflow 2: {{WORKFLOW_2_NAME}}
+
+**User Goal**: {{USER_GOAL}}
+
+**Steps**:
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+**Success Criteria**:
+
+- [Criterion 1]
+- [Criterion 2]
+
+---
+
+## Business Domain
+
+### Domain Concepts
+
+Key concepts and terminology used in this domain:
+
+1. **{{CONCEPT_1}}**: [Definition and importance]
+2. **{{CONCEPT_2}}**: [Definition and importance]
+3. **{{CONCEPT_3}}**: [Definition and importance]
+
+**Example for SaaS Authentication**:
+
+- **Identity Provider (IdP)**: Service that authenticates users
+- **Single Sign-On (SSO)**: One login for multiple applications
+- **Multi-Factor Authentication (MFA)**: Additional verification step
+
+### Business Rules
+
+1. **{{RULE_1}}**
+   - [Description of business rule]
+   - **Example**: [Concrete example]
+
+2. **{{RULE_2}}**
+   - [Description]
+   - **Example**: [Example]
+
+**Example for E-commerce**:
+
+- **Inventory Reservation**: Reserved items held for 10 minutes during checkout
+- **Refund Window**: Refunds allowed within 30 days of purchase
+
+---
+
+## Constraints & Requirements
+
+### Business Constraints
+
+- **Budget**: ${{BUDGET}}
+- **Timeline**: {{TIMELINE}}
+- **Team Size**: {{TEAM_SIZE}} engineers
+- **Launch Date**: {{LAUNCH_DATE}}
+
+### Compliance Requirements
+
+- **{{COMPLIANCE_1}}**: [Description, e.g., GDPR, SOC 2, HIPAA]
+- **{{COMPLIANCE_2}}**: [Description]
+- **Data Residency**: [Requirements, e.g., EU data stays in EU]
+
+### Non-Functional Requirements
+
+- **Performance**: API response < 200ms (95th percentile)
+- **Availability**: 99.9% uptime SLA
+- **Scalability**: Support {{CONCURRENT_USERS}} concurrent users
+- **Security**: OWASP Top 10 compliance
+- **Accessibility**: WCAG 2.1 AA compliance
+
+---
+
+## Stakeholders
+
+### Internal Stakeholders
+
+| Role                    | Name                 | Responsibilities                  |
+| ----------------------- | -------------------- | --------------------------------- |
+| **Product Owner**       | {{PO_NAME}}          | Vision, roadmap, priorities       |
+| **Tech Lead**           | {{TECH_LEAD_NAME}}   | Architecture, technical decisions |
+| **Engineering Manager** | {{EM_NAME}}          | Team management, delivery         |
+| **QA Lead**             | {{QA_LEAD_NAME}}     | Quality assurance, testing        |
+| **Design Lead**         | {{DESIGN_LEAD_NAME}} | UX/UI design                      |
+
+### External Stakeholders
+
+| Role                        | Name        | Responsibilities            |
+| --------------------------- | ----------- | --------------------------- |
+| **Customer Advisory Board** | [Members]   | Product feedback            |
+| **Investors**               | [Names]     | Funding, strategic guidance |
+| **Partners**                | [Companies] | Integration, co-marketing   |
+
+---
+
+## Go-to-Market Strategy
+
+### Launch Strategy
+
+**Target Launch Date**: {{LAUNCH_DATE}}
+
+**Launch Phases**:
+
+1. **Private Beta** ({{START_DATE}} - {{END_DATE}})
+   - Invite-only, 50 beta users
+   - Focus: Gather feedback, fix critical bugs
+
+2. **Public Beta** ({{START_DATE}} - {{END_DATE}})
+   - Open signup
+   - Focus: Validate product-market fit
+
+3. **General Availability** ({{LAUNCH_DATE}})
+   - Full public launch
+   - Focus: Acquisition and growth
+
+### Marketing Channels
+
+- **{{CHANNEL_1}}**: [Strategy, e.g., Content marketing, SEO]
+- **{{CHANNEL_2}}**: [Strategy, e.g., Social media, Twitter/LinkedIn]
+- **{{CHANNEL_3}}**: [Strategy, e.g., Paid ads, Google/Facebook]
+- **{{CHANNEL_4}}**: [Strategy, e.g., Partnerships, integrations]
+
+---
+
+## Risk Assessment
+
+### Product Risks
+
+| Risk       | Probability     | Impact          | Mitigation            |
+| ---------- | --------------- | --------------- | --------------------- |
+| {{RISK_1}} | High/Medium/Low | High/Medium/Low | [Mitigation strategy] |
+| {{RISK_2}} | High/Medium/Low | High/Medium/Low | [Mitigation strategy] |
+
+**Example Risks**:
+
+- **Low adoption**: Users don't understand value → Clear onboarding, demos
+- **Performance issues**: System slow at scale → Load testing, optimization
+- **Security breach**: Data compromised → Security audit, penetration testing
+
+---
+
+## Customer Support
+
+### Support Channels
+
+- **Email**: support@{{COMPANY}}.com
+- **Chat**: In-app live chat (business hours)
+- **Documentation**: docs.{{COMPANY}}.com
+- **Community**: Forum/Discord/Slack
+
+### Support SLA
+
+| Tier              | Response Time | Resolution Time |
+| ----------------- | ------------- | --------------- |
+| **Critical (P0)** | < 1 hour      | < 4 hours       |
+| **High (P1)**     | < 4 hours     | < 24 hours      |
+| **Medium (P2)**   | < 24 hours    | < 3 days        |
+| **Low (P3)**      | < 48 hours    | Best effort     |
+
+---
+
+## Product Analytics
+
+### Analytics Tools
+
+- **{{ANALYTICS_TOOL_1}}**: [Purpose, e.g., Google Analytics, Mixpanel]
+- **{{ANALYTICS_TOOL_2}}**: [Purpose, e.g., Amplitude, Heap]
+
+### Events to Track
+
+| Event               | Description            | Purpose           |
+| ------------------- | ---------------------- | ----------------- |
+| `user_signup`       | New user registration  | Track acquisition |
+| `feature_used`      | User uses core feature | Track engagement  |
+| `payment_completed` | User completes payment | Track conversion  |
+| `error_occurred`    | User encounters error  | Track reliability |
+
+---
+
+## Localization & Internationalization
+
+### Supported Languages
+
+- **Primary**: English (en-US)
+- **Secondary**: [Languages, e.g., Japanese (ja-JP), Spanish (es-ES)]
+
+### Localization Strategy
+
+- **UI Strings**: i18n framework (next-intl, react-i18next)
+- **Date/Time**: Locale-aware formatting
+- **Currency**: Multi-currency support
+- **Right-to-Left (RTL)**: Support for Arabic, Hebrew (if needed)
+
+---
+
+## Data & Privacy
+
+### Data Collection
+
+**What data we collect**:
+
+- User account information (email, name)
+- Usage analytics (anonymized)
+- Error logs (for debugging)
+
+**What data we DON'T collect**:
+
+- [Sensitive data we avoid, e.g., passwords (only hashed), payment details (tokenized)]
+
+### Privacy Policy
+
+- **GDPR Compliance**: Right to access, delete, export data
+- **Data Retention**: [Retention period, e.g., 90 days for logs]
+- **Third-Party Sharing**: [Who we share data with, why]
+
+---
+
+## Integrations
+
+### Existing Integrations
+
+| Integration       | Purpose   | Priority |
+| ----------------- | --------- | -------- |
+| {{INTEGRATION_1}} | [Purpose] | P0       |
+| {{INTEGRATION_2}} | [Purpose] | P1       |
+
+### Planned Integrations
+
+| Integration       | Purpose   | Timeline |
+| ----------------- | --------- | -------- |
+| {{INTEGRATION_3}} | [Purpose] | Q2 2025  |
+| {{INTEGRATION_4}} | [Purpose] | Q3 2025  |
+
+---
+
+## Changelog
+
+### Version 1.1 (Planned)
+
+- [Future product updates]
+
+---
+
+**Last Updated**: 2026-01-01
+**Maintained By**: {{MAINTAINER}}

package/steering/project.yml

@@ -0,0 +1,38 @@
+# MUSUBI Project Configuration
+name: MUSUBIX
+description: A software project using MUSUBI SDD
+locale: ja
+version: "0.1.0"
+created: 2026-01-01
+
+# Technology Stack
+tech_stack:
+  approach: undecided
+  languages:
+    - undecided  # To be determined
+
+
+# Review Gate Settings (v6.2.0)
+reviewGate:
+  requirements:
+    earsCheck: true
+    stakeholderCoverage: true
+    acceptanceCriteriaRequired: true
+  design:
+    c4Required: ['context', 'container', 'component']
+    adrRequired: true
+    constitutionalArticles: [1, 2, 7, 8]
+  implementation:
+    minCoverage: 80
+    coverageType: 'line'
+    lintStrict: true
+
+# Traceability Settings (v6.2.0)
+traceability:
+  patterns:
+    - 'REQ-[A-Z0-9]+-\\d{3}'
+    - 'IMP-\\d+\\.\\d+-\\d{3}(?:-\\d{2})?'
+  extractFrom:
+    - 'src/**/*.{ts,js}'
+    - 'tests/**/*.test.{ts,js}'
+  outputPath: 'storage/traceability/matrix.yml'