@polymorphism-tech/morph-spec 4.10.0 → 4.10.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/README.md +2 -2
  2. package/claude-plugin.json +1 -1
  3. package/docs/CHEATSHEET.md +1 -1
  4. package/docs/QUICKSTART.md +1 -1
  5. package/framework/CLAUDE.md +5 -69
  6. package/framework/agents/backend/api-designer.md +3 -0
  7. package/framework/agents/backend/dotnet-senior.md +3 -0
  8. package/framework/agents/backend/ef-modeler.md +2 -0
  9. package/framework/agents/backend/hangfire-orchestrator.md +2 -0
  10. package/framework/agents/backend/ms-agent-expert.md +2 -0
  11. package/framework/agents/frontend/blazor-builder.md +2 -0
  12. package/framework/agents/frontend/nextjs-expert.md +2 -0
  13. package/framework/agents/infrastructure/azure-architect.md +2 -0
  14. package/framework/agents/infrastructure/azure-deploy-specialist.md +2 -0
  15. package/framework/agents/infrastructure/bicep-architect.md +2 -0
  16. package/framework/agents/infrastructure/container-specialist.md +2 -0
  17. package/framework/agents/infrastructure/devops-engineer.md +3 -0
  18. package/framework/agents/infrastructure/infra-architect.md +3 -0
  19. package/framework/agents/integrations/asaas-financial.md +2 -0
  20. package/framework/agents/integrations/azure-identity.md +2 -0
  21. package/framework/agents/integrations/clerk-auth.md +3 -0
  22. package/framework/agents/integrations/hangfire-integration.md +2 -0
  23. package/framework/agents/integrations/resend-email.md +2 -0
  24. package/framework/commands/morph-apply.md +151 -161
  25. package/framework/commands/morph-archive.md +28 -28
  26. package/framework/commands/morph-infra.md +79 -79
  27. package/framework/commands/morph-preflight.md +92 -56
  28. package/framework/commands/morph-proposal.md +94 -70
  29. package/framework/commands/morph-status.md +31 -31
  30. package/framework/commands/morph-troubleshoot.md +63 -60
  31. package/framework/rules/csharp-standards.md +3 -0
  32. package/framework/rules/frontend-standards.md +2 -0
  33. package/framework/rules/infrastructure-standards.md +3 -0
  34. package/framework/rules/morph-workflow.md +57 -2
  35. package/framework/rules/nextjs-standards.md +2 -0
  36. package/framework/rules/testing-standards.md +3 -0
  37. package/framework/skills/level-0-meta/morph-brainstorming/SKILL.md +54 -49
  38. package/framework/skills/level-0-meta/morph-checklist/SKILL.md +42 -19
  39. package/framework/skills/level-0-meta/morph-code-review/SKILL.md +8 -5
  40. package/framework/skills/level-0-meta/morph-code-review-nextjs/SKILL.md +7 -5
  41. package/framework/skills/level-0-meta/morph-frontend-review/SKILL.md +139 -136
  42. package/framework/skills/level-0-meta/morph-init/SKILL.md +42 -13
  43. package/framework/skills/level-0-meta/morph-post-implementation/SKILL.md +130 -130
  44. package/framework/skills/level-0-meta/morph-replicate/SKILL.md +95 -87
  45. package/framework/skills/level-0-meta/morph-simulation-checklist/SKILL.md +24 -0
  46. package/framework/skills/level-0-meta/morph-tool-usage-guide/SKILL.md +42 -41
  47. package/framework/skills/level-0-meta/morph-verification-before-completion/SKILL.md +22 -11
  48. package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md +123 -114
  49. package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md +120 -102
  50. package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +206 -214
  51. package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json +38 -0
  52. package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md +241 -360
  53. package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +107 -115
  54. package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md +135 -135
  55. package/framework/skills/level-1-workflows/morph-phase-tasks/.morph/logs/activity.json +14 -0
  56. package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md +143 -139
  57. package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md +168 -165
  58. package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +57 -8
  59. package/package.json +3 -3
  60. package/src/commands/project/doctor.js +7 -2
  61. package/src/commands/project/update.js +4 -4
  62. package/src/lib/stack-filter.js +58 -0
  63. package/src/scripts/setup-infra.js +53 -18
  64. package/src/utils/agents-installer.js +19 -5
  65. package/src/utils/claude-md-injector.js +90 -0
  66. package/src/utils/hooks-installer.js +1 -4
  67. package/src/utils/skills-installer.js +67 -7
  68. package/CLAUDE.md +0 -98
  69. package/framework/memory/patterns-learned.md +0 -766
  70. package/framework/skills/level-0-meta/morph-terminal-title/SKILL.md +0 -61
  71. package/framework/skills/level-0-meta/morph-terminal-title/scripts/set_title.sh +0 -65
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  > Spec-driven development framework for multi-stack projects. Turns feature requests into implementation-ready code through structured, AI-orchestrated phases.
4
4
 
5
5
  **Package:** `@polymorphism-tech/morph-spec`
6
- **Version:** 4.10.0
6
+ **Version:** 4.10.2
7
7
  **Requires:** Node.js 18+, Claude Code
8
8
 
9
9
  ---
@@ -376,4 +376,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
376
376
 
377
377
  ---
378
378
 
379
- *morph-spec v4.10.0 by [Polymorphism Tech](https://polymorphism.tech)*
379
+ *morph-spec v4.10.2 by [Polymorphism Tech](https://polymorphism.tech)*
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "morph-spec",
3
- "version": "4.10.0",
3
+ "version": "4.10.2",
4
4
  "displayName": "MORPH-SPEC Framework",
5
5
  "description": "Spec-driven development with 38 agents and 8-phase workflow for .NET/Blazor/Next.js/Azure",
6
6
  "publisher": "polymorphism-tech",
@@ -198,4 +198,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
198
198
 
199
199
  ---
200
200
 
201
- *morph-spec v4.10.0 by Polymorphism Tech*
201
+ *morph-spec v4.10.2 by Polymorphism Tech*
@@ -203,4 +203,4 @@ morph-spec doctor
203
203
 
204
204
  ---
205
205
 
206
- *morph-spec v4.10.0 by Polymorphism Tech*
206
+ *morph-spec v4.10.2 by Polymorphism Tech*
@@ -2,21 +2,14 @@
2
2
 
3
3
  > by Polymorphism Tech — Spec-driven development for .NET/Blazor/Next.js/Azure
4
4
 
5
- ---
6
-
7
- ## Project Context
8
-
9
5
  @.morph/context/README.md
10
6
 
11
- ---
12
-
13
7
  ## Critical Rules
14
8
 
15
9
  **NEVER:**
16
10
  - Skip to code without a specification
17
11
  - Implement without design approval
18
12
  - Ignore standards in `.morph/framework/standards/`
19
- - Create infrastructure manually
20
13
  - Generate code without defined contracts
21
14
  - List questions as plain text — always use the `AskUserQuestion` tool
22
15
 
@@ -24,76 +17,19 @@
24
17
  - Follow the mandatory phases
25
18
  - Generate outputs in `.morph/features/{feature}/`
26
19
  - Document decisions in `decisions.md`
27
- - Checkpoint every 3 implemented tasks
28
- - Use Infrastructure as Code
29
- - Use `AskUserQuestion` tool whenever asking the user anything (1–4 questions per call; split into sequential calls if more)
30
-
31
- ---
20
+ - Use `AskUserQuestion` tool whenever asking the user anything (1-4 questions per call)
32
21
 
33
22
  ## Quick Reference
34
23
 
35
24
  | Command | Purpose |
36
25
  |---------|---------|
37
- | `/morph-proposal {feature}` | Full spec pipeline (phases 1–4, pauses for approval) |
38
- | `/morph-apply {feature}` | Implement feature (phase 5) |
39
- | `/morph-status` | Feature status dashboard |
40
- | `/morph-preflight` | Pre-implementation validation |
41
-
42
- ---
43
-
44
- ## State & Outputs
45
-
46
- | Path | Notes |
47
- |------|-------|
48
- | `.morph/state.json` | **READ-ONLY** — use `morph-spec` CLI to update |
49
- | `.morph/features/{feature}/{phase}/` | Feature outputs organized by phase |
50
- | `.morph/framework/` | **READ-ONLY** — framework files managed by morph-spec |
51
- | `.morph/config/config.json` | Project configuration (editable) |
52
-
53
- ### mark-output types
54
-
55
- Use `morph-spec state mark-output <feature> <type>` with one of these exact type names:
56
-
57
- | Type | Phase | kebab alias |
58
- |------|-------|-------------|
59
- | `proposal` | proposal | — |
60
- | `schemaAnalysis` | design | `schema-analysis` |
61
- | `spec` | design | — |
62
- | `contracts` | design | — |
63
- | `contractsVsa` | design | `contracts-vsa` |
64
- | `decisions` | design | — |
65
- | `clarifications` | clarify | — |
66
- | `plan` | plan | — |
67
- | `tasks` | tasks | — |
68
- | `uiDesignSystem` | uiux | `ui-design-system` |
69
- | `uiMockups` | uiux | `ui-mockups` |
70
- | `uiComponents` | uiux | `ui-components` |
71
- | `uiFlows` | uiux | `ui-flows` |
72
- | `recap` | implement | — |
73
- ---
74
-
75
- ## Phase Sequence
76
-
77
- ```
78
- proposal → setup → [uiux] → design → clarify → plan → tasks → implement → [sync]
79
- ```
80
-
81
- Use `morph-spec status {feature}` to see current phase and pending approval gates.
82
-
83
- ---
26
+ | `/morph-proposal {feature}` | Full spec pipeline (pauses for approval) |
27
+ | `/morph-apply {feature}` | Implement feature |
28
+ | `/morph-status` | Status dashboard |
29
+ | `/morph-preflight` | Pre-deploy validation |
84
30
 
85
31
  ## Agents
86
32
 
87
33
  Tier-1 and tier-2 MORPH agents are available as native subagents in `.claude/agents/`.
88
- They can be invoked directly by Claude Code during multi-agent workflows.
89
-
90
- ---
91
-
92
- ## Context Window Tip
93
-
94
- When using 3+ MCPs, add `"experimental": { "mcpCliMode": true }` to `.claude/settings.json`.
95
- MCP tools load on-demand instead of all at startup — keeps context clean for actual work.
96
-
97
- ---
98
34
 
99
35
  *MORPH-SPEC by Polymorphism Tech*
@@ -2,6 +2,9 @@
2
2
  name: api-designer
3
3
  description: API Designer specialist for REST API design, OpenAPI/Swagger specs, endpoint architecture, and HTTP contract definitions. Use when designing API endpoints, creating OpenAPI specs, defining REST contracts, or implementing Minimal API controllers in .NET.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - dotnet
7
+ - nextjs
5
8
  ---
6
9
 
7
10
  # API Designer
@@ -2,6 +2,9 @@
2
2
  name: dotnet-senior
3
3
  description: Senior .NET engineer and Backend Squad Leader for C#, Minimal API, async patterns, and Clean Architecture implementation. Use when implementing .NET/C# services, designing backend architecture, implementing async operations with CancellationToken, or coordinating backend domain specialists.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - dotnet
7
+ - blazor
5
8
  ---
6
9
 
7
10
  # .NET Senior Engineer
@@ -2,6 +2,8 @@
2
2
  name: ef-modeler
3
3
  description: Entity Framework Modeler specialist for database schema design, EF Core migrations, DbContext configuration, and ORM patterns including IDbContextFactory. Use when designing database models, creating EF Core migrations, configuring DbContext, or implementing repository patterns with EF Core.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - dotnet
5
7
  ---
6
8
 
7
9
  # EF Modeler
@@ -2,6 +2,8 @@
2
2
  name: hangfire-orchestrator
3
3
  description: Hangfire Orchestrator specialist for background job design, recurring task scheduling, queue management, and idempotent job patterns in .NET. Use when implementing background jobs, scheduling recurring tasks, managing job queues, or integrating Hangfire with .NET services.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - dotnet
5
7
  ---
6
8
 
7
9
  # Hangfire Orchestrator
@@ -2,6 +2,8 @@
2
2
  name: ms-agent-expert
3
3
  description: Microsoft Agent Framework Expert for Semantic Kernel, AI extensions, function calling, MCP/A2A protocols, and agentic pipeline implementation. Use when building AI agents with Semantic Kernel, implementing tool/plugin calling, designing multi-agent workflows, or integrating LLMs with .NET services.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - dotnet
5
7
  ---
6
8
 
7
9
  # Agent Framework Expert
@@ -2,6 +2,8 @@
2
2
  name: blazor-builder
3
3
  description: Blazor Builder specialist for .NET + Blazor Server stack, Razor components, Fluent UI Blazor, MudBlazor, and .NET 10 patterns. Use when implementing Blazor components and pages, configuring Program.cs, handling Blazor lifecycle patterns, or choosing between Fluent UI and MudBlazor libraries.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - blazor
5
7
  ---
6
8
 
7
9
  # .NET + Blazor Stack
@@ -2,6 +2,8 @@
2
2
  name: nextjs-expert
3
3
  description: Next.js specialist for App Router, shadcn/ui, TanStack Query, react-hook-form/Zod, and EasyPanel deployment. Use when building Next.js pages or components, implementing forms, setting up data fetching from a .NET API, or configuring TypeScript/Docker for Next.js.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - nextjs
5
7
  ---
6
8
 
7
9
  # Next.js Expert
@@ -2,6 +2,8 @@
2
2
  name: azure-architect
3
3
  description: Azure Architect specialist for designing Azure infrastructure, creating Bicep IaC templates, estimating resource costs, and enforcing zero-portal policy. Use when designing Azure architecture, provisioning cloud resources, creating Bicep templates, or planning multi-environment deployments.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - azure
5
7
  ---
6
8
 
7
9
  # Azure Architect
@@ -2,6 +2,8 @@
2
2
  name: azure-deploy-specialist
3
3
  description: Azure Deploy Specialist for end-to-end deployments to Azure Container Apps using systematic playbooks, validation checklists, and accumulated deployment knowledge. Use when deploying to Azure Container Apps, debugging deployment failures, configuring CI/CD pipelines, or performing pre-flight deployment validation.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - azure
5
7
  ---
6
8
 
7
9
  # Azure Deploy Specialist
@@ -2,6 +2,8 @@
2
2
  name: bicep-architect
3
3
  description: Bicep Architect specialist for Azure Infrastructure as Code, modular Bicep templates, ARM deployments, and resource configuration. Use when writing Bicep templates, structuring IaC modules, validating Azure deployments with what-if, or converting ARM JSON to Bicep.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - azure
5
7
  ---
6
8
 
7
9
  # Bicep Architect
@@ -2,6 +2,8 @@
2
2
  name: container-specialist
3
3
  description: Container Specialist for Docker, Compose, Azure Container Registry, and containerized .NET application patterns. Use when creating Dockerfiles, configuring multi-stage builds, setting up container registries, or containerizing .NET applications for Azure Container Apps.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - docker
5
7
  ---
6
8
 
7
9
  # Container Specialist
@@ -2,6 +2,9 @@
2
2
  name: devops-engineer
3
3
  description: DevOps Engineer (Tier 2 Domain Leader) for CI/CD pipeline strategy, GitHub Actions workflows, Azure DevOps, monitoring, and release automation. Use when designing deployment pipelines, configuring GitHub Actions, setting up Azure DevOps, or planning release strategies.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - azure
7
+ - docker
5
8
  ---
6
9
 
7
10
  # DevOps Engineer
@@ -2,6 +2,9 @@
2
2
  name: infra-architect
3
3
  description: Infrastructure Squad Leader for cloud-agnostic infrastructure coordination. Use when planning deployments, provisioning any cloud resources, setting up CI/CD pipelines, containerizing applications, or designing infrastructure architecture regardless of cloud provider.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - azure
7
+ - docker
5
8
  ---
6
9
 
7
10
  # Infrastructure Squad Leader
@@ -2,6 +2,8 @@
2
2
  name: asaas-financial
3
3
  description: Asaas Financial specialist for Asaas API integration, payment processing, Pix/boleto billing, and subscription management in Brazilian projects. Use when integrating Asaas payments, implementing billing flows, handling payment webhooks, or building subscription management features.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - dotnet
5
7
  ---
6
8
 
7
9
  # Asaas Financial
@@ -2,6 +2,8 @@
2
2
  name: azure-identity
3
3
  description: Azure Identity specialist for Microsoft Entra ID, OAuth 2.0/OIDC, MSAL, JWT authentication, and enterprise SSO patterns. Use when implementing Microsoft authentication, configuring Entra ID app registrations, securing APIs with OAuth/JWT, or setting up enterprise SSO with Azure AD.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - azure
5
7
  ---
6
8
 
7
9
  # Azure Identity (Microsoft Identity)
@@ -2,6 +2,9 @@
2
2
  name: clerk-auth
3
3
  description: Clerk Auth specialist for Clerk SDK integration, social login, JWT session management, and user management in Next.js and .NET projects. Use when integrating Clerk authentication, implementing social login flows, managing user sessions with Clerk JWT, or protecting routes with Clerk middleware.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - dotnet
7
+ - nextjs
5
8
  ---
6
9
 
7
10
  # Clerk Auth
@@ -2,6 +2,8 @@
2
2
  name: hangfire-orchestrator-integration
3
3
  description: Hangfire integration specialist for connecting background jobs with external services, implementing webhook handlers, and building event-driven workflows in .NET. Use when integrating Hangfire with third-party APIs, processing webhooks asynchronously, or designing event-driven job pipelines.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - dotnet
5
7
  ---
6
8
 
7
9
  # Hangfire Orchestrator
@@ -2,6 +2,8 @@
2
2
  name: resend-email
3
3
  description: Resend Email specialist for transactional email, HTML/React email templates, Resend API integration, and notification systems in .NET and Next.js. Use when implementing email notifications, integrating Resend API, creating transactional email templates, or configuring email delivery in MORPH-SPEC projects.
4
4
  allowed-tools: Read, Write, Edit, Bash, Glob, Grep
5
+ stacks:
6
+ - dotnet
5
7
  ---
6
8
 
7
9
  # Resend Email