@polymorphism-tech/morph-spec 4.12.0 → 4.14.0

package/CLAUDE.md

@@ -51,16 +51,16 @@ No build step — pure ESM JavaScript, runs directly via Node.js 18+.
   - `installers/` — Agents, skills, hooks installers for target projects
 - **`src/utils/`** — Shared utilities (logger, banner, file-copier, claude-settings-manager, etc.)
 - **`framework/`** — Metadata installed into target projects (READ-ONLY at runtime):
-  - `agents.json` (v4.0.0, 46 agents in 4 tiers)
-  - `phases.json` (8 phases + sync)
-  - `standards/STANDARDS.json` (86 entries)
-  - `hooks/claude-code/` — Hook scripts (10 hooks, fail-open design)
+  - `agents.json` (v4.0.0)
+  - `phases.json` (7 phases incl. sync)
+  - `standards/STANDARDS.json`
+  - `hooks/claude-code/` — Hook scripts (fail-open design)
   - `skills/` — Morph skills (level-0-meta + level-1-workflows)
   - `templates/` — Handlebars templates for code generation
 
 ### Key Architectural Patterns
 
-**Dual-layer phase tracking:** Phase is derived from filesystem (`derivePhase()` scans for highest-numbered phase folder) — state.json only overrides for lightweight phases (setup, clarify, sync).
+**Dual-layer phase tracking:** Phase is derived from filesystem (`derivePhase()` scans for highest-numbered phase folder) — state.json only overrides for lightweight phases (sync).
 
 **Output schema as single source of truth:** `src/core/paths/output-schema.js` defines all output types. Run `npm run generate` after modifying it to update derived reference files.
 
@@ -70,12 +70,12 @@ No build step — pure ESM JavaScript, runs directly via Node.js 18+.
 
 **Atomic state writes:** `state-manager.js` writes to a process-ID temp file then renames, preventing corruption from concurrent CLI invocations.
 
-**Stack-aware filtering:** Assets declare `stacks: ['dotnet', 'blazor']` in YAML frontmatter. `setup-infra.js` reads `config.json → project.stack`, splits into tags, and installs only matching assets. `stacks: ['*']` = universal.
+**Stack-aware filtering:** Assets declare `stacks: ['dotnet']` in YAML frontmatter. `setup-infra.js` reads `config.json → project.stack`, splits into tags, and installs only matching assets. `stacks: ['*']` = universal.
 
 ### Phase Sequence
 
 ```
-proposal → setup → [uiux] → design → clarify → plan → tasks → implement → [sync]
+proposal → [uiux] → design → plan → tasks → implement → [sync]
 ```
 
 Phases in brackets are optional. Approval gates exist at: proposal, design, plan, tasks, uiux.

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.12.0  
+**Version:** 4.14.0  
 **Requires:** Node.js 18+, Claude Code
 
 ---
@@ -61,22 +61,22 @@ your-project/
 │   ├── config/
 │   │   └── config.json              # Project configuration
 │   ├── framework/
-│   │   ├── agents.json              # 38 agents in 4 tiers (READ-ONLY)
+│   │   ├── agents.json              # 22 agents in 4 tiers (READ-ONLY)
 │   │   ├── standards/               # Coding and architecture standards (READ-ONLY)
 │   │   └── templates/               # Code and IaC templates (READ-ONLY)
 │   ├── context/                     # Project context (README.md, standards.md)
 │   ├── features/                    # Active features
 │   │   └── {feature}/
 │   │       ├── 0-proposal/          # User story + acceptance criteria
-│   │       ├── 1-design/            # Technical spec, contracts, decisions
-│   │       ├── 2-ui/                # UI/UX design (optional, UI-heavy features)
+│   │       ├── 1-ui/                # UI/UX design (optional, UI-heavy features)
+│   │       ├── 2-design/            # Technical spec, contracts, decisions
 │   │       ├── 3-tasks/             # Atomic task list
 │   │       └── 4-implement/         # Recap and implementation notes
 │   └── state.json                   # READ-ONLY — managed by CLI only
 └── .claude/
     ├── commands/                    # Slash commands
     ├── skills/                      # Framework skills (flat .md files)
-    ├── agents/                      # Native subagents (38 agents)
+    ├── agents/                      # Native subagents (22 agents)
     ├── rules/                       # Path-scoped standards rules
     └── settings.local.json          # Hooks configuration (10 hooks)
 ```
@@ -88,7 +88,7 @@ your-project/
 Features move through structured phases. Some are optional depending on feature type.
 
 ```
-proposal → setup → [uiux] → design → clarify → tasks → implement → [sync]
+proposal → [uiux] → design → plan → tasks → implement → [sync]
 ```
 
 Phases in brackets are optional. `uiux` applies to UI-heavy features. `sync` is a post-implementation reconciliation step.
@@ -99,16 +99,18 @@ Phases in brackets are optional. `uiux` applies to UI-heavy features. `sync` is
 | Phase     | Directory      | Key files                                                     |
 | --------- | -------------- | ------------------------------------------------------------- |
 | Proposal  | `0-proposal/`  | `proposal.md`                                                 |
-| Design    | `1-design/`    | `spec.md`, `contracts.cs`, `decisions.md`                     |
-| UI/UX     | `2-ui/`        | `design-system.md`, `mockups.md`, `components.md`, `flows.md` |
-| Tasks     | `3-tasks/`     | `tasks.md`                                                    |
-| Implement | `4-implement/` | `recap.md`                                                    |
+| UI/UX     | `1-ui/`        | `design-system.md`, `mockups.md`, `components.md`, `flows.md` |
+| Design    | `2-design/`    | `spec.md`, `contracts.cs`, `decisions.md`                     |
+| Plan      | `3-plan/`      | `plan.md`                                                     |
+| Tasks     | `4-tasks/`     | `tasks.md`                                                    |
+| Implement | `5-implement/` | `recap.md`                                                    |
 
 
 ### Approval gates
 
-- **Design gate** — Spec must be approved before moving to Tasks.
-- **Implementation gate** — Task list must be approved before implementation starts.
+- **Design gate** — Spec must be approved before moving to Plan.
+- **Plan gate** — Plan must be approved before moving to Tasks.
+- **Tasks gate** — Task list must be approved before implementation starts.
 
 Check gate status:
 
@@ -154,7 +156,6 @@ morph-spec state set {feature} {key} {value}
 morph-spec phase advance {feature}     # Advance to next phase
 morph-spec task done {feature}         # Mark current task complete
 morph-spec task start {feature}        # Start next task
-morph-spec task next {feature}         # Preview next task
 morph-spec status {feature}            # Feature status dashboard
 ```
 
@@ -170,51 +171,48 @@ morph-spec validate-feature {feature}  # Content-aware feature validation
 
 ## Agent hierarchy
 
-morph-spec includes 38 agents organized in 4 tiers (3+4+26+5). Tier 1-2 agents are installed as native Claude Code subagents in `.claude/agents/`. Tier 3 domain agents are installed as `.claude/agents/morph-domain-{name}.md`.
+morph-spec includes 22 agents organized in 4 tiers (2+3+13+4). Tier 1-2 agents are installed as native Claude Code subagents in `.claude/agents/`. Tier 3 domain agents are installed as `.claude/agents/morph-domain-{name}.md`.
 
-### Tier 1 — Orchestrators (3)
+### Tier 1 — Orchestrators (2)
 
 
 | Agent                 | Role                                                   | Active    |
 | --------------------- | ------------------------------------------------------ | --------- |
 | `standards-architect` | Chief Architect — enforces standards across all phases | Always    |
 | `ai-system-architect` | AI/Agent system design and orchestration               | On-demand |
-| `po-pm-advisor`       | Product and project advisory                           | On-demand |
 
 
-### Tier 2 — Domain Leaders (4)
+### Tier 2 — Domain Leaders (3)
 
 
 | Agent              | Squad                     | Active    |
 | ------------------ | ------------------------- | --------- |
 | `dotnet-senior`    | Backend squad lead        | Always    |
+| `nextjs-expert`    | Frontend squad lead       | Always    |
 | `infra-architect`  | Infrastructure squad lead | Always    |
-| `domain-architect` | DDD & domain modeling     | On-demand |
-| `ui-designer`      | UI/UX squad lead          | On-demand |
 
 
-### Tier 3 — Specialists (26)
+### Tier 3 — Specialists (13)
 
 Organized into squads:
 
-**Backend (10):** C#/.NET specialists, EF Core, Dapper, SignalR, CQRS, Domain modeling, API design, Auth, Background services, Testing
+**Backend (6):** ef-modeler, hangfire-orchestrator, ms-agent-expert, supabase-expert, vector-search-expert, morph-spec-architect
 
-**Frontend (3):** Blazor components, Next.js/React, CSS/design system
+**Frontend (3):** css-specialist, ui-designer, seo-growth-hacker
 
-**Infrastructure (5):** Azure Bicep, CI/CD pipelines, Containerization, Monitoring, Cost optimization
+**Integrations (3):** asaas-financial, clerk-auth, resend-email
 
-**Quality/Cross (8):** Security review, Performance, Accessibility, Documentation, Code review, Migration, Integration, Data modeling
+**Security (1):** security-expert
 
-### Tier 4 — Validators (5)
+### Tier 4 — Validators (4)
 
 
 | Agent                          | Validates                               |
 | ------------------------------ | --------------------------------------- |
-| `security-expert`              | Security vulnerabilities and compliance |
 | `architecture-expert`          | Architectural decisions and constraints |
 | `packages-validator`           | Package versions and compatibility      |
 | `design-system-validator`      | Design system adherence                 |
-| `blazor-concurrency-validator` | Blazor thread safety and concurrency    |
+| `nextjs-component-validator`   | Next.js component structure and naming  |
 
 
 ---
@@ -235,7 +233,6 @@ Organized into squads:
 | `PostToolUseFailure` | `handle-tool-failure.js`   | Logs failures to `.morph/logs/tool-failures.log`                  |
 | `Stop`               | `validate-completion.js`   | Warns about incomplete tasks/missing outputs/pending gates        |
 | `PreCompact`         | `save-morph-context.js`    | Snapshots state to `.morph/memory/` before compaction             |
-| `Notification`       | `approval-reminder.js`     | Reminds about pending approval gates                              |
 
 
 Protected files (via `permissions.deny`):
@@ -268,11 +265,8 @@ Path-scoped rules are installed to `.claude/rules/` and activate automatically b
 | Technology                                  | Support                                          |
 | ------------------------------------------- | ------------------------------------------------ |
 | .NET 10 / ASP.NET Core                      | Full — C# contracts, EF Core, CQRS, Minimal API  |
-| Blazor (WebAssembly / Server / MAUI Hybrid) | Full — components, concurrency, design system    |
 | Next.js / React / TypeScript                | Full — components, routing, state management     |
-| Azure (Bicep)                               | Full — IaC templates, cost estimation, pipelines |
-| GitHub Actions                              | Full — CI/CD workflow templates                  |
-| Supabase                                    | Supported via MCP integration                    |
+| Supabase                                    | Supported via CLI (local Docker)                 |
 
 
 TypeScript strict mode is enforced by default. See `.morph/framework/standards/` for all coding standards.
@@ -302,7 +296,7 @@ After updating, run `morph-spec doctor` to confirm the installation is healthy.
 - `.morph/state.json` — use `morph-spec state set`
 - `.morph/framework/`** — read-only, updated by `morph-spec update`
 
-**Always document decisions.** Each feature has a `1-design/decisions.md`. Architectural choices go there, not in commit messages.
+**Always document decisions.** Each feature has a `2-design/decisions.md`. Architectural choices go there, not in commit messages.
 
 **Checkpoints every 3 tasks.** The framework auto-validates architecture compliance, package versions, and security after every third completed task.
 
@@ -370,4 +364,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v4.12.0 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v4.14.0 by [Polymorphism Tech](https://polymorphism.tech)*

package/bin/morph-spec.js

@@ -38,7 +38,7 @@ import {
 } from '../src/commands/agents/manage-agents.js';
 
 // Task commands
-import { taskDoneCommand, taskStartCommand, taskNextCommand, taskBulkStartCommand, taskBulkDoneCommand, taskAnnotateCommand } from '../src/commands/tasks/task.js';
+import { taskDoneCommand, taskStartCommand, taskBulkDoneCommand, taskAnnotateCommand } from '../src/commands/tasks/task.js';
 
 // Scope escalation commands
 import { scopeEscalateCommand } from '../src/commands/scope/escalate.js';
@@ -50,6 +50,9 @@ import { validateFeatureCommand } from '../src/commands/validation/validate-feat
 
 // Template commands
 import { templateRenderCommand } from '../src/commands/templates/template-render.js';
+
+// Scaffold commands
+import { scaffoldDotnetCommand, scaffoldNextjsCommand } from '../src/commands/scaffold/scaffold.js';
 // MCP commands
 import { mcpSetupCommand } from '../src/commands/mcp/mcp-setup.js';
 
@@ -59,8 +62,8 @@ import { trustStatusCommand, trustSetCommand } from '../src/commands/trust/trust
 // Project metrics
 import { projectMetricsCommand } from '../src/commands/agents/project-metrics.js';
 
-// Standards context budget
-import { contextBudgetCommand } from '../src/commands/standards/context-budget.js';
+// Context commands
+import { contextRefreshCommand } from '../src/commands/context/context-refresh.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
@@ -148,7 +151,7 @@ program
 // Task management commands (MORPH-SPEC 3.0)
 const taskCommand = program
   .command('task')
-  .description('Manage feature tasks (done | start | next)');
+  .description('Manage feature tasks (done | start | expand | annotate)');
 
 taskCommand
   .command('done <feature> <task-ids...>')
@@ -164,25 +167,12 @@ taskCommand
   .description('Start a task (mark as in_progress)')
   .action((feature, taskId, options) => taskStartCommand(feature, taskId, options));
 
-taskCommand
-  .command('next <feature>')
-  .description('Show next suggested task')
-  .action((feature, options) => taskNextCommand(feature, options));
-
 taskCommand
   .command('expand <feature> <task-id>')
   .description('Expand a task into sub-tasks (low-impact scope escalation)')
   .option('--into <subtasks...>', 'Sub-task definitions ("T017a: Title")')
   .action((feature, taskId, options) => taskExpandCommand(feature, taskId, options));
 
-taskCommand
-  .command('bulk-start <feature> [range]')
-  .description('Start multiple tasks at once (mark as in_progress)')
-  .option('--all', 'Start all pending tasks with met dependencies')
-  .option('--from <id>', 'Start of task range (e.g. T007)')
-  .option('--to <id>', 'End of task range (e.g. T014)')
-  .action((feature, range, options) => taskBulkStartCommand(feature, range, options));
-
 taskCommand
   .command('bulk-done <feature> [range]')
   .description('Complete multiple tasks with a single validation pass')
@@ -309,6 +299,28 @@ templateCommand
   .option('-v, --verbose', 'Show detailed output')
   .action(templateRenderCommand);
 
+// Scaffold commands (code generation from templates)
+const scaffoldCmd = program
+  .command('scaffold')
+  .description('Generate feature files from templates');
+
+scaffoldCmd
+  .command('dotnet <feature> <slice-name>')
+  .description('Generate VSA feature slice (.NET)')
+  .option('--dry-run', 'Preview files without writing')
+  .option('--namespace <ns>', 'Root namespace (auto-detected from .csproj)')
+  .option('--output-dir <path>', 'Output directory (default: cwd)')
+  .option('-v, --verbose', 'Show detailed output')
+  .action(scaffoldDotnetCommand);
+
+scaffoldCmd
+  .command('nextjs <feature>')
+  .description('Generate feature page + components (Next.js)')
+  .option('--dry-run', 'Preview files without writing')
+  .option('--output-dir <path>', 'Output directory (default: cwd)')
+  .option('-v, --verbose', 'Show detailed output')
+  .action(scaffoldNextjsCommand);
+
 // Trust commands
 const trustCommand = program
   .command('trust')
@@ -448,12 +460,17 @@ program
   .option('--save', 'Save metrics to .morph/metrics.json')
   .action((options) => projectMetricsCommand(options));
 
-// Standards context budget
-program
-  .command('context-budget')
-  .description('Show estimated token usage for agent standards briefings')
-  .option('--phase <phase>', 'Phase to compute (default: implement)')
-  .option('--json', 'Output as JSON')
-  .action((options) => contextBudgetCommand(options));
+// Context management commands
+const contextCommand = program
+  .command('context')
+  .description('Project context management (refresh)');
+
+contextCommand
+  .command('refresh')
+  .description('Scan project architecture and generate .morph/context/README.md')
+  .option('-p, --path <path>', 'Target path (default: current directory)')
+  .option('-v, --verbose', 'Show detailed scan output')
+  .option('--json', 'Output scan result as JSON')
+  .action((options) => contextRefreshCommand(options));
 
 program.parse();