@polymorphism-tech/morph-spec 4.10.2 → 4.10.4

package/README.md

@@ -3,7 +3,7 @@
 > Spec-driven development framework for multi-stack projects. Turns feature requests into implementation-ready code through structured, AI-orchestrated phases.
 
 **Package:** `@polymorphism-tech/morph-spec`
-**Version:** 4.10.2  
+**Version:** 4.10.4  
 **Requires:** Node.js 18+, Claude Code
 
 ---
@@ -125,10 +125,10 @@ These commands are available inside Claude Code after init.
 
 | Command                     | Description                                               |
 | --------------------------- | --------------------------------------------------------- |
-| `/morph-proposal {feature}` | Full spec pipeline (phases 0-4, pauses at approval gates) |
-| `/morph-apply {feature}`    | Implement approved feature (phase 5)                      |
-| `/morph-status`             | Feature status dashboard                                  |
-| `/morph-preflight`          | Pre-implementation validation                             |
+| `/morph:proposal {feature}` | Full spec pipeline (phases 0-4, pauses at approval gates) |
+| `/morph:apply {feature}`    | Implement approved feature (phase 5)                      |
+| `/morph:status`             | Feature status dashboard                                  |
+| `/morph:preflight`          | Pre-implementation validation                             |
 
 
 ---
@@ -376,4 +376,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v4.10.2 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v4.10.4 by [Polymorphism Tech](https://polymorphism.tech)*

package/bin/morph-spec.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { program } from 'commander';
 import chalk from 'chalk';
@@ -77,13 +77,13 @@ program
 
 program
   .command('setup-infra')
-  .description('Install MORPH-SPEC infrastructure (headless, no prompts). Called by /morph-init skill.')
+  .description('Install MORPH-SPEC infrastructure (headless, no prompts). Called by /morph:init skill.')
   .option('-p, --path <path>', 'Target path (default: current directory)')
   .action(setupInfraCommand);
 
 program
   .command('install-plugin <name>')
-  .description('Install a Claude Code plugin (superpowers, context7). Called by /morph-init skill.')
+  .description('Install a Claude Code plugin (superpowers, context7). Called by /morph:init skill.')
   .action(installPluginCommand);
 
 program

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "4.10.2",
+  "version": "4.10.4",
   "displayName": "MORPH-SPEC Framework",
   "description": "Spec-driven development with 38 agents and 8-phase workflow for .NET/Blazor/Next.js/Azure",
   "publisher": "polymorphism-tech",

package/docs/CHEATSHEET.md

@@ -39,10 +39,10 @@ Phases in brackets are optional.
 
 | Command | Description |
 |---------|-------------|
-| `/morph-proposal {feature}` | Full spec pipeline — phases 0–4 with approval gates |
-| `/morph-apply {feature}` | Implement approved feature — phase 5 |
-| `/morph-status` | Project-wide feature status dashboard |
-| `/morph-preflight` | Pre-implementation validation (7 checks) |
+| `/morph:proposal {feature}` | Full spec pipeline — phases 0–4 with approval gates |
+| `/morph:apply {feature}` | Implement approved feature — phase 5 |
+| `/morph:status` | Project-wide feature status dashboard |
+| `/morph:preflight` | Pre-implementation validation (7 checks) |
 
 ---
 
@@ -198,4 +198,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
 
 ---
 
-*morph-spec v4.10.2 by Polymorphism Tech*
+*morph-spec v4.10.4 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -45,7 +45,7 @@ morph-spec doctor
 Open your project in Claude Code and run:
 
 ```
-/morph-proposal my-feature
+/morph:proposal my-feature
 ```
 
 Replace `my-feature` with a short kebab-case name for your feature (e.g., `user-notifications`, `payment-flow`).
@@ -90,7 +90,7 @@ Claude breaks the spec into atomic tasks (`T001`, `T002`, …) saved to `3-tasks
 At this point, planning is complete:
 
 ```
-✅ Planning complete — run /morph-apply my-feature to implement
+✅ Planning complete — run /morph:apply my-feature to implement
 ```
 
 ---
@@ -98,7 +98,7 @@ At this point, planning is complete:
 ## Implement
 
 ```
-/morph-apply my-feature
+/morph:apply my-feature
 ```
 
 Claude reads `spec.md`, `contracts.cs`, and `tasks.md`, then implements task by task:
@@ -184,7 +184,7 @@ morph-spec doctor
 
 ## Tips
 
-**Use `/morph-proposal` even for small features.** The proposal phase catches scope creep, identifies the right agents, and generates contracts early — before implementation makes it expensive to change direction.
+**Use `/morph:proposal` even for small features.** The proposal phase catches scope creep, identifies the right agents, and generates contracts early — before implementation makes it expensive to change direction.
 
 **Approve explicitly at each gate.** The design gate exists to prevent implementing the wrong thing. If something in `spec.md` or `contracts.cs` looks off, say so before approving.
 
@@ -203,4 +203,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v4.10.2 by Polymorphism Tech*
+*morph-spec v4.10.4 by Polymorphism Tech*

package/framework/CLAUDE.md

@@ -23,10 +23,10 @@
 
 | Command | Purpose |
 |---------|---------|
-| `/morph-proposal {feature}` | Full spec pipeline (pauses for approval) |
-| `/morph-apply {feature}` | Implement feature |
-| `/morph-status` | Status dashboard |
-| `/morph-preflight` | Pre-deploy validation |
+| `/morph:proposal {feature}` | Full spec pipeline (pauses for approval) |
+| `/morph:apply {feature}` | Implement feature |
+| `/morph:status` | Status dashboard |
+| `/morph:preflight` | Pre-deploy validation |
 
 ## Agents
 

package/framework/agents/infrastructure/azure-deploy-specialist.md

@@ -256,7 +256,7 @@ O projeto nao possui arquivos de infraestrutura em `infra/`.
 
 Opcoes:
 1. **Criar agora** - Gerar templates baseado no projeto detectado
-2. **Usar /morph-infra** - Rodar comando de setup de infra primeiro
+2. **Usar /morph:infra** - Rodar comando de setup de infra primeiro
 3. **Cancelar** - Abortar deploy
 
 Qual opcao voce prefere?

package/framework/agents/quality/code-analyzer.md

@@ -18,7 +18,7 @@ Deep code analysis specialist. Automates architecture review, clean code checks,
 
 | Trigger | Automatic? | Scope |
 |---------|-----------|-------|
-| FASE 5 completion (`/morph-apply` done) | Yes | Full feature code |
+| FASE 5 completion (`/morph:apply` done) | Yes | Full feature code |
 | Checkpoint (every 3 tasks) | Yes | Code since last checkpoint |
 | Manual: `analyze`, `review code`, `code quality` | No | Specified scope |
 | Pre-merge review | Recommended | All changed files |

package/framework/agents.json

@@ -178,6 +178,7 @@
       "tier": 2,
       "role": "domain-leader",
       "title": "Backend Squad Leader",
+      "stacks": ["dotnet", "blazor"],
       "domains": [
         "backend"
       ],
@@ -249,6 +250,7 @@
       "tier": 2,
       "role": "domain-leader",
       "title": "Infrastructure Squad Leader",
+      "stacks": ["azure", "docker"],
       "domains": [
         "infrastructure"
       ],
@@ -2322,6 +2324,7 @@
       "tier": 4,
       "role": "validator",
       "title": "Blazor Concurrency Validator",
+      "stacks": ["blazor"],
       "domains": [
         "blazor-concurrency"
       ],
@@ -2428,6 +2431,7 @@
     },
     "nextjs-component-validator": {
       "tier": 4,
+      "stacks": ["nextjs"],
       "title": "Next.js Component Validator",
       "description": "Tier-4 validator for Next.js Server/Client component patterns",
       "keywords": [

package/framework/commands/morph-apply.md

@@ -4,14 +4,14 @@ argument-hint: <feature-name>
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, Agent, AskUserQuestion
 ---
 
-# /morph-apply — Feature Implementation
+# /morph:apply — Feature Implementation
 
 Implement the feature by executing its task breakdown, tracking progress through the morph-spec state machine, and producing a recap at the end.
 
 ## Usage
 
 ```
-/morph-apply {feature-name}
+/morph:apply {feature-name}
 ```
 
 ## Recommended Tools
@@ -46,7 +46,7 @@ npx morph-spec validate-feature $ARGUMENTS
 
 ```
 Feature is not ready for implementation.
-Run /morph-proposal $ARGUMENTS to complete planning phases.
+Run /morph:proposal $ARGUMENTS to complete planning phases.
 (Resumes automatically from the current phase.)
 ```
 
@@ -192,7 +192,7 @@ After implementation, present a summary to the user:
 3. Validation results
 4. Any deviations from spec
 
-For Azure projects, remind the user: "Run `/morph-preflight` before deploying to validate packages, migrations, Docker, and secrets."
+For Azure projects, remind the user: "Run `/morph:preflight` before deploying to validate packages, migrations, Docker, and secrets."
 
 ---
 

package/framework/commands/morph-infra.md

@@ -4,14 +4,14 @@ argument-hint: [up|down|plan|status]
 allowed-tools: Read, Write, Edit, Bash, Glob, AskUserQuestion
 ---
 
-# /morph-infra - Infrastructure Management
+# /morph:infra - Infrastructure Management
 
 Manage Azure infrastructure using Bicep templates.
 
 ## Usage
 
 ```
-/morph-infra [action] [options]
+/morph:infra [action] [options]
 ```
 
 ### Actions
@@ -30,7 +30,7 @@ Manage Azure infrastructure using Bicep templates.
 
 ### 1. INIT - Initialize IaC
 
-When the user requests `/morph-infra init`:
+When the user requests `/morph:infra init`:
 
 1. Create the `infra/` structure in the project:
    ```
@@ -60,7 +60,7 @@ When the user requests `/morph-infra init`:
 
 ### 2. VALIDATE - Validate Templates
 
-When the user requests `/morph-infra validate`:
+When the user requests `/morph:infra validate`:
 
 1. Run Bicep validation:
    ```bash
@@ -75,7 +75,7 @@ When the user requests `/morph-infra validate`:
 
 ### 3. PLAN - Preview Changes
 
-When the user requests `/morph-infra plan [env]`:
+When the user requests `/morph:infra plan [env]`:
 
 1. Check if Azure CLI is authenticated:
    ```bash
@@ -102,7 +102,7 @@ When the user requests `/morph-infra plan [env]`:
 
 ### 4. DEPLOY - Execute Deploy
 
-When the user requests `/morph-infra deploy [env]`:
+When the user requests `/morph:infra deploy [env]`:
 
 1. Verify plan was approved
 
@@ -130,7 +130,7 @@ When the user requests `/morph-infra deploy [env]`:
 
 ### 5. DESTROY - Remove Resources
 
-When the user requests `/morph-infra destroy [env]`:
+When the user requests `/morph:infra destroy [env]`:
 
 1. **WARN** that this action is irreversible
 
@@ -177,14 +177,14 @@ Before any deploy, check with Cost Guardian:
 ## Usage Example
 
 ```
-User: /morph-infra init
+User: /morph:infra init
 Claude: Creating IaC structure...
         - infra/main.bicep
         - infra/parameters.dev.json
         - infra/modules/*.bicep
-        Done! Run /morph-infra validate to verify.
+        Done! Run /morph:infra validate to verify.
 
-User: /morph-infra plan dev
+User: /morph:infra plan dev
 Claude: Analyzing changes for dev environment...
 
         CREATE:

package/framework/commands/morph-preflight.md

@@ -11,7 +11,7 @@ Validates project readiness before deploying to Azure.
 ## Usage
 
 ```
-/morph-preflight azure
+/morph:preflight azure
 ```
 
 ## Purpose
@@ -39,7 +39,7 @@ npx morph-spec validate-feature {feature}
 | All tasks complete | `state get` → tasks array | 0 tasks in `pending` or `in_progress` |
 | Recap generated | Read `5-implement/recap.md` | File exists and is non-empty |
 
-**If any MORPH check fails:** Show which check failed and recommend: `Run /morph-apply {feature} to complete implementation before deploying.`
+**If any MORPH check fails:** Show which check failed and recommend: `Run /morph:apply {feature} to complete implementation before deploying.`
 
 ---
 
@@ -222,7 +222,7 @@ Recommended fixes:
 ### Before creating PR for production
 
 ```bash
-/morph-preflight azure
+/morph:preflight azure
 ```
 
 ### In CI/CD pipeline

package/framework/commands/morph-proposal.md

@@ -1,5 +1,5 @@
 ---
-description: MORPH Spec Pipeline — creates or resumes feature planning through phases 0-6 with mandatory approval pauses. Use whenever the user wants to plan, spec, or design a new feature, or when they say /morph-proposal. This is the primary entry point for all MORPH-SPEC feature work.
+description: MORPH Spec Pipeline — creates or resumes feature planning through phases 0-6 with mandatory approval pauses. Use whenever the user wants to plan, spec, or design a new feature, or when they say /morph:proposal. This is the primary entry point for all MORPH-SPEC feature work.
 argument-hint: <feature-name>
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
 ---
@@ -187,7 +187,7 @@ npx morph-spec phase advance {feature-name}
 After task approval:
 
 ```
-Planning complete! Run /morph-apply {feature-name} to start implementation.
+Planning complete! Run /morph:apply {feature-name} to start implementation.
 ```
 
 ---

package/framework/commands/morph-status.md

@@ -83,9 +83,9 @@ The `npx morph-spec state list` command automatically generates a formatted dash
 ## Available Actions
 
 Suggest next actions:
-- `/morph-proposal {feature}` - Create a new feature
-- `/morph-apply {feature}` - Implement a feature
-- `/morph-archive {feature}` - Archive a completed feature
+- `/morph:proposal {feature}` - Create a new feature
+- `/morph:apply {feature}` - Implement a feature
+- `/morph:archive {feature}` - Archive a completed feature
 
 ---
 

package/framework/hooks/claude-code/pre-compact/save-morph-context.js

@@ -35,7 +35,7 @@ const PHASE_POSITIONS = {
 const PIPELINE_TOTAL = 5;
 
 const NEXT_STEP_HINT = {
-  proposal:  (n) => `Continue spec pipeline: /morph-proposal ${n}`,
+  proposal:  (n) => `Continue spec pipeline: /morph:proposal ${n}`,
   design:    (n) => `Approve design gate: morph-spec approve ${n} design`,
   uiux:      (n) => `Approve UI gate: morph-spec approve ${n} uiux`,
   tasks:     (n) => `Approve tasks gate: morph-spec approve ${n} tasks`,

package/framework/rules/morph-workflow.md

@@ -37,9 +37,9 @@ Use `morph-spec status {feature}` to see current phase and pending approval gate
 
 | Command | Purpose |
 |---------|---------|
-| `/morph-proposal {feature}` | Full spec pipeline (phases 1-4, pauses for approval) |
-| `/morph-apply {feature}` | Implement feature (phase 5) |
-| `/morph-status` | Feature dashboard |
+| `/morph:proposal {feature}` | Full spec pipeline (phases 1-4, pauses for approval) |
+| `/morph:apply {feature}` | Implement feature (phase 5) |
+| `/morph:status` | Feature dashboard |
 
 ---
 

package/framework/skills/README.md

@@ -32,7 +32,7 @@ Each skill is a directory: `{name}/SKILL.md` + optional `scripts/`, `references/
 
 ## level-1-workflows — Phase Workflow Skills
 
-Invoked internally by `/morph-proposal` and `/morph-apply`. Not user-invocable.
+Invoked internally by `/morph:proposal` and `/morph:apply`. Not user-invocable.
 
 | Skill | Phase | Description |
 |-------|-------|-------------|

package/framework/skills/level-0-meta/morph-init/SKILL.md

@@ -218,7 +218,7 @@ And inform the user:
   → morph-spec will use vsa-architect + contracts-vsa.cs for features
 ```
 
-> This key is what activates `vsa-architect` instead of `domain-architect` during `/morph-proposal`.
+> This key is what activates `vsa-architect` instead of `domain-architect` during `/morph:proposal`.
 
 **If the project doesn't exist yet (new VSA project from scratch)**, also inform:
 
@@ -377,5 +377,5 @@ Before printing the summary, check `~/.claude/settings.local.json` for `env.CLAU
 [If any plugin was newly installed:]
 ○ Restart Claude Code to activate newly installed plugins.
 
-Next: /morph-proposal [feature-name]
+Next: /morph:proposal [feature-name]
 ```

package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md

@@ -4,12 +4,12 @@ description: MORPH-SPEC Phase 3 (Clarify). Iterative clarification loop driven b
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.10.2"
+cliVersion: "4.10.4"
 ---
 
 # MORPH Clarify — Phase 3
 
-> INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
+> INTERNAL: Workflow skill used by /morph:proposal during automated phase orchestration. Not a user command.
 
 Eliminate spec ambiguities through an iterative question loop until the spec has sufficient quality to generate tasks.
 

package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md

@@ -3,7 +3,7 @@ name: morph:phase-codebase-analysis
 description: MORPH-SPEC Design sub-phase that analyzes existing codebase and database schema, producing schema-analysis.md with real column names, types, relationships, and field mismatches. Use at the start of Design phase before generating contracts.cs to prevent incorrect field names or types.
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.10.2"
+cliVersion: "4.10.4"
 ---
 
 # MORPH Codebase Analysis - Design Sub-phase

package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md

@@ -4,12 +4,12 @@ description: MORPH-SPEC Phase 2 (Design). Schema-first interactive design: reads
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion, Agent
-cliVersion: "4.10.2"
+cliVersion: "4.10.4"
 ---
 
 # MORPH Design — Phase 2
 
-> INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
+> INTERNAL: Workflow skill used by /morph:proposal during automated phase orchestration. Not a user command.
 
 Schema-first interactive design: read the real schema, validate with user, generate blueprint, produce artifacts through a quality loop.
 

package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md

@@ -6,13 +6,13 @@ disable-model-invocation: true
 context: fork
 agent: general-purpose
 user-invocable: false
-cliVersion: "4.10.2"
+cliVersion: "4.10.4"
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion, Agent
 ---
 
 # MORPH Implement — Phase 5
 
-> INTERNAL: Workflow skill used by /morph-apply during automated phase orchestration. Not a user command.
+> INTERNAL: Workflow skill used by /morph:apply during automated phase orchestration. Not a user command.
 
 Implement the tasks defined in Phase 4, with checkpoints every 3 tasks and a final recap.
 
@@ -98,7 +98,7 @@ Before starting tasks, verify that MCPs needed for the implement phase are worki
 Use `AskUserQuestion` with header `"{MCP}"` and options:
 - **Continue without {MCP}** — Show `fallback` from registry. Implementation will use the fallback automatically.
 - **Reconfigure credentials** — Collect credentials and update `.claude/settings.local.json`. Re-test after reconfiguring.
-- **Stop implementation** — Abort. User must fix the MCP and re-run `/morph-apply`.
+- **Stop implementation** — Abort. User must fix the MCP and re-run `/morph:apply`.
 
 > **Design:** This check is fail-open — consistent with morph-spec philosophy. The user gets explicit choice instead of tasks failing silently.
 

package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md

@@ -5,12 +5,12 @@ argument-hint: "[feature-name]"
 disable-model-invocation: true
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.10.2"
+cliVersion: "4.10.4"
 ---
 
 # MORPH Plan — Phase 4
 
-> INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
+> INTERNAL: Workflow skill used by /morph:proposal during automated phase orchestration. Not a user command.
 
 Generate a detailed implementation plan with exact paths, TDD code, and execution strategy.
 

package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md

@@ -4,12 +4,12 @@ description: MORPH-SPEC Phase 1 (Setup). Reads project context, detects tech sta
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.10.2"
+cliVersion: "4.10.4"
 ---
 
 # MORPH Setup — Phase 1
 
-> INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
+> INTERNAL: Workflow skill used by /morph:proposal during automated phase orchestration. Not a user command.
 
 Initialize the context and prepare the environment for an approved feature.
 
@@ -151,6 +151,26 @@ MCP Readiness:
 
 ---
 
+### Step 2.9: Check for Missing Agents
+
+Run a quick check to verify all expected agents are installed for this project's stack:
+
+```bash
+npx morph-spec doctor 2>&1 | grep -A 1 "agents completeness"
+```
+
+If the output shows **missing agents**, inform the user:
+
+> ⚠ Some agents for your stack are not installed. Run `npx morph-spec init --force` to install them.
+
+Use `AskUserQuestion` with header `"Agents"` and options:
+- **Install now** — run `npx morph-spec init --force` to reinstall with current stack tags
+- **Continue without** — proceed with available agents (may lack specialized support)
+
+If "Install now" is selected, run the command and continue.
+
+---
+
 ### Step 3: Confirm Stack
 
 Based on the proposal and context, confirm:

package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md

@@ -5,12 +5,12 @@ argument-hint: "[feature-name]"
 disable-model-invocation: true
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.10.2"
+cliVersion: "4.10.4"
 ---
 
 # MORPH Tasks — Phase 4
 
-> INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
+> INTERNAL: Workflow skill used by /morph:proposal during automated phase orchestration. Not a user command.
 
 Break the approved specification into executable tasks, define execution order, and establish checkpoints.
 
@@ -309,4 +309,4 @@ Use `AskUserQuestion` to capture explicit approval before advancing. This gate p
 
 ---
 
-After approval: "Planning complete! Run `/morph-apply $ARGUMENTS` to start implementation."
+After approval: "Planning complete! Run `/morph:apply $ARGUMENTS` to start implementation."

package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md

@@ -4,12 +4,12 @@ description: MORPH-SPEC Phase 1.5 (UI/UX). Creates design-system.md, mockups.md,
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.10.2"
+cliVersion: "4.10.4"
 ---
 
 # MORPH UI/UX Design - Phase 1.5
 
-> INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
+> INTERNAL: Workflow skill used by /morph:proposal during automated phase orchestration. Not a user command.
 
 Conditional phase for features with front-end. Collects UI/UX requirements, generates wireframes, component specs, and user flows.
 

package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md

@@ -4,6 +4,7 @@ description: Guided workflow for mid-implementation scope escalation — analyze
 user-invocable: true
 argument-hint: "[feature-name]"
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
+cliVersion: "4.10.4"
 ---
 
 # Scope Escalation Workflow
@@ -132,7 +133,7 @@ npx morph-spec scope escalate <feature> --task <id> --reason "<reason>" --target
 
 After escalation:
 
-- **If regressed to tasks:** "Re-analyze the affected tasks. Rewrite tasks.md with accurate scope. Run `/morph-proposal <feature>` to continue from the tasks phase."
+- **If regressed to tasks:** "Re-analyze the affected tasks. Rewrite tasks.md with accurate scope. Run `/morph:proposal <feature>` to continue from the tasks phase."
 - **If regressed to design:** "Re-analyze the spec. Update spec.md with the discovered architecture. Then regenerate tasks."
 - **If expanded:** "Continue implementing. Use `morph-spec task start <feature> <sub-task-id>` to start the first sub-task."
 

package/framework/standards/ai-agents/team-orchestration.md

@@ -406,7 +406,7 @@ morph-spec state set {feature} workflow full-morph
 
 ```bash
 # FASES 0-4: Single Claude session
-/morph-proposal scheduled-reports
+/morph:proposal scheduled-reports
 # ... proposal approved, design approved, tasks generated ...
 
 # FASE 5: Create agent team

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "4.10.2",
+  "version": "4.10.4",
   "description": "MORPH-SPEC: AI-First development framework with validation pipeline and multi-stack support",
   "keywords": [
     "claude-code",

package/src/commands/project/doctor.js

@@ -12,6 +12,8 @@ import {
   getInstalledCLIVersion
 } from '../../utils/version-checker.js';
 import { resetMorphSettings } from '../../utils/claude-settings-manager.js';
+import { checkMissingAgents } from '../../utils/agents-installer.js';
+import { getProjectTags } from '../../lib/stack-filter.js';
 
 const isWindows = platform() === 'win32';
 /**
@@ -687,11 +689,32 @@ export async function doctorCommand(options = {}) {
       }
 
       // Check .claude/agents/
-      const agentsPath = join(claudePath, 'agents');
-      if (await pathExists(agentsPath)) {
-        const agentFiles = await fs.readdir(agentsPath);
+      const agentsPathClaude = join(claudePath, 'agents');
+      if (await pathExists(agentsPathClaude)) {
+        const agentFiles = await fs.readdir(agentsPathClaude);
         const morphAgents = agentFiles.filter(f => f.startsWith('morph-') && f.endsWith('.md'));
         checks.push({ name: '.claude/agents/', status: 'ok', msg: `${morphAgents.length} agents` });
+
+        // Check for missing agents based on stack tags
+        try {
+          const config = await readJson(configPath);
+          const projectTags = getProjectTags(config);
+          if (projectTags.length > 0) {
+            const frameworkDir = join(import.meta.dirname, '..', '..', '..', 'framework');
+            const { missing } = checkMissingAgents(targetPath, frameworkDir, projectTags);
+            if (missing.length > 0) {
+              const names = missing.map(m => m.name).join(', ');
+              checks.push({
+                name: 'agents completeness',
+                status: 'warn',
+                msg: `${missing.length} agent(s) missing for [${projectTags.join(', ')}]: ${names} — run morph-spec init --force`
+              });
+              hasWarnings = true;
+            } else {
+              checks.push({ name: 'agents completeness', status: 'ok', msg: `all agents for [${projectTags.join(', ')}]` });
+            }
+          }
+        } catch { /* config not readable — skip completeness check */ }
       } else {
         checks.push({ name: '.claude/agents/', status: 'warn', msg: 'missing — run morph-spec update' });
         hasWarnings = true;
@@ -757,7 +780,7 @@ export async function doctorCommand(options = {}) {
       } catch { /* non-fatal */ }
 
       // ── Claude Code Plugins ──────────────────────────────────────────────────
-      console.log(chalk.cyan('\n  Claude Code Plugins (required for /morph-init)'));
+      console.log(chalk.cyan('\n  Claude Code Plugins (required for /morph:init)'));
       const pluginsFile = join(homedir(), '.claude', 'plugins', 'installed_plugins.json');
       let pluginData = { plugins: {} };
       try {

package/src/commands/project/init.js

@@ -1,4 +1,5 @@
-import { join } from 'path';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
 import { homedir } from 'os';
 import fs from 'fs-extra';
 import ora from 'ora';
@@ -22,7 +23,10 @@ import {
   generateSetupInstructions,
   formatMcpStatusTable
 } from '../../lib/installers/mcp-installer.js';
-import { setupInfra } from '../../scripts/setup-infra.js';
+import { setupInfra, installRulesForStack } from '../../scripts/setup-infra.js';
+import { installSkills } from '../../utils/skills-installer.js';
+import { installAgents, installDomainAgents } from '../../utils/agents-installer.js';
+import { getProjectTags } from '../../lib/stack-filter.js';
 
 export async function initCommand(options) {
   const targetPath = options.path || process.cwd();
@@ -147,6 +151,9 @@ export async function initCommand(options) {
           if (structure?.uiLibrary) {
             config.project.uiLibrary = structure.uiLibrary;
           }
+          if (structure?.integrations?.length > 0) {
+            config.project.integrations = structure.integrations;
+          }
           await writeJson(configPath, config);
 
           spinner.stop();
@@ -155,6 +162,7 @@ export async function initCommand(options) {
           logger.info(`Stack detected: ${structure.stack}`);
           if (structure?.architecture) logger.dim(`Architecture: ${structure.architecture}`);
           if (structure?.uiLibrary) logger.dim(`UI Library: ${structure.uiLibrary}`);
+          if (structure?.integrations?.length > 0) logger.dim(`Integrations: ${structure.integrations.join(', ')}`);
 
           const { standardsChoice } = await inquirer.prompt([{
             type: 'list',
@@ -175,6 +183,28 @@ export async function initCommand(options) {
             logger.dim('Review and edit .morph/context/standards.md as needed.');
           }
 
+          // Re-install stack-filtered assets now that we know the stack
+          const stackTags = getProjectTags(config);
+          if (stackTags.length > 0) {
+            spinner.start('Re-installing stack-filtered assets...');
+            const frameworkDir = join(targetPath, '.morph', 'framework');
+            const fwSrcDir = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..', 'framework');
+
+            // Rules
+            const rulesSrc = join(fwSrcDir, 'rules');
+            const rulesDest = join(targetPath, '.claude', 'rules');
+            installRulesForStack(rulesSrc, rulesDest, stackTags);
+
+            // Skills
+            await installSkills(targetPath, { projectTags: stackTags });
+
+            // Agents (tier 1/2/4 from agents.json + domain agents)
+            await installAgents(targetPath, fwSrcDir, { projectTags: stackTags });
+            await installDomainAgents(targetPath, fwSrcDir, { projectTags: stackTags });
+
+            spinner.succeed(`Stack-filtered assets reinstalled for [${stackTags.join(', ')}]`);
+          }
+
           spinner.start('Continuing...');
         }
       } catch (error) {
@@ -385,7 +415,7 @@ export async function initCommand(options) {
     // Suggest tutorial for first-time users
     if (integrationsCreated) {
       logger.blank();
-      logger.info('First time using morph-spec? Run `/morph-proposal <feature>` to start a new feature.');
+      logger.info('First time using morph-spec? Run `/morph:proposal <feature>` to start a new feature.');
     }
 
     logger.blank();

package/src/commands/state/advance-phase.js

@@ -468,38 +468,38 @@ export async function advancePhaseCommand(feature, options = {}) {
 function getPhaseGuidance(phase, feature) {
   const guides = {
     'setup': [
-      `Resume spec pipeline: /morph-proposal ${feature}`,
+      `Resume spec pipeline: /morph:proposal ${feature}`,
       'Auto-continues from setup phase'
     ],
     'uiux': [
-      `Resume spec pipeline: /morph-proposal ${feature}`,
+      `Resume spec pipeline: /morph:proposal ${feature}`,
       'Provide layout references and preferences',
       'Review wireframes before proceeding'
     ],
     'design': (() => {
       const { isDotnet } = getStackProfile();
       return [
-        `Resume spec pipeline: /morph-proposal ${feature}`,
+        `Resume spec pipeline: /morph:proposal ${feature}`,
         'Review DECISION POINTS carefully',
         isDotnet ? 'Approve spec.md and contracts.cs' : 'Approve spec.md and contracts.ts (TypeScript + Zod schemas)'
       ];
     })(),
     'clarify': [
-      `Resume spec pipeline: /morph-proposal ${feature}`,
+      `Resume spec pipeline: /morph:proposal ${feature}`,
       'Resolve edge cases and unknowns'
     ],
     'plan': [
-      `Resume spec pipeline: /morph-proposal ${feature}`,
+      `Resume spec pipeline: /morph:proposal ${feature}`,
       'Review implementation plan for completeness',
       'Approve plan before generating task breakdown'
     ],
     'tasks': [
-      `Resume spec pipeline: /morph-proposal ${feature}`,
+      `Resume spec pipeline: /morph:proposal ${feature}`,
       'Review task order and dependencies',
       'Approve task list before implementing'
     ],
     'implement': [
-      `Start implementing: /morph-apply ${feature}`,
+      `Start implementing: /morph:apply ${feature}`,
       'Complete tasks one by one with: morph-spec task done',
       'Validators run automatically on task completion'
     ],

package/src/lib/detectors/index.js

@@ -29,21 +29,28 @@ export function detectProject(targetPath, opts = {}) {
 
   try {
     // ── Package.json analysis ──────────────────────────────────────────────
-    const pkgPath = join(targetPath, 'package.json');
-    let pkg = null;
-    if (existsSync(pkgPath)) {
+    // Collect deps from root and common monorepo subfolders
+    const pkgLocations = ['.', 'src/frontend', 'frontend', 'apps/web', 'packages/app'];
+    const allDeps = {};
+    let rootPkg = null;
+    let scripts = [];
+    for (const loc of pkgLocations) {
+      const pkgPath = join(targetPath, loc, 'package.json');
+      if (!existsSync(pkgPath)) continue;
       try {
-        pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        if (loc === '.') rootPkg = pkg;
+        Object.assign(allDeps, pkg.dependencies, pkg.devDependencies);
+        scripts.push(...Object.keys(pkg.scripts || {}));
+        // Track frontend path for config
+        if (loc !== '.' && (pkg.dependencies?.next || pkg.dependencies?.react || pkg.dependencies?.vue)) {
+          structure.frontendPath = loc;
+        }
       } catch { /* invalid JSON */ }
     }
+    const depNames = Object.keys(allDeps);
 
-    if (pkg) {
-      const allDeps = {
-        ...pkg.dependencies,
-        ...pkg.devDependencies,
-      };
-      const depNames = Object.keys(allDeps);
-      const scripts = Object.keys(pkg.scripts || {});
+    if (depNames.length > 0) {
 
       // Stack detection from deps
       if (depNames.includes('next')) {
@@ -54,12 +61,12 @@ export function detectProject(targetPath, opts = {}) {
         structure.stack = 'vue';
       } else if (depNames.includes('express') || depNames.includes('fastify') || depNames.includes('hono')) {
         structure.stack = 'nodejs';
-      } else if (pkg.name) {
+      } else if (rootPkg?.name) {
         structure.stack = 'nodejs';
       }
 
       // UI library detection
-      if (existsSync(join(targetPath, 'components.json')) || depNames.includes('@shadcn/ui')) {
+      if (existsSync(join(targetPath, 'components.json')) || existsSync(join(targetPath, structure.frontendPath || '.', 'components.json')) || depNames.includes('@shadcn/ui')) {
         structure.uiLibrary = 'shadcn';
       } else if (depNames.some(d => d.includes('mudblazor'))) {
         structure.uiLibrary = 'mudblazor';
@@ -79,36 +86,57 @@ export function detectProject(targetPath, opts = {}) {
       }
 
       // Vercel detection
-      if (depNames.includes('vercel') || scripts.includes('vercel') ||
-          scripts.some(s => (pkg.scripts[s] || '').includes('vercel'))) {
+      if (depNames.includes('vercel') || scripts.includes('vercel')) {
         structure.hasVercel = true;
       }
     }
 
     // ── .csproj detection ──────────────────────────────────────────────────
-    if (structure.stack === 'unknown') {
-      // Check for .csproj in common locations
-      const csprojLocations = ['.', 'src', 'src/Api', 'src/Web'];
-      for (const loc of csprojLocations) {
-        try {
-          const dir = join(targetPath, loc);
-          if (existsSync(dir)) {
-            const entries = readdirSyncSafe(dir);
-            if (entries.some(e => e.endsWith('.csproj'))) {
-              structure.stack = 'dotnet';
-              // Check for Blazor
-              for (const entry of entries.filter(e => e.endsWith('.csproj'))) {
-                try {
-                  const content = readFileSync(join(dir, entry), 'utf8');
-                  if (content.includes('Microsoft.AspNetCore.Components') || content.includes('Blazor')) {
-                    structure.stack = 'blazor';
-                  }
-                } catch { /* ignore */ }
-              }
-              break;
-            }
+    let hasDotnet = false;
+    let hasBlazer = false;
+    const csprojLocations = ['.', 'src', 'src/Api', 'src/Web', 'src/backend'];
+
+    function checkCsproj(filePath) {
+      hasDotnet = true;
+      try {
+        const content = readFileSync(filePath, 'utf8');
+        if (content.includes('Microsoft.AspNetCore.Components') || content.includes('Blazor')) {
+          hasBlazer = true;
+        }
+        if (content.includes('Hangfire')) {
+          if (!structure.integrations.includes('hangfire')) structure.integrations.push('hangfire');
+        }
+      } catch { /* ignore */ }
+    }
+
+    for (const loc of csprojLocations) {
+      try {
+        const dir = join(targetPath, loc);
+        if (!existsSync(dir)) continue;
+        const entries = readdirSyncSafe(dir);
+        // Direct .csproj files
+        for (const e of entries.filter(f => f.endsWith('.csproj'))) {
+          checkCsproj(join(dir, e));
+        }
+        // One level deeper (e.g., src/backend/MyProject/*.csproj)
+        for (const sub of entries) {
+          const subDir = join(dir, sub);
+          for (const e of readdirSyncSafe(subDir).filter(f => f.endsWith('.csproj'))) {
+            checkCsproj(join(subDir, e));
           }
-        } catch { /* ignore */ }
+        }
+      } catch { /* ignore */ }
+    }
+
+    // Determine stack: monorepo (nextjs+dotnet), blazor, dotnet, or keep frontend stack
+    if (hasDotnet) {
+      if (structure.stack === 'nextjs' || structure.stack === 'react' || structure.stack === 'vue') {
+        // Monorepo: frontend + .NET backend
+        structure.stack = `${structure.stack}+dotnet`;
+      } else if (hasBlazer) {
+        structure.stack = 'blazor';
+      } else if (structure.stack === 'unknown') {
+        structure.stack = 'dotnet';
       }
     }
 
@@ -137,7 +165,27 @@ export function detectProject(targetPath, opts = {}) {
     if (existsSync(join(targetPath, 'docker-compose.yml')) ||
         existsSync(join(targetPath, 'docker-compose.yaml')) ||
         existsSync(join(targetPath, 'Dockerfile'))) {
-      structure.integrations.push('docker');
+      if (!structure.integrations.includes('docker')) structure.integrations.push('docker');
+    }
+
+    // ── Azure detection ────────────────────────────────────────────────────
+    const azureSignals = [
+      '.azure',
+      'azure-pipelines.yml',
+      'infra/main.bicep',
+      'infra',
+    ];
+    const hasAzure = azureSignals.some(signal => {
+      const p = join(targetPath, signal);
+      if (!existsSync(p)) return false;
+      if (signal === 'infra') {
+        // Check for .bicep files inside infra/
+        return readdirSyncSafe(p).some(f => f.endsWith('.bicep'));
+      }
+      return true;
+    });
+    if (hasAzure && !structure.integrations.includes('azure')) {
+      structure.integrations.push('azure');
     }
   } catch {
     // Fail-safe — return defaults

package/src/lib/stack-filter.js

@@ -37,13 +37,20 @@ export function parseStacks(content) {
 }
 
 /**
- * Extract project stack tags from config object.
- * Splits `project.stack` by '-' or '+' to produce tag array.
+ * Extract project tags from config object.
+ * Combines stack tags (from `project.stack` split by '-' or '+')
+ * with integration tags (from `project.integrations` array).
+ * Deduplicates the result.
  */
 export function getProjectTags(config) {
   const stack = config?.project?.stack;
-  if (!stack || typeof stack !== 'string') return [];
-  return stack.split(/[-+]/).filter(Boolean);
+  const stackTags = (stack && typeof stack === 'string')
+    ? stack.split(/[-+]/).filter(Boolean)
+    : [];
+  const integrations = Array.isArray(config?.project?.integrations)
+    ? config.project.integrations
+    : [];
+  return [...new Set([...stackTags, ...integrations])];
 }
 
 /**

package/src/scripts/setup-infra.js

@@ -3,7 +3,7 @@
  *
  * Headless infrastructure setup for MORPH-SPEC.
  * Extracted from init.js (steps 1-10) so it can be called by the
- * /morph-init Claude Code skill via `morph-spec setup-infra` without
+ * /morph:init Claude Code skill via `morph-spec setup-infra` without
  * interactive prompts or stack detection.
  *
  * Usage:
@@ -212,7 +212,7 @@ export async function setupInfra(targetPath, { _exec = execSync } = {}) {
 
   // --- 12. installAgents ---
   log('Step 12: Installing agents...');
-  const agentCounts = await installAgents(targetPath, FRAMEWORK_DIR, { projectStack: null });
+  const agentCounts = await installAgents(targetPath, FRAMEWORK_DIR, { projectTags });
 
   // --- 13. installDomainAgents (filtered by stack) ---
   log('Step 13: Installing domain agents...');

package/src/utils/agents-installer.js

@@ -22,7 +22,7 @@ import { parseStacks, shouldInstall } from '../lib/stack-filter.js';
  * @param {string|null} options.projectStack - Detected project stack (e.g. 'nextjs', 'blazor')
  */
 export async function installAgents(projectDir, frameworkDir = 'framework', options = {}) {
-  const { projectStack = null } = options;
+  const { projectTags = [] } = options;
 
   const agentsJsonPath = join(frameworkDir, 'agents.json');
   const agentsJson = JSON.parse(readFileSync(agentsJsonPath, 'utf-8'));
@@ -38,21 +38,30 @@ export async function installAgents(projectDir, frameworkDir = 'framework', opti
   const targetDir = join(projectDir, '.claude', 'agents');
   mkdirSync(targetDir, { recursive: true });
 
-  const DOTNET_STACKS = ['dotnet', 'blazor', 'dotnet-api', 'fullstack'];
   const eligible = agents.filter(a => {
     if (a.tier !== 1 && a.tier !== 2 && a.tier !== 4) return false;
     // Tier 4 validators must have a teammate with spawn_prompt
     if (a.tier === 4 && !a.teammate?.spawn_prompt) return false;
-    // Skip dotnet-senior for non-.NET projects
-    if (a.id === 'dotnet-senior' && projectStack && !DOTNET_STACKS.includes(projectStack)) {
-      return false;
-    }
+    // Filter by stacks if the agent declares them
+    const stacks = a.stacks ?? [];
+    if (!shouldInstall(stacks, projectTags)) return false;
     return true;
   });
 
   let tier1 = 0;
   let tier2 = 0;
   let tier4 = 0;
+  const installed = new Set();
+
+  // Build the full set of possible filenames for orphan cleanup
+  const allPossible = new Set();
+  for (const a of agents) {
+    if (a.tier !== 1 && a.tier !== 2 && a.tier !== 4) continue;
+    const slug = a.id ?? a.name?.toLowerCase().replace(/\s+/g, '-');
+    const prefix = a.tier === 4 ? 'morph-validator-' : 'morph-';
+    allPossible.add(`${prefix}${slug}.md`);
+  }
+
   for (const agent of eligible) {
     const slug = agent.id ?? agent.name?.toLowerCase().replace(/\s+/g, '-');
     const prefix = agent.tier === 4 ? 'morph-validator-' : 'morph-';
@@ -65,11 +74,20 @@ export async function installAgents(projectDir, frameworkDir = 'framework', opti
     const frontmatter = buildFrontmatter(agent, description);
     const content = `---\n${frontmatter}---\n\n${body}\n`;
     writeFileSync(targetPath, content, 'utf-8');
+    installed.add(filename);
 
     if (agent.tier === 1) tier1++;
     else if (agent.tier === 2) tier2++;
     else if (agent.tier === 4) tier4++;
   }
+
+  // Cleanup orphan morph-* / morph-validator-* files that were filtered out
+  for (const file of readdirSync(targetDir)) {
+    if (allPossible.has(file) && !installed.has(file)) {
+      unlinkSync(join(targetDir, file));
+    }
+  }
+
   return { tier1, tier2, tier4 };
 }
 
@@ -259,3 +277,69 @@ export async function installDomainAgents(projectDir, frameworkDir = 'framework'
 
   return { specialists };
 }
+
+/**
+ * Check which agents SHOULD be installed but are NOT.
+ * Returns a list of missing agent names with their source (agents.json or domain).
+ *
+ * @param {string} projectDir - Target project directory
+ * @param {string} frameworkDir - Path to morph-spec framework/ directory
+ * @param {string[]} projectTags - Stack + integration tags
+ * @returns {{ missing: Array<{ name: string, stacks: string[], source: string }>, installed: number, expected: number }}
+ */
+export function checkMissingAgents(projectDir, frameworkDir, projectTags = []) {
+  const targetDir = join(projectDir, '.claude', 'agents');
+  const installedFiles = new Set();
+  if (existsSync(targetDir)) {
+    for (const f of readdirSync(targetDir)) installedFiles.add(f);
+  }
+
+  const missing = [];
+  let expected = 0;
+
+  // Check tier 1/2/4 from agents.json
+  const agentsJsonPath = join(frameworkDir, 'agents.json');
+  if (existsSync(agentsJsonPath)) {
+    const agentsJson = JSON.parse(readFileSync(agentsJsonPath, 'utf-8'));
+    const agentsRaw = agentsJson.agents ?? agentsJson;
+    const agents = Array.isArray(agentsRaw)
+      ? agentsRaw
+      : Object.entries(agentsRaw)
+          .filter(([key]) => !key.startsWith('_comment'))
+          .map(([id, data]) => ({ id, ...data }));
+
+    for (const a of agents) {
+      if (a.tier !== 1 && a.tier !== 2 && a.tier !== 4) continue;
+      if (a.tier === 4 && !a.teammate?.spawn_prompt) continue;
+      const stacks = a.stacks ?? [];
+      if (!shouldInstall(stacks, projectTags)) continue;
+
+      expected++;
+      const slug = a.id ?? a.name?.toLowerCase().replace(/\s+/g, '-');
+      const prefix = a.tier === 4 ? 'morph-validator-' : 'morph-';
+      const filename = `${prefix}${slug}.md`;
+      if (!installedFiles.has(filename)) {
+        missing.push({ name: a.title ?? slug, stacks, source: `tier-${a.tier}` });
+      }
+    }
+  }
+
+  // Check domain agents
+  const domainsDir = join(frameworkDir, 'agents');
+  if (existsSync(domainsDir)) {
+    for (const filePath of collectSkillFiles(domainsDir)) {
+      const raw = readFileSync(filePath, 'utf-8');
+      const { name, stacks } = parseSkillFile(raw);
+      if (!name) continue;
+      if (!shouldInstall(stacks, projectTags)) continue;
+
+      expected++;
+      const filename = `morph-domain-${name}.md`;
+      if (!installedFiles.has(filename)) {
+        missing.push({ name, stacks, source: 'domain' });
+      }
+    }
+  }
+
+  return { missing, installed: installedFiles.size, expected };
+}