musubi-sdd 5.1.0 → 5.6.1

package/src/templates/agents/claude-code/skills/database-administrator/tuning-guide.md

@@ -20,12 +20,12 @@ EXPLAIN SELECT * FROM orders WHERE user_id = 123;
 
 ### Common Query Plan Issues
 
-| Issue | Symptom | Solution |
-|-------|---------|----------|
-| Seq Scan | Full table scan | Add index |
-| Nested Loop | Slow joins | Review join strategy |
-| Sort | Excessive sorting | Add sorted index |
-| Hash Join | Large hash tables | Increase work_mem |
+| Issue       | Symptom           | Solution             |
+| ----------- | ----------------- | -------------------- |
+| Seq Scan    | Full table scan   | Add index            |
+| Nested Loop | Slow joins        | Review join strategy |
+| Sort        | Excessive sorting | Add sorted index     |
+| Hash Join   | Large hash tables | Increase work_mem    |
 
 ---
 
@@ -52,12 +52,12 @@ CREATE INDEX idx_users_lower_email ON users(LOWER(email));
 
 ### Index Types
 
-| Type | Use Case | PostgreSQL | MySQL |
-|------|----------|------------|-------|
-| B-tree | Equality, range | Default | Default |
-| Hash | Equality only | `USING HASH` | Memory only |
-| GIN | Full-text, JSONB | `USING GIN` | N/A |
-| GiST | Geometric, range | `USING GIST` | N/A |
+| Type   | Use Case         | PostgreSQL   | MySQL       |
+| ------ | ---------------- | ------------ | ----------- |
+| B-tree | Equality, range  | Default      | Default     |
+| Hash   | Equality only    | `USING HASH` | Memory only |
+| GIN    | Full-text, JSONB | `USING GIN`  | N/A         |
+| GiST   | Geometric, range | `USING GIST` | N/A         |
 
 ### Avoid Over-Indexing
 
@@ -103,8 +103,8 @@ reserve_pool_size = 5
 const pool = new Pool({
   host: 'localhost',
   database: 'mydb',
-  max: 20,              // Maximum connections
-  min: 5,               // Minimum connections
+  max: 20, // Maximum connections
+  min: 5, // Minimum connections
   idleTimeoutMillis: 30000,
   connectionTimeoutMillis: 2000,
 });
@@ -173,7 +173,7 @@ long_query_time = 1
 -- PostgreSQL: Enable pg_stat_statements
 CREATE EXTENSION pg_stat_statements;
 
-SELECT 
+SELECT
   query,
   calls,
   total_exec_time / 1000 AS total_seconds,
@@ -188,7 +188,7 @@ LIMIT 10;
 
 ```sql
 -- PostgreSQL: Tables with sequential scans
-SELECT 
+SELECT
   schemaname,
   relname,
   seq_scan,
@@ -205,7 +205,7 @@ LIMIT 10;
 
 ```sql
 -- PostgreSQL: Unused indexes
-SELECT 
+SELECT
   schemaname,
   tablename,
   indexname,
@@ -247,7 +247,7 @@ ALTER TABLE tablename SET (
 ANALYZE tablename;
 
 -- View statistics
-SELECT 
+SELECT
   attname,
   n_distinct,
   most_common_vals,
@@ -271,16 +271,17 @@ CREATE TABLE orders (
   created_at TIMESTAMP
 ) PARTITION BY RANGE (created_at);
 
-CREATE TABLE orders_2024_01 
+CREATE TABLE orders_2024_01
   PARTITION OF orders
   FOR VALUES FROM ('2024-01-01') TO ('2024-02-01');
 
-CREATE TABLE orders_2024_02 
+CREATE TABLE orders_2024_02
   PARTITION OF orders
   FOR VALUES FROM ('2024-02-01') TO ('2024-03-01');
 ```
 
 ### Benefits of Partitioning
+
 - Faster queries with partition pruning
 - Easier data archival (drop old partitions)
 - Smaller indexes per partition
@@ -291,23 +292,27 @@ CREATE TABLE orders_2024_02
 ## Performance Checklist
 
 ### Query Level
+
 - [ ] Query plan analyzed
 - [ ] Appropriate indexes exist
 - [ ] No unnecessary columns selected
 - [ ] Pagination implemented
 
 ### Configuration Level
+
 - [ ] Buffer pool sized appropriately
 - [ ] Connection pool configured
 - [ ] Slow query logging enabled
 
 ### Maintenance Level
+
 - [ ] Regular VACUUM/ANALYZE
 - [ ] Index bloat monitored
 - [ ] Unused indexes removed
 - [ ] Table statistics current
 
 ### Monitoring Level
+
 - [ ] Query performance tracked
 - [ ] Connection count monitored
 - [ ] Disk I/O monitored

package/src/templates/agents/claude-code/skills/database-schema-designer/schema-patterns.md

@@ -9,6 +9,7 @@ Best practices for designing database schemas.
 ## Naming Conventions
 
 ### Tables
+
 ```sql
 -- Use plural, lowercase, snake_case
 users
@@ -21,6 +22,7 @@ user_profiles
 ```
 
 ### Columns
+
 ```sql
 -- Use lowercase snake_case
 first_name
@@ -39,6 +41,7 @@ can_edit
 ```
 
 ### Indexes
+
 ```sql
 -- idx_table_column
 CREATE INDEX idx_users_email ON users(email);
@@ -50,6 +53,7 @@ CREATE INDEX idx_orders_user_id_created_at ON orders(user_id, created_at);
 ## Primary Keys
 
 ### Auto-increment
+
 ```sql
 CREATE TABLE users (
   id BIGSERIAL PRIMARY KEY,
@@ -58,6 +62,7 @@ CREATE TABLE users (
 ```
 
 ### UUID
+
 ```sql
 CREATE TABLE users (
   id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
@@ -66,6 +71,7 @@ CREATE TABLE users (
 ```
 
 ### Composite Key
+
 ```sql
 CREATE TABLE order_items (
   order_id BIGINT,
@@ -80,6 +86,7 @@ CREATE TABLE order_items (
 ## Common Patterns
 
 ### Timestamps
+
 ```sql
 CREATE TABLE users (
   id BIGSERIAL PRIMARY KEY,
@@ -104,6 +111,7 @@ CREATE TRIGGER users_updated_at
 ```
 
 ### Soft Delete
+
 ```sql
 CREATE TABLE users (
   id BIGSERIAL PRIMARY KEY,
@@ -117,6 +125,7 @@ CREATE INDEX idx_users_active ON users(id) WHERE deleted_at IS NULL;
 ```
 
 ### Audit Trail
+
 ```sql
 CREATE TABLE audit_log (
   id BIGSERIAL PRIMARY KEY,
@@ -135,6 +144,7 @@ CREATE TABLE audit_log (
 ## Relationships
 
 ### One-to-Many
+
 ```sql
 CREATE TABLE users (
   id BIGSERIAL PRIMARY KEY,
@@ -151,6 +161,7 @@ CREATE INDEX idx_orders_user_id ON orders(user_id);
 ```
 
 ### Many-to-Many
+
 ```sql
 CREATE TABLE users (
   id BIGSERIAL PRIMARY KEY,
@@ -171,6 +182,7 @@ CREATE TABLE user_roles (
 ```
 
 ### Self-Referencing
+
 ```sql
 CREATE TABLE categories (
   id BIGSERIAL PRIMARY KEY,
@@ -187,21 +199,21 @@ CREATE INDEX idx_categories_parent ON categories(parent_id);
 
 ### PostgreSQL Types
 
-| Use Case | Type |
-|----------|------|
-| Auto ID | BIGSERIAL |
-| UUID | UUID |
-| Short text | VARCHAR(n) |
-| Long text | TEXT |
-| Integer | INT, BIGINT |
-| Decimal | NUMERIC(p,s), DECIMAL |
-| Money | NUMERIC(10,2) |
-| Boolean | BOOLEAN |
-| Date | DATE |
-| Timestamp | TIMESTAMP WITH TIME ZONE |
-| JSON | JSONB |
-| Array | INTEGER[], TEXT[] |
-| Enum | Custom ENUM or VARCHAR |
+| Use Case   | Type                     |
+| ---------- | ------------------------ |
+| Auto ID    | BIGSERIAL                |
+| UUID       | UUID                     |
+| Short text | VARCHAR(n)               |
+| Long text  | TEXT                     |
+| Integer    | INT, BIGINT              |
+| Decimal    | NUMERIC(p,s), DECIMAL    |
+| Money      | NUMERIC(10,2)            |
+| Boolean    | BOOLEAN                  |
+| Date       | DATE                     |
+| Timestamp  | TIMESTAMP WITH TIME ZONE |
+| JSON       | JSONB                    |
+| Array      | INTEGER[], TEXT[]        |
+| Enum       | Custom ENUM or VARCHAR   |
 
 ### Enums vs Lookup Tables
 
@@ -235,27 +247,27 @@ CREATE TABLE orders (
 ```sql
 CREATE TABLE products (
   id BIGSERIAL PRIMARY KEY,
-  
+
   -- NOT NULL
   name VARCHAR(100) NOT NULL,
-  
+
   -- UNIQUE
   sku VARCHAR(50) UNIQUE,
-  
+
   -- CHECK
   price DECIMAL(10,2) CHECK (price >= 0),
   quantity INT CHECK (quantity >= 0),
-  
+
   -- DEFAULT
   status VARCHAR(20) DEFAULT 'draft',
   created_at TIMESTAMP DEFAULT NOW(),
-  
+
   -- FOREIGN KEY
   category_id BIGINT REFERENCES categories(id)
 );
 
 -- Named constraints
-ALTER TABLE products ADD CONSTRAINT chk_price_positive 
+ALTER TABLE products ADD CONSTRAINT chk_price_positive
   CHECK (price >= 0);
 ```
 
@@ -283,7 +295,7 @@ CREATE TABLE users (
   password_hash VARCHAR(255) NOT NULL,
   name VARCHAR(100) NOT NULL,
   status user_status DEFAULT 'active',
-  
+
   -- Timestamps
   created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
   updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
@@ -310,26 +322,31 @@ COMMENT ON COLUMN users.status IS 'Account status: active, inactive, suspended';
 ## Schema Checklist
 
 ### Naming
+
 - [ ] Consistent naming convention
 - [ ] Descriptive names
 - [ ] No reserved words
 
 ### Structure
+
 - [ ] Appropriate primary keys
 - [ ] Proper data types
 - [ ] Necessary constraints
 
 ### Performance
+
 - [ ] Indexes on foreign keys
 - [ ] Indexes on filtered columns
 - [ ] Indexes on sorted columns
 
 ### Integrity
+
 - [ ] Foreign key relationships
 - [ ] NOT NULL where required
 - [ ] CHECK constraints
 
 ### Audit
+
 - [ ] Created/updated timestamps
 - [ ] Soft delete if needed
 - [ ] Audit trail for sensitive data

package/src/templates/agents/claude-code/skills/devops-engineer/ci-cd-templates.md

@@ -29,19 +29,19 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'npm'
-          
+
       - name: Install dependencies
         run: npm ci
-        
+
       - name: Lint
         run: npm run lint
-        
+
       - name: Type check
         run: npm run typecheck
 
@@ -61,21 +61,21 @@ jobs:
           - 5432:5432
     steps:
       - uses: actions/checkout@v4
-      
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: ${{ env.NODE_VERSION }}
           cache: 'npm'
-          
+
       - name: Install dependencies
         run: npm ci
-        
+
       - name: Run tests
         run: npm test -- --coverage
         env:
           DATABASE_URL: postgres://postgres:postgres@localhost:5432/test
-          
+
       - name: Upload coverage
         uses: codecov/codecov-action@v3
 
@@ -83,10 +83,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      
+
       - name: Run security audit
         run: npm audit --audit-level=high
-        
+
       - name: Run Trivy vulnerability scanner
         uses: aquasecurity/trivy-action@master
         with:
@@ -104,17 +104,17 @@ jobs:
       image-tag: ${{ steps.meta.outputs.tags }}
     steps:
       - uses: actions/checkout@v4
-      
+
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
-        
+
       - name: Log in to Container registry
         uses: docker/login-action@v3
         with:
           registry: ${{ env.REGISTRY }}
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
-          
+
       - name: Extract metadata
         id: meta
         uses: docker/metadata-action@v5
@@ -123,7 +123,7 @@ jobs:
           tags: |
             type=sha
             type=ref,event=branch
-            
+
       - name: Build and push
         uses: docker/build-push-action@v5
         with:
@@ -169,8 +169,8 @@ stages:
   - deploy
 
 variables:
-  PIP_CACHE_DIR: "$CI_PROJECT_DIR/.pip-cache"
-  DOCKER_TLS_CERTDIR: "/certs"
+  PIP_CACHE_DIR: '$CI_PROJECT_DIR/.pip-cache'
+  DOCKER_TLS_CERTDIR: '/certs'
 
 .python-setup:
   image: python:3.11
@@ -282,35 +282,35 @@ stages:
           - task: UseDotNet@2
             inputs:
               version: $(dotnetVersion)
-              
+
           - task: DotNetCoreCLI@2
             displayName: 'Restore'
             inputs:
               command: restore
-              
+
           - task: DotNetCoreCLI@2
             displayName: 'Build'
             inputs:
               command: build
               arguments: '--configuration $(buildConfiguration) --no-restore'
-              
+
           - task: DotNetCoreCLI@2
             displayName: 'Test'
             inputs:
               command: test
               arguments: '--configuration $(buildConfiguration) --collect:"XPlat Code Coverage"'
-              
+
           - task: PublishCodeCoverageResults@2
             inputs:
               codeCoverageTool: 'Cobertura'
               summaryFileLocation: '$(Agent.TempDirectory)/**/coverage.cobertura.xml'
-              
+
           - task: DotNetCoreCLI@2
             displayName: 'Publish'
             inputs:
               command: publish
               arguments: '--configuration $(buildConfiguration) --output $(Build.ArtifactStagingDirectory)'
-              
+
           - task: PublishBuildArtifacts@1
             inputs:
               pathToPublish: '$(Build.ArtifactStagingDirectory)'
@@ -425,18 +425,21 @@ CMD ["python", "-m", "uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "
 ## Best Practices Checklist
 
 ### Pipeline Security
+
 - [ ] Secrets in vault/variables (not in code)
 - [ ] Minimal permissions for CI/CD
 - [ ] Scan for vulnerabilities
 - [ ] Sign artifacts/images
 
 ### Quality Gates
+
 - [ ] Unit tests pass
 - [ ] Code coverage threshold
 - [ ] Linting passes
 - [ ] Security scan passes
 
 ### Deployment
+
 - [ ] Environment-specific configs
 - [ ] Rollback capability
 - [ ] Health checks

package/src/templates/agents/claude-code/skills/issue-resolver/SKILL.md

@@ -30,17 +30,14 @@ Provides automated issue analysis and resolution planning:
 - **Impact Analysis**: Estimate scope, effort, and risk
 
 **Usage Example**:
+
 ```javascript
-const { 
-  IssueResolver, 
-  IssueInfo, 
-  IssueType 
-} = require('musubi/src/resolvers/issue-resolver');
+const { IssueResolver, IssueInfo, IssueType } = require('musubi/src/resolvers/issue-resolver');
 
 // Create resolver
 const resolver = new IssueResolver({
   projectRoot: process.cwd(),
-  autoCreateBranch: false
+  autoCreateBranch: false,
 });
 
 // Create issue info from GitHub API data
@@ -62,7 +59,7 @@ The login button doesn't work on mobile devices.
 3. Nothing happens
   `,
   labels: ['bug', 'mobile'],
-  assignees: ['developer1']
+  assignees: ['developer1'],
 });
 
 // Get issue type
@@ -71,8 +68,8 @@ console.log(issue.type); // 'bug'
 // Resolve the issue
 const result = await resolver.resolve(issue);
 
-console.log(result.branchName);     // 'fix/42-login-button-not-responding'
-console.log(result.requirements);   // ['Fix touch event handling', ...]
+console.log(result.branchName); // 'fix/42-login-button-not-responding'
+console.log(result.requirements); // ['Fix touch event handling', ...]
 console.log(result.impactAnalysis); // { scope: 'medium', effort: 'small', ... }
 ```
 
@@ -87,7 +84,7 @@ const issue = new IssueInfo({
   number: issueNumber,
   title: issueTitle,
   body: issueBody,
-  labels: issueLabels
+  labels: issueLabels,
 });
 
 // Automatic type detection
@@ -97,6 +94,7 @@ const type = issue.type; // 'bug' | 'feature' | 'documentation' | 'refactor' | '
 ### Step 2: Requirement Extraction
 
 The resolver automatically extracts requirements from:
+
 - **Checkboxes**: `- [ ] Requirement text`
 - **Keywords**: Lines containing "should", "must", "needs to"
 
@@ -110,7 +108,7 @@ const requirements = resolver.extractRequirements(issue);
 Semantic branch names based on issue type:
 
 | Issue Type    | Branch Prefix |
-|---------------|---------------|
+| ------------- | ------------- |
 | Bug           | `fix/`        |
 | Feature       | `feat/`       |
 | Documentation | `docs/`       |
@@ -198,12 +196,12 @@ The ImpactAnalysis class provides:
 
 ```javascript
 const impact = new ImpactAnalysis({
-  scope: 'medium',        // 'small' | 'medium' | 'large'
-  effort: 'small',        // 'trivial' | 'small' | 'medium' | 'large' | 'epic'
-  risk: 'low',            // 'low' | 'medium' | 'high' | 'critical'
+  scope: 'medium', // 'small' | 'medium' | 'large'
+  effort: 'small', // 'trivial' | 'small' | 'medium' | 'large' | 'epic'
+  risk: 'low', // 'low' | 'medium' | 'high' | 'critical'
   affectedAreas: ['components/LoginButton', 'utils/touchHandler'],
   dependencies: ['react-native-gesture-handler'],
-  breakingChanges: false
+  breakingChanges: false,
 });
 
 console.log(impact.toMarkdown());
@@ -223,26 +221,31 @@ console.log(impact.toMarkdown());
 **Status**: ✅ Completed
 
 ### Branch
+
 `fix/42-login-button-not-responding`
 
 ### Requirements Extracted
+
 1. Fix touch event handling
 2. Add loading indicator
 3. Add error handling
 
 ### Impact Analysis
-| Aspect | Value |
-|--------|-------|
-| Scope | Medium |
-| Effort | Small |
-| Risk | Low |
-| Breaking Changes | No |
+
+| Aspect           | Value  |
+| ---------------- | ------ |
+| Scope            | Medium |
+| Effort           | Small  |
+| Risk             | Low    |
+| Breaking Changes | No     |
 
 ### Affected Areas
+
 - `components/LoginButton`
 - `utils/touchHandler`
 
 ### SDD Workflow
+
 1. ✅ Requirements documented
 2. ⬜ Design review pending
 3. ⬜ Task breakdown pending