@polymorphism-tech/morph-spec 7.4.0 → 7.6.0

package/framework/templates/context/CONTEXT.md

@@ -1,180 +1,181 @@
-# {{PROJECT_NAME}} - Project Context
-
-> Auto-generated by MORPH-SPEC Framework
-> Last updated: {{TIMESTAMP}}
-
-## Project Overview
-
-**Name:** {{PROJECT_NAME}}
-**Type:** {{PROJECT_TYPE}}
-**Repository:** {{REPOSITORY_URL}}
-
-{{PROJECT_DESCRIPTION}}
-
----
-
-## Technology Stack
-
-### Frontend
-{{#if NEXTJS_ENABLED}}- **Next.js** {{NEXTJS_VERSION}}{{/if}}
-{{#if UI_LIBRARY}}- **UI Library:** {{UI_LIBRARY}}{{/if}}
-
-### Backend
-- **.NET** {{DOTNET_VERSION}}
-{{#if EF_VERSION}}- **Entity Framework Core** {{EF_VERSION}}{{/if}}
-{{#if DAPPER_ENABLED}}- **Dapper** (Micro-ORM){{/if}}
-{{#if HANGFIRE_ENABLED}}- **Hangfire** (Background Jobs){{/if}}
-{{#if AGENT_FRAMEWORK_ENABLED}}- **Microsoft Agent Framework** (AI Agents){{/if}}
-
-### Database
-{{#if SQL_ENABLED}}- **Azure SQL** ({{SQL_SERVER}}/{{SQL_DATABASE}}){{/if}}
-{{#if NEON_ENABLED}}- **Neon** (PostgreSQL + Connection Pooling)
-  - Project: {{NEON_PROJECT_ID}}
-  - Region: {{NEON_REGION}}
-{{/if}}
-
-### Infrastructure
-{{#if AZURE_ENABLED}}- **Azure** ({{AZURE_LOCATION}})
-{{#if CONTAINER_APPS_ENABLED}}- **Container Apps** ({{CONTAINER_ENV}}){{/if}}
-{{#if OPENAI_ENABLED}}- **Azure OpenAI** ({{OPENAI_MODEL}}){{/if}}
-{{#if MONITORING_ENABLED}}- **Application Insights** ({{APP_INSIGHTS}}){{/if}}
-{{/if}}
-
-{{#if EASYPANEL_ENABLED}}- **EasyPanel** (Docker Deployment)
-  - API: {{EASYPANEL_API_URL}}
-  - Web: {{EASYPANEL_WEB_URL}}
-{{/if}}
-
----
-
-## Active Features
-
-{{#each ACTIVE_FEATURES}}
-### {{name}} ({{phase}})
-**Status:** {{status}}
-**Complexity:** {{complexity}}
-**Active Agents:** {{activeAgents}}
-
-{{#if description}}{{description}}{{/if}}
-
-**Progress:**
-- Tasks: {{tasks.completed}}/{{tasks.total}}
-- Outputs: {{outputs}}
-
-{{/each}}
-
----
-
-## Project Standards
-
-### Coding Standards
-{{#each PROJECT_STANDARDS}}
-- [{{name}}]({{path}}){{#if description}} - {{description}}{{/if}}
-{{/each}}
-
-### Inferred Patterns
-{{#if INFERRED_STANDARDS}}
-{{INFERRED_STANDARDS}}
-{{/if}}
-
----
-
-## Active Agents ({{AGENT_COUNT}})
-
-### Tier 1: Orchestrators
-{{#each TIER_1_AGENTS}}
-- **{{title}}** (`{{id}}`) {{#if always_active}}[Always Active]{{/if}}
-{{/each}}
-
-### Tier 2: Domain Leaders
-{{#each TIER_2_AGENTS}}
-- **{{title}}** (`{{id}}`) - {{domains}}
-{{/each}}
-
-### Tier 3: Specialists
-{{#each TIER_3_AGENTS}}
-- **{{title}}** (`{{id}}`) - Reports to `{{reports_to}}`
-{{/each}}
-
----
-
-## Agent Teams Status
-
-{{#if AGENT_TEAMS_ENABLED}}
-✅ **Enabled** (Display Mode: {{AGENT_TEAMS_DISPLAY_MODE}})
-
-**Spawn Thresholds:**
-- Complexity: {{AGENT_TEAMS_THRESHOLDS.complexity}}
-- Estimated Files: ≥ {{AGENT_TEAMS_THRESHOLDS.estimatedFiles}}
-- Active Agents: ≥ {{AGENT_TEAMS_THRESHOLDS.activeAgents}}
-- Multi-Domain: {{AGENT_TEAMS_THRESHOLDS.multiDomain}}
-
-{{else}}
-❌ **Disabled** - Use single session with subagents
-{{/if}}
-
----
-
-## Recent Checkpoints
-
-{{#each RECENT_CHECKPOINTS}}
-### {{timestamp}}
-**Feature:** {{feature}}
-**Phase:** {{phase}}
-**Note:** {{note}}
-
-{{#if validation}}
-**Validation:** {{validation.passed}}/{{validation.total}} checks passed
-{{/if}}
-
-{{/each}}
-
----
-
-{{#if DEVOPS_ENABLED}}
-## DevOps Integration
-
-**Organization:** {{DEVOPS_ORG}}
-**Project:** {{DEVOPS_PROJECT}}
-
-- **Boards:** {{#if DEVOPS_BOARDS_ENABLED}}Enabled ({{DEVOPS_AREA_PATH}}){{else}}Disabled{{/if}}
-- **Wiki:** {{#if DEVOPS_WIKI_ENABLED}}Enabled ({{DEVOPS_WIKI_NAME}}){{else}}Disabled{{/if}}
-- **Pipelines:** CI: {{DEVOPS_BUILD_PIPELINE}}, CD: {{DEVOPS_RELEASE_PIPELINE}}
-
----
-
-{{/if}}
-
-## Quick Reference
-
-### Workflow Commands
-```bash
-# Detect agents for feature
-morph-spec detect-agents "{feature description}"
-
-# Initialize new feature
-morph-spec state init
-
-# Update design system (run morph-phase-uiux skill or edit manually)
-# .morph/context/design-system.md
-
-# Advance to next phase
-morph-spec phase advance {feature}
-
-# Mark task complete (runs validators)
-morph-spec task done {feature} {task-id}
-
-# Generate recap
-morph-spec generate recap {feature}
-```
-
-### Key Paths
-- **Outputs:** `.morph/features/{feature}/`
-- **Standards:** `.morph/context/` (project overrides)
-- **Config:** `.morph/config/config.json`
-- **State:** `.morph/state.json`
-- **Templates:** `.morph/framework/templates/`
-
----
-
-*Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*
+# {{PROJECT_NAME}} - Project Context
+
+> Auto-generated by MORPH-SPEC Framework
+> Last updated: {{TIMESTAMP}}
+
+## Project Overview
+
+**Name:** {{PROJECT_NAME}}
+**Type:** {{PROJECT_TYPE}}
+**Repository:** {{REPOSITORY_URL}}
+
+{{PROJECT_DESCRIPTION}}
+
+---
+
+## Technology Stack
+
+### Frontend
+{{#if NEXTJS_ENABLED}}- **Next.js** {{NEXTJS_VERSION}}{{/if}}
+{{#if UI_LIBRARY}}- **UI Library:** {{UI_LIBRARY}}{{/if}}
+
+### Backend
+- **.NET** {{DOTNET_VERSION}}
+{{#if EF_VERSION}}- **Entity Framework Core** {{EF_VERSION}}{{/if}}
+{{#if DAPPER_ENABLED}}- **Dapper** (Micro-ORM){{/if}}
+{{#if HANGFIRE_ENABLED}}- **Hangfire** (Background Jobs){{/if}}
+{{#if AGENT_FRAMEWORK_ENABLED}}- **Microsoft Agent Framework** (AI Agents){{/if}}
+
+### Database
+{{#if SQL_ENABLED}}- **Azure SQL** ({{SQL_SERVER}}/{{SQL_DATABASE}}){{/if}}
+{{#if NEON_ENABLED}}- **Neon** (PostgreSQL + Connection Pooling)
+  - Project: {{NEON_PROJECT_ID}}
+  - Region: {{NEON_REGION}}
+{{/if}}
+
+### Infrastructure
+{{#if AZURE_ENABLED}}- **Azure** ({{AZURE_LOCATION}})
+{{#if CONTAINER_APPS_ENABLED}}- **Container Apps** ({{CONTAINER_ENV}}){{/if}}
+{{#if OPENAI_ENABLED}}- **Azure OpenAI** ({{OPENAI_MODEL}}){{/if}}
+{{#if MONITORING_ENABLED}}- **Application Insights** ({{APP_INSIGHTS}}){{/if}}
+{{/if}}
+
+{{#if COOLIFY_ENABLED}}- **Coolify** (Docker Deployment via SSH)
+  - Server: {{COOLIFY_SERVER}}
+  - App: {{COOLIFY_APP_URL}}
+{{/if}}
+
+---
+
+## Active Features
+
+{{#each ACTIVE_FEATURES}}
+### {{name}} ({{phase}})
+**Status:** {{status}}
+**Complexity:** {{complexity}}
+**Active Agents:** {{activeAgents}}
+
+{{#if description}}{{description}}{{/if}}
+
+**Progress:**
+- Tasks: {{tasks.completed}}/{{tasks.total}}
+- Outputs: {{outputs}}
+
+{{/each}}
+
+---
+
+## Project Standards
+
+### Coding Standards
+{{#each PROJECT_STANDARDS}}
+- [{{name}}]({{path}}){{#if description}} - {{description}}{{/if}}
+{{/each}}
+
+### Inferred Patterns
+{{#if INFERRED_STANDARDS}}
+{{INFERRED_STANDARDS}}
+{{/if}}
+
+---
+
+## Active Agents ({{AGENT_COUNT}})
+
+### Tier 1: Orchestrators
+{{#each TIER_1_AGENTS}}
+- **{{title}}** (`{{id}}`) {{#if always_active}}[Always Active]{{/if}}
+{{/each}}
+
+### Tier 2: Domain Leaders
+{{#each TIER_2_AGENTS}}
+- **{{title}}** (`{{id}}`) - {{domains}}
+{{/each}}
+
+### Tier 3: Specialists
+{{#each TIER_3_AGENTS}}
+- **{{title}}** (`{{id}}`) - Reports to `{{reports_to}}`
+{{/each}}
+
+---
+
+## Agent Teams Status
+
+{{#if AGENT_TEAMS_ENABLED}}
+✅ **Enabled** (Display Mode: {{AGENT_TEAMS_DISPLAY_MODE}})
+
+**Spawn Thresholds:**
+- Complexity: {{AGENT_TEAMS_THRESHOLDS.complexity}}
+- Estimated Files: ≥ {{AGENT_TEAMS_THRESHOLDS.estimatedFiles}}
+- Active Agents: ≥ {{AGENT_TEAMS_THRESHOLDS.activeAgents}}
+- Multi-Domain: {{AGENT_TEAMS_THRESHOLDS.multiDomain}}
+
+{{else}}
+❌ **Disabled** - Use single session with subagents
+{{/if}}
+
+---
+
+## Recent Checkpoints
+
+{{#each RECENT_CHECKPOINTS}}
+### {{timestamp}}
+**Feature:** {{feature}}
+**Phase:** {{phase}}
+**Note:** {{note}}
+
+{{#if validation}}
+**Validation:** {{validation.passed}}/{{validation.total}} checks passed
+{{/if}}
+
+{{/each}}
+
+---
+
+{{#if DEVOPS_ENABLED}}
+## DevOps Integration
+
+**Organization:** {{DEVOPS_ORG}}
+**Project:** {{DEVOPS_PROJECT}}
+
+- **Boards:** {{#if DEVOPS_BOARDS_ENABLED}}Enabled ({{DEVOPS_AREA_PATH}}){{else}}Disabled{{/if}}
+- **Wiki:** {{#if DEVOPS_WIKI_ENABLED}}Enabled ({{DEVOPS_WIKI_NAME}}){{else}}Disabled{{/if}}
+- **Pipelines:** CI: {{DEVOPS_BUILD_PIPELINE}}, CD: {{DEVOPS_RELEASE_PIPELINE}}
+
+---
+
+{{/if}}
+
+## Quick Reference
+
+### Workflow Commands
+```bash
+# Check feature status and pending gates
+morph-spec status {feature}
+morph-spec approval-status {feature}
+
+# Approve the current gate and scaffold the next phase folder in one step
+morph-spec advance {feature}
+
+# Validate feature outputs
+morph-spec validate-feature {feature}
+
+# Archive a finished feature (after Gate 3)
+morph-spec archive {feature}
+```
+
+> Feature work starts by asking Claude Code to implement something — the proposal
+> phase is created for you. During the implement phase, task progress is tracked
+> with the native `TaskCreate`/`TaskUpdate` tools and persisted by writing
+> `tasks.json` (only `status`, `outputs`, `notes`); the recap is written by the
+> implement skill. State syncs automatically via the `state-sync` hook.
+
+### Key Paths
+- **Outputs:** `.morph/features/{feature}/`
+- **Standards:** `.morph/context/` (project overrides)
+- **Config:** `.morph/config/config.json`
+- **State:** `.morph/state.json`
+- **Templates:** `.morph/framework/templates/`
+
+---
+
+*Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*

package/framework/templates/docs/onboarding.md

@@ -1,118 +1,122 @@
-# Onboarding Guide — {{PROJECT_NAME}}
-
-> Generated by MORPH-SPEC on {{DATE}}
-
----
-
-## Project Overview
-
-- **Project:** {{PROJECT_NAME}}
-- **Stack:** {{STACK}}
-- **Architecture:** {{ARCHITECTURE}}
-
----
-
-## Active Agents
-
-The following agents are configured for this project:
-
-{{AGENTS_LIST}}
-
----
-
-## Available MCPs & Plugins
-
-{{AVAILABLE_MCPS}}
-
----
-
-## Standards
-
-The following standards are enforced in this project:
-
-{{STANDARDS_SUMMARY}}
-
-Standards are located in:
-- `.morph/framework/standards/` — Framework standards (universal)
-- `.morph/context/` — Project-specific overrides
-
----
-
-## Configured Workflow
-
-{{WORKFLOW_SUMMARY}}
-
-### Available Workflows
-
-| Workflow | Description | Phases |
-|----------|-------------|--------|
-| fast-track | Simple, well-defined features | 0→1→2→4→5 |
-| standard | Most features | 0→1→(1.5)→2→3→4→5 |
-| full-morph | Complex features with sync | 0→1→1.5→2→3→4→5→6 |
-| design-impl | Pre-planned work | 2→4→5 |
-| ui-refresh | Visual redesigns | 1.5→2→5 |
-
----
-
-## Key Commands
-
-```bash
-# Start a feature
-# Just ask Claude Code to implement something
-
-# Check feature progress
-morph-spec status <feature>
-
-# Validate feature outputs
-morph-spec validate-feature <feature>
-
-# Manage tasks
-morph-spec task start <feature> <task-id>
-morph-spec task done <feature> <task-id>
-
-# Save a checkpoint
-morph-spec checkpoint-save <feature>
-
-# Health check
-morph-spec doctor
-```
-
----
-
-## Project Structure
-
-```
-{{PROJECT_NAME}}/
-├── CLAUDE.md                      # Claude Code instructions
-├── .morph/
-│   ├── config/
-│   │   └── config.json            # Project configuration
-│   ├── framework/
-│   │   ├── agents.json            # Agent definitions
-│   │   ├── standards/             # Framework standards
-│   │   └── templates/             # Output templates
-│   ├── context/                   # Project context & overrides
-│   └── features/{feature}/        # Feature outputs
-│       ├── 0-proposal/
-│       ├── 1-design/              # optional (UI-heavy features)
-│       ├── 2-plan/
-│       ├── 3-implement/
-│       └── 4-review/
-└── .claude/
-    ├── commands/                  # Slash commands
-    ├── skills/                    # Workflow skills
-    └── settings.local.json        # Hooks & permissions
-```
-
----
-
-## Getting Started
-
-1. **Ask Claude Code** to implement a feature
-2. **Follow the phases** — the framework guides you automatically
-3. **Approve at pauses** — design and task breakdowns need your approval
-4. **Check progress** with `morph-spec status <feature>`
-
----
-
-*Generated by MORPH-SPEC v{{VERSION}} — Polymorphism Tech*
+# Onboarding Guide — {{PROJECT_NAME}}
+
+> Generated by MORPH-SPEC on {{DATE}}
+
+---
+
+## Project Overview
+
+- **Project:** {{PROJECT_NAME}}
+- **Stack:** {{STACK}}
+- **Architecture:** {{ARCHITECTURE}}
+
+---
+
+## Active Agents
+
+The following agents are configured for this project:
+
+{{AGENTS_LIST}}
+
+---
+
+## Available MCPs & Plugins
+
+{{AVAILABLE_MCPS}}
+
+---
+
+## Standards
+
+The following standards are enforced in this project:
+
+{{STANDARDS_SUMMARY}}
+
+Standards are located in:
+- `.morph/framework/standards/` — Framework standards (universal)
+- `.morph/context/` — Project-specific overrides
+
+---
+
+## Configured Workflow
+
+{{WORKFLOW_SUMMARY}}
+
+### Available Workflows
+
+| Workflow | Description | Phases |
+|----------|-------------|--------|
+| fast-track | Simple, well-defined features | 0→1→2→4→5 |
+| standard | Most features | 0→1→(1.5)→2→3→4→5 |
+| full-morph | Complex features with sync | 0→1→1.5→2→3→4→5→6 |
+| design-impl | Pre-planned work | 2→4→5 |
+| ui-refresh | Visual redesigns | 1.5→2→5 |
+
+---
+
+## Key Commands
+
+```bash
+# Start a feature
+# Just ask Claude Code to implement something
+
+# Check feature progress
+morph-spec status <feature>
+
+# Validate feature outputs
+morph-spec validate-feature <feature>
+
+# Approve the current gate and scaffold the next phase folder
+morph-spec advance <feature>
+
+# Archive a finished feature (after Gate 3)
+morph-spec archive <feature>
+
+# Health check
+morph-spec doctor
+```
+
+> **Task tracking is native.** During the implement phase Claude tracks its own
+> work with the `TaskCreate`/`TaskUpdate` tools and persists progress by writing
+> `tasks.json` (only the `status`, `outputs`, and `notes` fields). State is synced
+> automatically by the `state-sync` hook — task tracking is native, not a CLI command.
+
+---
+
+## Project Structure
+
+```
+{{PROJECT_NAME}}/
+├── CLAUDE.md                      # Claude Code instructions
+├── .morph/
+│   ├── config/
+│   │   └── config.json            # Project configuration
+│   ├── framework/
+│   │   ├── agents.json            # Agent definitions
+│   │   ├── standards/             # Framework standards
+│   │   └── templates/             # Output templates
+│   ├── context/                   # Project context & overrides
+│   └── features/{feature}/        # Feature outputs
+│       ├── 0-proposal/
+│       ├── 1-design/              # optional (UI-heavy features)
+│       ├── 2-plan/
+│       ├── 3-implement/
+│       └── 4-review/
+└── .claude/
+    ├── commands/                  # Slash commands
+    ├── skills/                    # Workflow skills
+    └── settings.local.json        # Hooks & permissions
+```
+
+---
+
+## Getting Started
+
+1. **Ask Claude Code** to implement a feature
+2. **Follow the phases** — the framework guides you automatically
+3. **Approve at pauses** — design and task breakdowns need your approval
+4. **Check progress** with `morph-spec status <feature>`
+
+---
+
+*Generated by MORPH-SPEC v{{VERSION}} — Polymorphism Tech*

package/framework/templates/docs/proposal.md

@@ -21,6 +21,16 @@
 
 ---
 
+## Acceptance Criteria
+
+Verifiable conditions that mean this feature is done:
+
+- [ ] {Criterion 1 — observable / testable}
+- [ ] {Criterion 2}
+- [ ] {Criterion 3}
+
+---
+
 ## Problem Statement
 
 ### What is the problem?
@@ -60,7 +70,7 @@
 | **Database** | Neon (PostgreSQL + RLS) | {tables, policies, storage} |
 | **Backend API** | .NET 10 Minimal API | {endpoints, business logic} |
 | **Frontend** | Next.js 15 (App Router) | {pages, components, auth} |
-| **Infra** | EasyPanel + Docker | {deployment, SSL} |
+| **Infra** | Coolify + Docker | {deployment, SSL} |
 {{/if}}
 
 ### User Journey
@@ -80,7 +90,7 @@
 | Resource | Provider | Monthly Cost | Notes |
 |----------|----------|-------------|-------|
 | Neon | Free / Launch | $0 - $19 | {DB, Connection Pooling, Branching} |
-| VPS (EasyPanel) | {provider} | ${X} | {API + Web containers} |
+| VPS (Coolify) | {provider} | ${X} | {API + Web containers} |
 | External APIs | {provider} | ${X} | {if applicable} |
 | **Total** | | **${X}/month** | |