@polymorphism-tech/morph-spec 4.3.6 → 4.5.0

package/framework/rules/morph-workflow.md

@@ -0,0 +1,86 @@
+# MORPH-SPEC Workflow Rules
+
+> Always-active rules for all MORPH-SPEC managed projects.
+
+---
+
+## Spec-First Mandate
+
+**NEVER skip to code without a specification.** Every feature must progress through phases:
+
+1. **Proposal** — User story + acceptance criteria (`0-proposal/proposal.md`)
+2. **Design** — Technical spec + C# contracts + decisions (`1-design/`)
+3. **Tasks** — Atomic task list (`3-tasks/tasks.md`)
+4. **Implement** — Code + recap (`4-implement/recap.md`)
+
+UI-heavy features also include **UI/UX** phase (`2-ui/`) between Design and Tasks.
+
+---
+
+## Phase Commands
+
+| 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 |
+
+---
+
+## Output Paths
+
+All outputs go in `.morph/features/{feature}/`:
+
+| Phase | Path |
+|-------|------|
+| Proposal | `0-proposal/proposal.md` |
+| Spec | `1-design/spec.md` |
+| Contracts | `1-design/contracts.cs` |
+| Decisions | `1-design/decisions.md` |
+| UI Design | `2-ui/design-system.md`, `mockups.md`, `components.md`, `flows.md` |
+| Tasks | `3-tasks/tasks.md` |
+| Recap | `4-implement/recap.md` |
+
+---
+
+## Checkpoints
+
+Run a checkpoint every 3 completed tasks:
+- Validate architecture compliance
+- Check package versions
+- Scan for security issues
+- Verify design system adherence (UI features)
+
+---
+
+## Approval Gates
+
+**Design Gate:** Before moving from Design → Tasks, spec must be approved.
+**Implementation Gate:** Before starting implementation, task list must be approved.
+
+Check approval status: `morph-spec state show {feature}`
+
+---
+
+## Protected Files
+
+**NEVER directly edit:**
+- `.morph/state.json` — Managed by CLI only
+- `.morph/framework/**` — Read-only framework content
+
+---
+
+## Test File Policy
+
+When a test fails, always follow this order:
+
+1. **Analyze first** — determine if the IMPLEMENTATION is wrong or the TEST SPEC is wrong
+2. **Fix implementation first** — the test is the spec; trust it by default
+3. **Only modify a test file if the test expectation itself is incorrect** — wrong expected value, wrong behavior modeled
+4. **Before modifying any test file, explain WHY the test spec is wrong** — what the correct behavior is and why the test doesn't model it
+
+Do not modify test files to make a failing test pass when the implementation is the actual problem.
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/framework/rules/testing-standards.md

@@ -0,0 +1,11 @@
+---
+paths:
+  - "tests/**"
+  - "**/*.test.*"
+  - "**/*.spec.*"
+  - "**/*Tests.cs"
+---
+
+# Testing Standards
+
+@.morph/framework/standards/core/testing.md

package/framework/skills/level-0-meta/brainstorming.md

@@ -0,0 +1,133 @@
+---
+name: brainstorming
+description: Morph-spec-aware brainstorming for exploring feature approaches, generating proposals, and designing architecture. Use before any creative or implementation work.
+---
+
+# Brainstorming — MORPH-SPEC Integrated
+
+> Explore context, ask questions, generate multiple approaches, and produce a design document before committing to implementation.
+
+## When to Use
+
+- **Phase 0 (Proposal):** Explore the feature request before writing `proposal.md`
+- **Phase 2 (Design):** Explore architectural alternatives before writing `spec.md`
+- **Any phase:** When facing a decision with multiple valid approaches
+
+## Prerequisites
+
+Before brainstorming, load project context:
+
+```bash
+# Load current state
+npx morph-spec state get {feature-name}
+
+# Read project config
+Read: .morph/config/config.json
+
+# Read existing proposal (if Phase 2)
+Read: .morph/features/{feature}/0-proposal/proposal.md
+```
+
+---
+
+## Workflow
+
+### Step 1: Explore Context
+
+**Gather information before generating ideas:**
+
+1. **Read state.json** — current phase, active agents, existing outputs
+2. **Read config.json** — stack, architecture, project name
+3. **Read existing outputs** — proposal.md, spec.md (if they exist)
+4. **Scan codebase** — use Glob/Grep to understand existing patterns
+5. **Check integrations.json** — available MCPs and plugins
+
+**Use MCP tools when available:**
+- **Context7** → look up library capabilities relevant to the feature
+- **Supabase** → check existing schema for data-related features
+- **GitHub** → check existing issues/PRs for related work
+
+### Step 2: Ask Clarifying Questions
+
+Generate **3-5 focused questions** for the user:
+
+```markdown
+### Q1: Scope
+What is the minimum viable version of this feature?
+
+### Q2: Constraints
+Are there performance/budget/timeline constraints?
+
+### Q3: Integration
+Does this need to integrate with existing features?
+
+### Q4: Users
+Who are the primary users of this feature?
+
+### Q5: Success Criteria
+How will we know this feature is working correctly?
+```
+
+**Wait for user responses before proceeding.**
+
+### Step 3: Generate 2-3 Approaches
+
+For each approach, document:
+
+```markdown
+## Approach A: {Name}
+
+**Description:** {1-2 sentences}
+
+**Pros:**
+- Pro 1
+- Pro 2
+
+**Cons:**
+- Con 1
+- Con 2
+
+**Complexity:** Low / Medium / High
+**Estimated Tasks:** ~N
+**Key Dependencies:** {list}
+```
+
+### Step 4: Recommend and Document
+
+1. **Recommend** the best approach with reasoning
+2. **Write output** to the appropriate location:
+   - Phase 0 → render `docs/proposal` template → `.morph/features/{feature}/0-proposal/proposal.md`
+   - Phase 2 → document in `decisions.md` as an ADR
+
+3. **Update state:**
+```bash
+npx morph-spec state mark-output {feature-name} proposal    # Phase 0
+npx morph-spec state mark-output {feature-name} decisions    # Phase 2
+```
+
+---
+
+## Integration with Superpowers
+
+> Available when the `superpowers` plugin is installed.
+
+This skill replaces `superpowers:brainstorming` within morph-spec workflows. It adds:
+- Automatic context loading from `.morph/` state and config
+- Template rendering for outputs (proposal.md, decisions.md)
+- State tracking via `morph-spec state mark-output`
+- MCP integration for research (Context7, Supabase)
+
+For brainstorming **outside** morph-spec workflows, the original `superpowers:brainstorming` skill remains available.
+
+---
+
+## Anti-patterns
+
+- Never skip brainstorming for features with multiple valid approaches
+- Never commit to an approach without documenting alternatives
+- Never brainstorm without loading project context first
+- Never write code before completing the brainstorming output
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/framework/skills/level-0-meta/code-review.md

@@ -1,9 +1,17 @@
+---
+name: code-review
+description: >
+  Structured code review checklist for MORPH-SPEC projects covering architecture, standards compliance, contracts, and quality gates. Use after implementation to validate work.
+user-invocable: true
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep
+---
+
 # Code Review Checklist
 
 > Comprehensive checklist for .NET code review: naming, architecture, clean code, duplication, and runtime patterns.
-> **Ref:** `framework/standards/coding.md` for naming conventions and style.
-> **Ref:** `framework/standards/architecture.md` for layer rules and SOLID.
-> **Ref:** `framework/standards/blazor-efcore.md` for DbContext patterns and background ops.
+> **Ref:** `framework/standards/core/coding.md` for naming conventions and style.
+> **Ref:** `framework/standards/core/architecture.md` for layer rules and SOLID.
+> **Ref:** `framework/standards/backend/database/ef-core.md` for DbContext patterns and background ops.
 
 ---
 
@@ -223,4 +231,4 @@ public enum OrderStatus
 ---
 
 *Consolidated from: code-review-services.md + code-review-background.md + code-review-contracts.md + architecture/clean-code/duplication analysis.*
-*MORPH-SPEC by Polymorphism Tech*
+*MORPH-SPEC by Polymorphism Tech*

package/framework/skills/level-0-meta/mcp-registry.json

@@ -0,0 +1,207 @@
+{
+  "version": "2.0.0",
+  "description": "Centralized MCP registry with phase relevance and install configuration for morph-spec workflows",
+  "mcps": {
+    "context7": {
+      "phases": ["proposal", "design", "tasks", "implement"],
+      "tools": ["resolve-library-id", "query-docs"],
+      "detection": "enabledPlugins includes context7 or mcpServers includes context7",
+      "fallback": "WebSearch + WebFetch for library documentation",
+      "usage": "Library documentation lookups, API reference, implementation patterns",
+      "install": {
+        "autoInstall": true,
+        "config": {
+          "command": "npx",
+          "args": ["-y", "@upstash/context7-mcp@latest"]
+        },
+        "credentials": [],
+        "prerequisites": [],
+        "stackRelevance": ["*"],
+        "warnings": [],
+        "setupGuide": null
+      }
+    },
+    "playwright": {
+      "phases": ["uiux", "implement"],
+      "tools": ["browser_navigate", "browser_snapshot", "browser_take_screenshot", "browser_console_messages", "browser_click", "browser_resize"],
+      "detection": "mcpServers includes playwright",
+      "fallback": "WebFetch for read-only page content, manual testing",
+      "usage": "UI preview, smoke testing, page inspection, responsive testing, screenshot capture",
+      "install": {
+        "autoInstall": true,
+        "config": {
+          "command": "npx",
+          "args": ["-y", "@playwright/mcp@latest"]
+        },
+        "credentials": [],
+        "prerequisites": [],
+        "stackRelevance": ["*"],
+        "warnings": [],
+        "setupGuide": null
+      }
+    },
+    "supabase": {
+      "phases": ["design", "implement"],
+      "tools": ["list_tables", "get_table_schema", "get_relationships", "query"],
+      "detection": "mcpServers includes supabase",
+      "fallback": "Grep query files + Read type definitions for schema inference",
+      "usage": "Schema analysis, migrations, RLS policies, data operations",
+      "install": {
+        "autoInstall": false,
+        "config": {
+          "command": "npx",
+          "args": ["-y", "@supabase/mcp-server-supabase"],
+          "env": {
+            "SUPABASE_URL": "",
+            "SUPABASE_SERVICE_ROLE_KEY": ""
+          }
+        },
+        "credentials": [
+          {
+            "name": "Supabase Project URL",
+            "envVar": "SUPABASE_URL",
+            "secret": false,
+            "helpUrl": "https://supabase.com/dashboard/project/_/settings/api"
+          },
+          {
+            "name": "Service Role Key",
+            "envVar": "SUPABASE_SERVICE_ROLE_KEY",
+            "secret": true,
+            "helpUrl": "https://supabase.com/dashboard/project/_/settings/api"
+          }
+        ],
+        "prerequisites": [],
+        "stackRelevance": ["nextjs-supabase", "supabase", "nextjs"],
+        "warnings": ["NEVER connect to PRODUCTION databases. Use local/dev environment only."],
+        "setupGuide": null
+      }
+    },
+    "github": {
+      "phases": ["setup", "tasks", "implement"],
+      "tools": ["get_repo", "search_code", "create_issue", "create_pull_request", "search_issues"],
+      "detection": "mcpServers includes github",
+      "fallback": "Bash `gh` CLI commands",
+      "usage": "Repo metadata, code search, issue creation, PR management",
+      "install": {
+        "autoInstall": false,
+        "config": {
+          "command": "npx",
+          "args": ["-y", "@modelcontextprotocol/server-github"],
+          "env": {
+            "GITHUB_PERSONAL_ACCESS_TOKEN": ""
+          }
+        },
+        "credentials": [
+          {
+            "name": "GitHub Personal Access Token",
+            "envVar": "GITHUB_PERSONAL_ACCESS_TOKEN",
+            "secret": true,
+            "helpUrl": "https://github.com/settings/tokens"
+          }
+        ],
+        "prerequisites": [],
+        "stackRelevance": ["*"],
+        "warnings": [],
+        "setupGuide": null
+      }
+    },
+    "figma": {
+      "phases": ["uiux"],
+      "tools": ["get_file"],
+      "detection": "mcpServers includes figma",
+      "fallback": "Read CSS/SCSS files for existing design tokens",
+      "usage": "Design token extraction, component specs, color/typography from Figma files",
+      "install": {
+        "autoInstall": false,
+        "config": {
+          "command": "npx",
+          "args": ["-y", "@anthropic/mcp-server-figma"],
+          "env": {
+            "FIGMA_ACCESS_TOKEN": ""
+          }
+        },
+        "credentials": [
+          {
+            "name": "Figma Access Token",
+            "envVar": "FIGMA_ACCESS_TOKEN",
+            "secret": true,
+            "helpUrl": "https://www.figma.com/developers/api#access-tokens"
+          }
+        ],
+        "prerequisites": [],
+        "stackRelevance": ["blazor", "nextjs", "react", "vue"],
+        "warnings": [],
+        "setupGuide": null
+      }
+    },
+    "docker": {
+      "phases": ["implement"],
+      "tools": ["build", "run", "compose"],
+      "detection": "mcpServers includes docker",
+      "fallback": "Bash `docker` CLI commands",
+      "usage": "Container management, build and run containers",
+      "install": {
+        "autoInstall": false,
+        "config": {
+          "command": "npx",
+          "args": ["-y", "@modelcontextprotocol/server-docker"]
+        },
+        "credentials": [],
+        "prerequisites": [
+          {
+            "name": "Docker",
+            "checkCommand": "docker --version",
+            "installUrl": "https://docs.docker.com/get-docker/"
+          }
+        ],
+        "stackRelevance": ["dotnet", "blazor", "nextjs", "nodejs"],
+        "warnings": [],
+        "setupGuide": null
+      }
+    },
+    "azure": {
+      "phases": ["implement"],
+      "tools": ["deploy", "resource_management"],
+      "detection": "mcpServers includes azure",
+      "fallback": "Bash `az` CLI commands",
+      "usage": "Cloud resource management, deployment",
+      "install": {
+        "autoInstall": false,
+        "config": {
+          "command": "npx",
+          "args": ["-y", "@azure/mcp-server"],
+          "env": {
+            "AZURE_SUBSCRIPTION_ID": ""
+          }
+        },
+        "credentials": [
+          {
+            "name": "Azure Subscription ID",
+            "envVar": "AZURE_SUBSCRIPTION_ID",
+            "secret": false,
+            "helpUrl": "https://portal.azure.com/#blade/Microsoft_Azure_Billing/SubscriptionsBlade"
+          }
+        ],
+        "prerequisites": [
+          {
+            "name": "Azure CLI",
+            "checkCommand": "az --version",
+            "installUrl": "https://learn.microsoft.com/en-us/cli/azure/install-azure-cli"
+          }
+        ],
+        "stackRelevance": ["blazor", "dotnet", "azure"],
+        "warnings": [],
+        "setupGuide": null
+      }
+    }
+  },
+  "phaseMatrix": {
+    "proposal": ["context7"],
+    "setup": ["github"],
+    "uiux": ["playwright", "figma", "context7"],
+    "design": ["supabase", "context7", "github"],
+    "clarify": ["context7", "github"],
+    "tasks": ["context7", "github"],
+    "implement": ["supabase", "context7", "playwright", "github", "docker", "azure"]
+  }
+}

package/framework/skills/level-0-meta/morph-checklist.md

@@ -1,3 +1,11 @@
+---
+name: morph-checklist
+description: >
+  Pre-implementation checklist verifying that all MORPH-SPEC phases are complete and outputs exist before starting code. Use before any implementation work begins.
+user-invocable: true
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep
+---
+
 # Skill: /morph-checklist
 
 > **Layer:** 2 | **Load:** on-keyword | **Keywords:** checklist, deploy, security, seo, performance, accessibility, lgpd, legal
@@ -114,4 +122,4 @@ Types: `deploy`, `security`, `seo`, `performance`, `accessibility`, `legal-brazi
 
 ---
 
-*MORPH-SPEC Checklist Skill*
+*MORPH-SPEC Checklist Skill*

package/framework/skills/level-0-meta/simulation-checklist.md

@@ -1,3 +1,11 @@
+---
+name: simulation-checklist
+description: >
+  Checklist for simulating a full MORPH-SPEC workflow run to validate phase outputs and state consistency. Use to verify the framework is working correctly.
+user-invocable: true
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep
+---
+
 # Skill: /morph-checklist simulation
 
 > **Layer:** 2 | **Load:** on-keyword | **Keywords:** simulation, mock, fake, external service, sandbox
@@ -74,4 +82,4 @@ else
 
 ---
 
-*MORPH-SPEC Simulation Checklist*
+*MORPH-SPEC Simulation Checklist*