@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.
- package/README.md +2 -2
- package/claude-plugin.json +1 -1
- package/docs/CHEATSHEET.md +1 -1
- package/docs/QUICKSTART.md +1 -1
- package/framework/CLAUDE.md +5 -69
- package/framework/agents/backend/api-designer.md +3 -0
- package/framework/agents/backend/dotnet-senior.md +3 -0
- package/framework/agents/backend/ef-modeler.md +2 -0
- package/framework/agents/backend/hangfire-orchestrator.md +2 -0
- package/framework/agents/backend/ms-agent-expert.md +2 -0
- package/framework/agents/frontend/blazor-builder.md +2 -0
- package/framework/agents/frontend/nextjs-expert.md +2 -0
- package/framework/agents/infrastructure/azure-architect.md +2 -0
- package/framework/agents/infrastructure/azure-deploy-specialist.md +2 -0
- package/framework/agents/infrastructure/bicep-architect.md +2 -0
- package/framework/agents/infrastructure/container-specialist.md +2 -0
- package/framework/agents/infrastructure/devops-engineer.md +3 -0
- package/framework/agents/infrastructure/infra-architect.md +3 -0
- package/framework/agents/integrations/asaas-financial.md +2 -0
- package/framework/agents/integrations/azure-identity.md +2 -0
- package/framework/agents/integrations/clerk-auth.md +3 -0
- package/framework/agents/integrations/hangfire-integration.md +2 -0
- package/framework/agents/integrations/resend-email.md +2 -0
- package/framework/commands/morph-apply.md +151 -161
- package/framework/commands/morph-archive.md +28 -28
- package/framework/commands/morph-infra.md +79 -79
- package/framework/commands/morph-preflight.md +92 -56
- package/framework/commands/morph-proposal.md +94 -70
- package/framework/commands/morph-status.md +31 -31
- package/framework/commands/morph-troubleshoot.md +63 -60
- package/framework/rules/csharp-standards.md +3 -0
- package/framework/rules/frontend-standards.md +2 -0
- package/framework/rules/infrastructure-standards.md +3 -0
- package/framework/rules/morph-workflow.md +57 -2
- package/framework/rules/nextjs-standards.md +2 -0
- package/framework/rules/testing-standards.md +3 -0
- package/framework/skills/level-0-meta/morph-brainstorming/SKILL.md +54 -49
- package/framework/skills/level-0-meta/morph-checklist/SKILL.md +42 -19
- package/framework/skills/level-0-meta/morph-code-review/SKILL.md +8 -5
- package/framework/skills/level-0-meta/morph-code-review-nextjs/SKILL.md +7 -5
- package/framework/skills/level-0-meta/morph-frontend-review/SKILL.md +139 -136
- package/framework/skills/level-0-meta/morph-init/SKILL.md +42 -13
- package/framework/skills/level-0-meta/morph-post-implementation/SKILL.md +130 -130
- package/framework/skills/level-0-meta/morph-replicate/SKILL.md +95 -87
- package/framework/skills/level-0-meta/morph-simulation-checklist/SKILL.md +24 -0
- package/framework/skills/level-0-meta/morph-tool-usage-guide/SKILL.md +42 -41
- package/framework/skills/level-0-meta/morph-verification-before-completion/SKILL.md +22 -11
- package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md +123 -114
- package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md +120 -102
- package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +206 -214
- package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json +38 -0
- package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md +241 -360
- package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +107 -115
- package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md +135 -135
- package/framework/skills/level-1-workflows/morph-phase-tasks/.morph/logs/activity.json +14 -0
- package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md +143 -139
- package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md +168 -165
- package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +57 -8
- package/package.json +3 -3
- package/src/commands/project/doctor.js +7 -2
- package/src/commands/project/update.js +4 -4
- package/src/lib/stack-filter.js +58 -0
- package/src/scripts/setup-infra.js +53 -18
- package/src/utils/agents-installer.js +19 -5
- package/src/utils/claude-md-injector.js +90 -0
- package/src/utils/hooks-installer.js +1 -4
- package/src/utils/skills-installer.js +67 -7
- package/CLAUDE.md +0 -98
- package/framework/memory/patterns-learned.md +0 -766
- package/framework/skills/level-0-meta/morph-terminal-title/SKILL.md +0 -61
- 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.
|
|
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.
|
|
379
|
+
*morph-spec v4.10.2 by [Polymorphism Tech](https://polymorphism.tech)*
|
package/claude-plugin.json
CHANGED
package/docs/CHEATSHEET.md
CHANGED
package/docs/QUICKSTART.md
CHANGED
package/framework/CLAUDE.md
CHANGED
|
@@ -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
|
-
-
|
|
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 (
|
|
38
|
-
| `/morph-apply {feature}` | Implement feature
|
|
39
|
-
| `/morph-status` |
|
|
40
|
-
| `/morph-preflight` | Pre-
|
|
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
|