musubix 2.4.1 → 2.4.2

package/steering/product.ja.md

@@ -1,572 +0,0 @@
-# Product Context
-
-**Project**: MUSUBIX
-**Last Updated**: 2026-01-04
-**Version**: 1.1.15
-
----
-
-## 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

@@ -1,66 +0,0 @@
-# MUSUBIX Project Configuration
-name: MUSUBIX
-description: Neuro-Symbolic AI Integration System - Neural (LLM) + Symbolic (YATA Knowledge Graph)
-locale: ja
-version: "1.1.15"
-created: 2026-01-01
-updated: 2026-01-04
-
-# Technology Stack
-tech_stack:
-  approach: monorepo
-  languages:
-    - TypeScript
-  runtime: Node.js >= 20.0.0
-  package_manager: npm >= 10.0.0
-  test_framework: Vitest
-  build_system: npm workspaces
-
-# Packages
-packages:
-  - name: "@nahisaho/musubix-core"
-    path: packages/core
-    description: Core library - CLI, EARS validation, code generation, design patterns
-  - name: "@nahisaho/musubix-mcp-server"
-    path: packages/mcp-server
-    description: MCP Server - 9 tools, 3 prompts
-  - name: "@nahisaho/musubix-yata-client"
-    path: packages/yata-client
-    description: YATA Client - Knowledge graph integration
-
-# Domain Support
-domains:
-  count: 62
-  components: ~430
-  categories:
-    - general (13 components)
-    - manufacturing, logistics, education (8 each)
-    - travel, telecom, sports, shipping, security, realestate, property, marketing, hotel, healthcare, game, environment, childcare, caregiving, beauty, banking, aviation, archive, agritech, agriculture (7 each)
-    - warehouse, vehicle, restaurant, recruitment, pharmacy, petcare, music, insurance, hr, fitness, event, ecommerce, accounting (6 each)
-    - wedding, veterinary, ticketing, survey, subscription, streaming, social, rental, railway, podcast, parking, news, museum, media, library, legal, laundry, iot, government, funeral, energy, election, elearning, crowdfunding, crm, construction, cinema, charity, auction (5 each)
-
-
-# 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'