musubi-sdd 5.0.0 → 5.6.1

package/src/steering/template-constraints.js

@@ -1,6 +1,6 @@
 /**
  * Template Constraints Module
- * 
+ *
  * LLM-constraining syntax for steering templates with:
  * - Uncertainty markers ({?...?}, {~...~})
  * - Required checklists ([x] items)
@@ -18,16 +18,16 @@ const ConstraintType = {
   CHOICE: 'choice',
   RANGE: 'range',
   PATTERN: 'pattern',
-  CUSTOM: 'custom'
+  CUSTOM: 'custom',
 };
 
 // Uncertainty Marker Types
 const UncertaintyMarker = {
-  UNKNOWN: '?',      // {?...?} - value unknown
-  ESTIMATE: '~',     // {~...~} - estimated value
-  PLACEHOLDER: '#',  // {#...#} - placeholder
-  TODO: '!',         // {!...!} - needs action
-  REVIEW: '@'        // {@...@} - needs review
+  UNKNOWN: '?', // {?...?} - value unknown
+  ESTIMATE: '~', // {~...~} - estimated value
+  PLACEHOLDER: '#', // {#...#} - placeholder
+  TODO: '!', // {!...!} - needs action
+  REVIEW: '@', // {@...@} - needs review
 };
 
 // Validation Severity
@@ -35,7 +35,7 @@ const Severity = {
   ERROR: 'error',
   WARNING: 'warning',
   INFO: 'info',
-  HINT: 'hint'
+  HINT: 'hint',
 };
 
 /**
@@ -59,8 +59,8 @@ class Constraint {
         constraint: this.name,
         type: this.type,
         severity: this.severity,
-        message: result === true ? null : (typeof result === 'string' ? result : this.message),
-        value
+        message: result === true ? null : typeof result === 'string' ? result : this.message,
+        value,
       };
     } catch (error) {
       return {
@@ -70,7 +70,7 @@ class Constraint {
         severity: this.severity,
         message: error.message,
         value,
-        error
+        error,
       };
     }
   }
@@ -114,16 +114,14 @@ class ChecklistItem {
       if (context.checklist && !context.checklist[dep]?.checked) {
         return {
           valid: false,
-          message: `Dependency "${dep}" must be completed first`
+          message: `Dependency "${dep}" must be completed first`,
         };
       }
     }
 
     return {
       valid: !this.required || this.checked,
-      message: this.required && !this.checked 
-        ? `Required item not checked: ${this.text}` 
-        : null
+      message: this.required && !this.checked ? `Required item not checked: ${this.text}` : null,
     };
   }
 }
@@ -144,7 +142,7 @@ class Checklist {
   addItem(id, text, options = {}) {
     const item = new ChecklistItem(text, {
       ...options,
-      order: this.items.size
+      order: this.items.size,
     });
     this.items.set(id, item);
     return item;
@@ -188,7 +186,7 @@ class Checklist {
       if (!result.valid && !result.skipped) {
         issues.push({
           item: id,
-          message: result.message
+          message: result.message,
         });
       }
     }
@@ -198,7 +196,7 @@ class Checklist {
       const checked = this.getCheckedCount();
       if (checked < this.minRequired) {
         issues.push({
-          message: `At least ${this.minRequired} items must be checked (current: ${checked})`
+          message: `At least ${this.minRequired} items must be checked (current: ${checked})`,
         });
       }
     }
@@ -208,7 +206,7 @@ class Checklist {
       const checked = this.getCheckedCount();
       if (checked > this.maxAllowed) {
         issues.push({
-          message: `At most ${this.maxAllowed} items can be checked (current: ${checked})`
+          message: `At most ${this.maxAllowed} items can be checked (current: ${checked})`,
         });
       }
     }
@@ -218,13 +216,13 @@ class Checklist {
       checklist: this.name,
       checked: this.getCheckedCount(),
       total: this.items.size,
-      issues
+      issues,
     };
   }
 
   toMarkdown() {
     const lines = [`## ${this.name}`, ''];
-    
+
     for (const [, item] of this.items) {
       const checkbox = item.checked ? '[x]' : '[ ]';
       const required = item.required ? '' : ' (optional)';
@@ -238,7 +236,7 @@ class Checklist {
     const lines = content.split('\n');
     let name = 'Checklist';
     const checklist = new Checklist(name);
-    
+
     for (const line of lines) {
       // Parse header
       const headerMatch = line.match(/^##\s+(.+)$/);
@@ -255,7 +253,7 @@ class Checklist {
         const text = itemMatch[2];
         const required = !itemMatch[3];
         const id = text.toLowerCase().replace(/\s+/g, '-').slice(0, 50);
-        
+
         checklist.addItem(id, text, { checked, required });
       }
     }
@@ -274,7 +272,7 @@ class UncertaintyParser {
       ['~', { name: 'estimate', pattern: /\{~(.+?)~\}/g }],
       ['#', { name: 'placeholder', pattern: /\{#(.+?)#\}/g }],
       ['!', { name: 'todo', pattern: /\{!(.+?)!\}/g }],
-      ['@', { name: 'review', pattern: /\{@(.+?)@\}/g }]
+      ['@', { name: 'review', pattern: /\{@(.+?)@\}/g }],
     ]);
   }
 
@@ -291,7 +289,7 @@ class UncertaintyParser {
           marker,
           value: match[1],
           original: match[0],
-          index: match.index
+          index: match.index,
         });
       }
     }
@@ -307,7 +305,10 @@ class UncertaintyParser {
       for (const [marker] of this.markers) {
         const patterns = [
           new RegExp(`\\{\\${marker}${this.escapeRegex(key)}\\${marker}\\}`, 'g'),
-          new RegExp(`\\{\\${marker}[^${marker}]*${this.escapeRegex(key)}[^${marker}]*\\${marker}\\}`, 'g')
+          new RegExp(
+            `\\{\\${marker}[^${marker}]*${this.escapeRegex(key)}[^${marker}]*\\${marker}\\}`,
+            'g'
+          ),
         ];
 
         for (const pattern of patterns) {
@@ -341,7 +342,7 @@ class UncertaintyParser {
   highlight(content) {
     let highlighted = content;
 
-    for (const [marker, config] of this.markers) {
+    for (const [_marker, config] of this.markers) {
       const regex = new RegExp(config.pattern.source, 'g');
       highlighted = highlighted.replace(regex, `**[${config.name.toUpperCase()}: $1]**`);
     }
@@ -378,7 +379,7 @@ class TemplateSection {
       issues.push({
         constraint: 'required',
         severity: Severity.ERROR,
-        message: `Section "${this.name}" is required`
+        message: `Section "${this.name}" is required`,
       });
       return { valid: false, section: this.name, issues };
     }
@@ -389,7 +390,7 @@ class TemplateSection {
         issues.push({
           constraint: 'dependency',
           severity: Severity.ERROR,
-          message: `Section "${this.name}" requires "${dep}" to be defined`
+          message: `Section "${this.name}" requires "${dep}" to be defined`,
         });
       }
     }
@@ -400,7 +401,7 @@ class TemplateSection {
         issues.push({
           constraint: 'minLength',
           severity: Severity.WARNING,
-          message: `Section "${this.name}" should be at least ${this.minLength} characters`
+          message: `Section "${this.name}" should be at least ${this.minLength} characters`,
         });
       }
 
@@ -408,7 +409,7 @@ class TemplateSection {
         issues.push({
           constraint: 'maxLength',
           severity: Severity.WARNING,
-          message: `Section "${this.name}" should be at most ${this.maxLength} characters`
+          message: `Section "${this.name}" should be at most ${this.maxLength} characters`,
         });
       }
 
@@ -417,7 +418,7 @@ class TemplateSection {
         issues.push({
           constraint: 'pattern',
           severity: Severity.ERROR,
-          message: `Section "${this.name}" does not match required pattern`
+          message: `Section "${this.name}" does not match required pattern`,
         });
       }
     }
@@ -429,7 +430,7 @@ class TemplateSection {
         issues.push({
           constraint: constraint.name,
           severity: result.severity,
-          message: result.message
+          message: result.message,
         });
       }
     }
@@ -437,7 +438,7 @@ class TemplateSection {
     return {
       valid: !issues.some(i => i.severity === Severity.ERROR),
       section: this.name,
-      issues
+      issues,
     };
   }
 }
@@ -486,12 +487,12 @@ class TemplateDefinition {
       template: this.name,
       sections: [],
       checklists: [],
-      global: []
+      global: [],
     };
 
     const sectionContext = {
       ...context,
-      sections: document.sections || {}
+      sections: document.sections || {},
     };
 
     // Validate sections
@@ -499,7 +500,7 @@ class TemplateDefinition {
       const content = document.sections?.[name] || '';
       const result = section.validate(content, sectionContext);
       results.sections.push(result);
-      
+
       if (!result.valid) {
         results.valid = false;
       }
@@ -508,7 +509,7 @@ class TemplateDefinition {
     // Validate checklists
     for (const [name, checklist] of this.checklists) {
       const items = document.checklists?.[name] || {};
-      
+
       // Apply checked state from document
       for (const [id, checked] of Object.entries(items)) {
         if (checked) checklist.check(id);
@@ -565,18 +566,18 @@ class TemplateConstraintEngine extends EventEmitter {
     const doc = {
       sections: {},
       checklists: {},
-      uncertainties: []
+      uncertainties: [],
     };
 
     // Parse sections (## headers)
-    const sectionPattern = /^##\s+(.+)$/gm;
+    const _sectionPattern = /^##\s+(.+)$/gm;
     let currentSection = null;
     let currentContent = [];
     const lines = content.split('\n');
 
     for (const line of lines) {
       const sectionMatch = line.match(/^##\s+(.+)$/);
-      
+
       if (sectionMatch) {
         // Save previous section
         if (currentSection) {
@@ -626,13 +627,11 @@ class TemplateConstraintEngine extends EventEmitter {
     if (!template) {
       return {
         valid: false,
-        error: `Template "${templateName}" not found`
+        error: `Template "${templateName}" not found`,
       };
     }
 
-    const document = typeof content === 'string' 
-      ? this.parseDocument(content)
-      : content;
+    const document = typeof content === 'string' ? this.parseDocument(content) : content;
 
     const results = template.validate(document);
 
@@ -642,13 +641,13 @@ class TemplateConstraintEngine extends EventEmitter {
       results.uncertainties = document.uncertainties.map(u => ({
         type: u.type,
         value: u.value,
-        message: `Unresolved ${u.type}: ${u.value}`
+        message: `Unresolved ${u.type}: ${u.value}`,
       }));
     }
 
     this.emit('validated', {
       template: templateName,
-      results
+      results,
     });
 
     return results;
@@ -703,7 +702,7 @@ class TemplateConstraintEngine extends EventEmitter {
   createSteeringTemplates() {
     // Structure template
     const structure = new TemplateDefinition('Structure', {
-      description: 'Project structure and architecture'
+      description: 'Project structure and architecture',
     });
 
     structure.addSection('Overview', { required: true, minLength: 50 });
@@ -720,7 +719,7 @@ class TemplateConstraintEngine extends EventEmitter {
 
     // Tech template
     const tech = new TemplateDefinition('Tech', {
-      description: 'Technology stack and tools'
+      description: 'Technology stack and tools',
     });
 
     tech.addSection('Languages', { required: true });
@@ -736,7 +735,7 @@ class TemplateConstraintEngine extends EventEmitter {
 
     // Product template
     const product = new TemplateDefinition('Product', {
-      description: 'Product context and goals'
+      description: 'Product context and goals',
     });
 
     product.addSection('Vision', { required: true, minLength: 100 });
@@ -761,7 +760,7 @@ class TemplateConstraintEngine extends EventEmitter {
  */
 function createTemplateConstraintEngine(options = {}) {
   const engine = new TemplateConstraintEngine(options);
-  
+
   if (options.includeSteeringTemplates !== false) {
     engine.createSteeringTemplates();
   }
@@ -774,7 +773,7 @@ module.exports = {
   ConstraintType,
   UncertaintyMarker,
   Severity,
-  
+
   // Classes
   Constraint,
   ChecklistItem,
@@ -783,7 +782,7 @@ module.exports = {
   TemplateSection,
   TemplateDefinition,
   TemplateConstraintEngine,
-  
+
   // Factory
-  createTemplateConstraintEngine
+  createTemplateConstraintEngine,
 };

package/src/templates/agents/claude-code/CLAUDE.md

@@ -245,47 +245,47 @@ npx musubi-sdd <command>
 
 ### Core Commands
 
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `musubi-workflow` | Workflow state & metrics | `npx musubi-workflow status` |
-| `musubi-requirements` | EARS requirements | `npx musubi-requirements init <feature>` |
-| `musubi-design` | C4 + ADR design | `npx musubi-design init <feature>` |
-| `musubi-tasks` | Task breakdown | `npx musubi-tasks init <feature>` |
-| `musubi-trace` | Traceability | `npx musubi-trace matrix` |
-| `musubi-validate` | Constitutional validation | `npx musubi-validate all` |
+| Command               | Purpose                   | Example                                  |
+| --------------------- | ------------------------- | ---------------------------------------- |
+| `musubi-workflow`     | Workflow state & metrics  | `npx musubi-workflow status`             |
+| `musubi-requirements` | EARS requirements         | `npx musubi-requirements init <feature>` |
+| `musubi-design`       | C4 + ADR design           | `npx musubi-design init <feature>`       |
+| `musubi-tasks`        | Task breakdown            | `npx musubi-tasks init <feature>`        |
+| `musubi-trace`        | Traceability              | `npx musubi-trace matrix`                |
+| `musubi-validate`     | Constitutional validation | `npx musubi-validate all`                |
 
 ### Advanced Commands (v3.5.0 NEW)
 
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `musubi-orchestrate` | Multi-skill orchestration | `npx musubi-orchestrate auto <task>` |
-| `musubi-browser` | Browser automation & E2E | `npx musubi-browser run "click login"` |
-| `musubi-gui` | Web GUI dashboard | `npx musubi-gui start` |
-| `musubi-remember` | Agent memory management | `npx musubi-remember extract` |
-| `musubi-resolve` | GitHub Issue resolution | `npx musubi-resolve <issue-number>` |
-| `musubi-convert` | Format conversion | `npx musubi-convert to-speckit` |
+| Command              | Purpose                   | Example                                |
+| -------------------- | ------------------------- | -------------------------------------- |
+| `musubi-orchestrate` | Multi-skill orchestration | `npx musubi-orchestrate auto <task>`   |
+| `musubi-browser`     | Browser automation & E2E  | `npx musubi-browser run "click login"` |
+| `musubi-gui`         | Web GUI dashboard         | `npx musubi-gui start`                 |
+| `musubi-remember`    | Agent memory management   | `npx musubi-remember extract`          |
+| `musubi-resolve`     | GitHub Issue resolution   | `npx musubi-resolve <issue-number>`    |
+| `musubi-convert`     | Format conversion         | `npx musubi-convert to-speckit`        |
 
 ### Replanning Commands (v3.6.0 NEW)
 
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `musubi-orchestrate replan` | Execute dynamic replanning | `npx musubi-orchestrate replan <context-id>` |
-| `musubi-orchestrate goal register` | Register a new goal | `npx musubi-orchestrate goal register --name "Deploy API"` |
-| `musubi-orchestrate goal update` | Update goal progress | `npx musubi-orchestrate goal update <goal-id> --progress 50` |
-| `musubi-orchestrate goal status` | View goal status | `npx musubi-orchestrate goal status [goal-id]` |
-| `musubi-orchestrate optimize run` | Run path optimization | `npx musubi-orchestrate optimize run <path-id>` |
-| `musubi-orchestrate optimize suggest` | Get optimization suggestions | `npx musubi-orchestrate optimize suggest <path-id>` |
-| `musubi-orchestrate path analyze` | Analyze execution path | `npx musubi-orchestrate path analyze <path-id>` |
-| `musubi-orchestrate path optimize` | Optimize execution path | `npx musubi-orchestrate path optimize <path-id>` |
+| Command                               | Purpose                      | Example                                                      |
+| ------------------------------------- | ---------------------------- | ------------------------------------------------------------ |
+| `musubi-orchestrate replan`           | Execute dynamic replanning   | `npx musubi-orchestrate replan <context-id>`                 |
+| `musubi-orchestrate goal register`    | Register a new goal          | `npx musubi-orchestrate goal register --name "Deploy API"`   |
+| `musubi-orchestrate goal update`      | Update goal progress         | `npx musubi-orchestrate goal update <goal-id> --progress 50` |
+| `musubi-orchestrate goal status`      | View goal status             | `npx musubi-orchestrate goal status [goal-id]`               |
+| `musubi-orchestrate optimize run`     | Run path optimization        | `npx musubi-orchestrate optimize run <path-id>`              |
+| `musubi-orchestrate optimize suggest` | Get optimization suggestions | `npx musubi-orchestrate optimize suggest <path-id>`          |
+| `musubi-orchestrate path analyze`     | Analyze execution path       | `npx musubi-orchestrate path analyze <path-id>`              |
+| `musubi-orchestrate path optimize`    | Optimize execution path      | `npx musubi-orchestrate path optimize <path-id>`             |
 
 ### Guardrails Commands (v3.9.0 NEW)
 
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `musubi-validate guardrails` | Input/Output guardrail validation | `npx musubi-validate guardrails --type input` |
-| `musubi-validate guardrails --type output` | Output content validation | `echo "content" \| npx musubi-validate guardrails --type output` |
-| `musubi-validate guardrails --type safety` | Safety check with constitutional | `npx musubi-validate guardrails --type safety --constitutional` |
-| `musubi-validate guardrails-chain` | Chain multiple guardrails | `npx musubi-validate guardrails-chain --parallel` |
+| Command                                    | Purpose                           | Example                                                          |
+| ------------------------------------------ | --------------------------------- | ---------------------------------------------------------------- |
+| `musubi-validate guardrails`               | Input/Output guardrail validation | `npx musubi-validate guardrails --type input`                    |
+| `musubi-validate guardrails --type output` | Output content validation         | `echo "content" \| npx musubi-validate guardrails --type output` |
+| `musubi-validate guardrails --type safety` | Safety check with constitutional  | `npx musubi-validate guardrails --type safety --constitutional`  |
+| `musubi-validate guardrails-chain`         | Chain multiple guardrails         | `npx musubi-validate guardrails-chain --parallel`                |
 
 ## Learn More
 

package/src/templates/agents/claude-code/skills/agent-assistant/SKILL.md

@@ -31,13 +31,14 @@ Detects when an AI agent is stuck in various patterns:
 - **Stage Oscillation**: Back-and-forth between stages
 
 **Usage Example**:
+
 ```javascript
 const { StuckDetector } = require('musubi/src/analyzers/stuck-detector');
 
 const detector = new StuckDetector({
-  repeatThreshold: 3,       // Detect after 3 repeats
-  monologueThreshold: 10,   // Detect after 10 messages
-  minHistoryLength: 5       // Minimum events for detection
+  repeatThreshold: 3, // Detect after 3 repeats
+  monologueThreshold: 10, // Detect after 10 messages
+  minHistoryLength: 5, // Minimum events for detection
 });
 
 // Add events from agent session
@@ -63,6 +64,7 @@ Compresses long session history to fit context window:
 - **AmortizedCondenser**: Gradual compression with summaries
 
 **Usage Example**:
+
 ```javascript
 const { MemoryCondenser } = require('musubi/src/managers/memory-condenser');
 
@@ -111,13 +113,14 @@ musubi-remember clear
 ```
 
 **Usage Example**:
+
 ```javascript
 const { AgentMemoryManager } = require('musubi/src/managers/agent-memory');
 
 const manager = new AgentMemoryManager({
   projectRoot: process.cwd(),
   autoSave: true,
-  minConfidence: 0.5
+  minConfidence: 0.5,
 });
 
 await manager.initialize();
@@ -125,7 +128,7 @@ await manager.initialize();
 // Extract learnings from session events
 const events = [
   { content: 'npm run test で単体テストを実行しました' },
-  { content: 'Error: Module not found → npm install で解決' }
+  { content: 'Error: Module not found → npm install で解決' },
 ];
 const learnings = manager.extractLearnings(events);
 
@@ -214,11 +217,13 @@ musubi-analyze learnings --session ./session.log --export markdown
 **Message**: エージェントが同じアクションを繰り返しています
 
 ### Event History
+
 1. [action] Read file.js
 2. [action] Read file.js
 3. [action] Read file.js
 
 ### Recommended Actions
+
 - Try a different approach to access the file
 - Check file permissions
 - Consider alternative file paths
@@ -230,14 +235,17 @@ musubi-analyze learnings --session ./session.log --export markdown
 ## 📚 Session Learnings
 
 ### Commands (2 items)
+
 - `npm run test` - 単体テストを実行
 - `npm install` - 依存関係をインストール
 
 ### Error Solutions (1 item)
+
 - **Error**: Module not found
 - **Solution**: npm install で解決
 - **Confidence**: 0.85
 
 ### Project Structure (1 item)
+
 - テストファイルは `tests/` ディレクトリに配置
 ```

package/src/templates/agents/claude-code/skills/ai-ml-engineer/mlops-guide.md

@@ -80,17 +80,17 @@ with mlflow.start_run():
     # Log parameters
     mlflow.log_param("learning_rate", 0.01)
     mlflow.log_param("epochs", 100)
-    
+
     # Train model
     model = train_model(X_train, y_train)
-    
+
     # Log metrics
     mlflow.log_metric("accuracy", accuracy)
     mlflow.log_metric("f1_score", f1)
-    
+
     # Log model
     mlflow.sklearn.log_model(model, "model")
-    
+
     # Log artifacts
     mlflow.log_artifact("feature_importance.png")
 ```
@@ -137,18 +137,18 @@ model:
   name: fraud-detector
   version: 2.1.0
   framework: scikit-learn
-  
+
 training:
   date: 2024-01-15
   dataset_version: v1.2
   metrics:
     accuracy: 0.95
     f1_score: 0.92
-    
+
 requirements:
   - scikit-learn==1.3.0
   - pandas==2.0.0
-  
+
 schema:
   input:
     - name: amount
@@ -182,7 +182,7 @@ async def predict(features: dict):
     df = pd.DataFrame([features])
     prediction = model.predict(df)
     probability = model.predict_proba(df)
-    
+
     return {
         "prediction": int(prediction[0]),
         "confidence": float(probability[0].max())
@@ -195,12 +195,12 @@ async def health():
 
 ### Deployment Strategies
 
-| Strategy | Description | Use Case |
-|----------|-------------|----------|
-| Shadow | Run parallel to existing | Validate new model |
-| Canary | Gradual traffic shift | Safe rollout |
-| Blue-Green | Full switch | Quick rollback |
-| A/B Test | Split traffic | Compare models |
+| Strategy   | Description              | Use Case           |
+| ---------- | ------------------------ | ------------------ |
+| Shadow     | Run parallel to existing | Validate new model |
+| Canary     | Gradual traffic shift    | Safe rollout       |
+| Blue-Green | Full switch              | Quick rollback     |
+| A/B Test   | Split traffic            | Compare models     |
 
 ---
 
@@ -232,20 +232,20 @@ from scipy import stats
 def detect_drift(reference_data, current_data, threshold=0.05):
     """Detect distribution drift using KS test."""
     drifted_features = []
-    
+
     for column in reference_data.columns:
         statistic, p_value = stats.ks_2samp(
             reference_data[column],
             current_data[column]
         )
-        
+
         if p_value < threshold:
             drifted_features.append({
                 "feature": column,
                 "p_value": p_value,
                 "statistic": statistic
             })
-    
+
     return drifted_features
 ```
 
@@ -295,24 +295,24 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      
+
       - name: Setup Python
         uses: actions/setup-python@v4
         with:
           python-version: '3.10'
-      
+
       - name: Install dependencies
         run: pip install -r requirements.txt
-      
+
       - name: Pull data
         run: dvc pull
-      
+
       - name: Train model
         run: python train.py
-      
+
       - name: Evaluate model
         run: python evaluate.py
-      
+
       - name: Register model
         if: github.ref == 'refs/heads/main'
         run: python register_model.py