musubi-sdd 3.5.1 → 3.6.1

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

@@ -233,6 +233,51 @@ MUSUBI enforces 9 immutable constitutional articles:
 /sdd-change-archive add-2fa
 ```
 
+## CLI Commands (v3.5.0)
+
+MUSUBI provides powerful CLI tools that can be used from any terminal. Install with:
+
+```bash
+npm install -g musubi-sdd
+# or use directly
+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` |
+
+### 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` |
+
+### 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>` |
+
 ## Learn More
 
 - [MUSUBI Documentation](https://github.com/your-org/musubi)

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

@@ -105,6 +105,15 @@ The Orchestrator can leverage all MUSUBI CLI commands to execute tasks efficient
 | `musubi-resolve`    | GitHub Issue auto-resolution      | `musubi-resolve <issue-number>`            |
 | `musubi-convert`    | Format conversion (Spec Kit)      | `musubi-convert to-speckit`                |
 
+### Replanning Commands (v3.6.0 NEW)
+
+| Command                        | Purpose                      | Example                                           |
+| ------------------------------ | ---------------------------- | ------------------------------------------------- |
+| `musubi-orchestrate replan`    | Execute dynamic replanning   | `musubi-orchestrate replan <context-id>`          |
+| `musubi-orchestrate goal`      | Goal management              | `musubi-orchestrate goal register --name "Deploy"`|
+| `musubi-orchestrate optimize`  | Path optimization            | `musubi-orchestrate optimize run <path-id>`       |
+| `musubi-orchestrate path`      | Path analysis                | `musubi-orchestrate path analyze <path-id>`       |
+
 ### Detailed Command Options
 
 **musubi-workflow** (v2.1.0 NEW):
@@ -228,6 +237,17 @@ The Orchestrator can leverage all MUSUBI CLI commands to execute tasks efficient
 - `analyze` - Analyze format compatibility
 - `--output <dir>` - Specify output directory
 
+**musubi-orchestrate replanning** (v3.6.0 NEW):
+
+- `replan <context-id>` - Execute dynamic replanning for a context
+- `goal register --name <name>` - Register a new goal
+- `goal update <goal-id> --progress <percentage>` - Update goal progress
+- `goal status [goal-id]` - View goal status (all goals or specific)
+- `optimize run <path-id>` - Run path optimization
+- `optimize suggest <path-id>` - Get optimization suggestions
+- `path analyze <path-id>` - Analyze execution path
+- `path optimize <path-id>` - Optimize execution path
+
 ---
 
 ## OpenHands-Inspired Modules (v3.0.0)

package/src/templates/agents/claude-code/skills/orchestrator/patterns.md

@@ -226,6 +226,8 @@ Before Production Release:
 | Design review | Group Chat | Multi-perspective feedback |
 | Production release | Human-in-Loop | Critical validation |
 | Unclear request | Auto | Let orchestrator decide |
+| Long-running workflows | Replanning | Handle failures gracefully |
+| Resilient execution | Replanning | Automatic recovery |
 
 ---
 
@@ -264,3 +266,90 @@ Sequential Phase (continue):
 Human Gate:
 → Release approval
 ```
+
+---
+
+## Pattern 7: Replanning Pattern (v3.6.0 NEW)
+
+**Description**: Dynamic replanning when tasks fail, timeout, or encounter obstacles. The ReplanningEngine monitors execution and adjusts plans in real-time.
+
+```
+Execute Task
+    ↓
+Monitor (failure/timeout/quality issue?)
+    ↓ Yes
+Trigger Replan
+    ↓
+Analyze Context
+    ↓
+Generate Alternative Plan
+    ↓
+Execute Alternative
+```
+
+**Use When**:
+- Tasks may fail or timeout
+- Alternative approaches exist
+- Resilience is critical
+- Long-running workflows
+
+**Components**:
+
+| Component | Purpose | CLI Command |
+|-----------|---------|-------------|
+| ReplanningEngine | Core replanning logic | `musubi-orchestrate replan <context-id>` |
+| GoalProgressTracker | Track goal completion | `musubi-orchestrate goal status` |
+| ProactivePathOptimizer | Optimize execution paths | `musubi-orchestrate optimize run <path-id>` |
+| AdaptiveGoalModifier | Adjust goals dynamically | `musubi-orchestrate goal update <goal-id>` |
+
+**Example**:
+```
+User: "Deploy API to production"
+
+Initial Plan:
+1. Build → 2. Test → 3. Deploy
+
+Execution:
+1. Build ✓
+2. Test → FAILURE (timeout)
+
+Replan Triggered:
+- Reason: timeout
+- Decision: retry with smaller test subset
+- Alternative: 2a. Run critical tests only
+
+Continue:
+2a. Critical Tests ✓
+3. Deploy ✓
+```
+
+**Trigger Types**:
+- `failure` - Task execution failed
+- `timeout` - Task exceeded time limit
+- `quality` - Output quality below threshold
+- `manual` - Human-triggered replan
+- `dependency` - Dependency unavailable
+
+**Decision Types**:
+- `continue` - Proceed with next task
+- `retry` - Retry the failed task
+- `alternative` - Use alternative approach
+- `abort` - Stop execution
+- `human` - Escalate to human decision
+
+**CLI Usage**:
+```bash
+# Execute replanning for a context
+musubi-orchestrate replan ctx-12345
+
+# Register and track goals
+musubi-orchestrate goal register --name "Deploy API" --target 100
+musubi-orchestrate goal update goal-1 --progress 50
+musubi-orchestrate goal status
+
+# Optimize execution paths
+musubi-orchestrate path analyze path-1
+musubi-orchestrate optimize suggest path-1
+musubi-orchestrate optimize run path-1
+```
+

package/src/templates/agents/codex/AGENTS.md

@@ -177,6 +177,19 @@ npx musubi-sdd <command>
 | `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>` |
+
 ## Learn More
 
 - [MUSUBI Documentation](https://github.com/nahisaho/musubi)

package/src/templates/agents/cursor/AGENTS.md

@@ -177,6 +177,19 @@ npx musubi-sdd <command>
 | `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>` |
+
 ## Learn More
 
 - [MUSUBI Documentation](https://github.com/nahisaho/musubi)

package/src/templates/agents/gemini-cli/GEMINI.md

@@ -166,6 +166,19 @@ npx musubi-sdd <command>
 | `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>` |
+
 ## Learn More
 
 - [MUSUBI Documentation](https://github.com/nahisaho/musubi)

package/src/templates/agents/github-copilot/AGENTS.md

@@ -204,6 +204,19 @@ npx musubi-sdd <command>
 | `musubi-resolve` | GitHub Issue auto-resolution | `npx musubi-resolve <issue-number>` |
 | `musubi-convert` | Format conversion (Spec Kit) | `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>` |
+
 ### CLI + Prompt Integration
 
 Combine CLI commands with GitHub Copilot prompts for maximum efficiency:

package/src/templates/agents/qwen-code/QWEN.md

@@ -166,6 +166,19 @@ npx musubi-sdd <command>
 | `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>` |
+
 ## Learn More
 
 - [MUSUBI Documentation](https://github.com/nahisaho/musubi)

package/src/templates/agents/windsurf/AGENTS.md

@@ -177,6 +177,19 @@ npx musubi-sdd <command>
 | `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>` |
+
 ## Learn More
 
 - [MUSUBI Documentation](https://github.com/nahisaho/musubi)