@polymorphism-tech/morph-spec 4.7.1 → 4.7.2

package/.morph/framework/templates/context/CONTEXT.md

@@ -0,0 +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 BLAZOR_ENABLED}}- **Blazor Server** {{BLAZOR_VERSION}}{{/if}}
+{{#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 SUPABASE_ENABLED}}- **Supabase** (PostgreSQL + Auth + Storage + RLS)
+  - Project: {{SUPABASE_PROJECT_ID}}
+  - Region: {{SUPABASE_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
+
+# Generate design system
+morph-spec generate design-system {feature}
+
+# 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}}*

package/.morph/framework/templates/docs/clarifications.md

@@ -0,0 +1,253 @@
+# Clarifications - {{FEATURE_NAME_TITLE}}
+
+**Feature**: {{FEATURE_NAME}}
+**Date**: {{DATE}}
+**Phase**: CLARIFY (Phase 3)
+**Status**: {{#if status}}{{status}}{{else}}In Progress{{/if}}
+
+---
+
+## Purpose
+
+This document addresses ambiguities, edge cases, and questions identified during the design review. All clarifications should be incorporated back into `spec.md` after approval.
+
+---
+
+## Questions & Answers
+
+{{#each questions}}
+### Q{{this.id}}: {{this.category}} - {{this.title}}
+
+**Question:**
+{{this.question}}
+
+**Context:**
+{{this.context}}
+
+**Answer:**
+{{this.answer}}
+
+**Impact:**
+{{this.impact}}
+
+**Spec Updates Required:**
+{{#each this.specUpdates}}
+- {{this}}
+{{/each}}
+
+**Priority:** {{this.priority}}
+**Resolved:** {{#if this.resolved}}✅ Yes{{else}}❌ No{{/if}}
+**Resolved By:** {{#if this.resolvedBy}}{{this.resolvedBy}}{{else}}_Pending_{{/if}}
+
+---
+{{/each}}
+
+## Edge Cases Identified
+
+{{#each edgeCases}}
+### EC{{@index}}: {{this.title}}
+
+**Scenario:**
+{{this.scenario}}
+
+**Current Behavior:**
+{{this.currentBehavior}}
+
+**Expected Behavior:**
+{{this.expectedBehavior}}
+
+**Proposed Solution:**
+{{this.proposedSolution}}
+
+**Acceptance Criteria:**
+{{#each this.acceptanceCriteria}}
+- [ ] {{this}}
+{{/each}}
+
+**Affected Components:**
+{{#each this.affectedComponents}}
+- {{this}}
+{{/each}}
+
+---
+{{/each}}
+
+## Assumptions Validated
+
+{{#each assumptions}}
+### A{{@index}}: {{this.title}}
+
+**Assumption:**
+{{this.description}}
+
+**Validation:**
+{{#if this.validated}}✅ Confirmed{{else}}❌ Invalid{{/if}}
+
+**Notes:**
+{{this.notes}}
+
+**Action Required:**
+{{#if this.action}}{{this.action}}{{else}}_None_{{/if}}
+
+---
+{{/each}}
+
+## Business Rules Clarified
+
+{{#each businessRules}}
+### BR{{@index}}: {{this.title}}
+
+**Rule:**
+{{this.rule}}
+
+**Rationale:**
+{{this.rationale}}
+
+**Examples:**
+{{#each this.examples}}
+- {{this}}
+{{/each}}
+
+**Exceptions:**
+{{#if this.exceptions}}
+{{#each this.exceptions}}
+- {{this}}
+{{/each}}
+{{else}}
+_None_
+{{/if}}
+
+---
+{{/each}}
+
+## Data Validation Rules
+
+{{#each dataValidations}}
+### DV{{@index}}: {{this.field}} Validation
+
+**Field:** {{this.field}}
+**Entity:** {{this.entity}}
+
+**Validation Rules:**
+{{#each this.rules}}
+- {{this}}
+{{/each}}
+
+**Error Messages:**
+{{#each this.errorMessages}}
+- {{this.condition}}: "{{this.message}}"
+{{/each}}
+
+**Impact on UX:**
+{{this.uxImpact}}
+
+---
+{{/each}}
+
+## Performance & Scalability Clarifications
+
+{{#each performanceClarifications}}
+### PC{{@index}}: {{this.title}}
+
+**Concern:**
+{{this.concern}}
+
+**Clarification:**
+{{this.clarification}}
+
+**Solution:**
+{{this.solution}}
+
+**Performance Target:**
+{{this.target}}
+
+---
+{{/each}}
+
+## Security & Authorization Clarifications
+
+{{#each securityClarifications}}
+### SC{{@index}}: {{this.title}}
+
+**Security Concern:**
+{{this.concern}}
+
+**Clarification:**
+{{this.clarification}}
+
+**Implementation:**
+{{this.implementation}}
+
+**Affected Roles:**
+{{#each this.affectedRoles}}
+- {{this}}
+{{/each}}
+
+---
+{{/each}}
+
+## Integration & External Dependencies
+
+{{#each integrationClarifications}}
+### IC{{@index}}: {{this.title}}
+
+**External System:**
+{{this.externalSystem}}
+
+**Question:**
+{{this.question}}
+
+**Clarification:**
+{{this.clarification}}
+
+**API Endpoint/Method:**
+{{this.apiDetails}}
+
+**Error Handling:**
+{{this.errorHandling}}
+
+---
+{{/each}}
+
+## Summary
+
+**Total Questions:** {{#if totalQuestions}}{{totalQuestions}}{{else}}0{{/if}}
+**Resolved:** {{#if resolvedCount}}{{resolvedCount}}{{else}}0{{/if}}
+**Pending:** {{#if pendingCount}}{{pendingCount}}{{else}}0{{/if}}
+
+**Edge Cases Identified:** {{#if edgeCaseCount}}{{edgeCaseCount}}{{else}}0{{/if}}
+**Business Rules Documented:** {{#if businessRuleCount}}{{businessRuleCount}}{{else}}0{{/if}}
+**Assumptions Validated:** {{#if assumptionCount}}{{assumptionCount}}{{else}}0{{/if}}
+
+---
+
+## Next Steps
+
+1. [ ] Resolve all pending questions
+2. [ ] Update `spec.md` with all clarifications
+3. [ ] Update `contracts.cs` if data model changes are needed
+4. [ ] Document breaking changes in `decisions.md`
+5. [ ] Get stakeholder approval on all clarifications
+6. [ ] Advance to Phase 4 (Tasks)
+
+---
+
+## Spec Updates Log
+
+**Changes to be made to `spec.md`:**
+
+{{#each specUpdates}}
+### Update {{@index}}
+
+**Section:** {{this.section}}
+**Type:** {{this.type}}
+**Description:** {{this.description}}
+**From Clarification:** {{this.clarificationId}}
+
+---
+{{/each}}
+
+---
+
+*Generated by MORPH-SPEC v{{FRAMEWORK_VERSION}}*
+*All clarifications must be incorporated into spec.md before advancing to Phase 4*

package/.morph/framework/templates/docs/onboarding.md

@@ -0,0 +1,123 @@
+# 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 next <feature>
+morph-spec task start <feature> <task-id>
+morph-spec task done <feature> <task-id>
+
+# Save/restore checkpoints
+morph-spec checkpoint-save <feature>
+morph-spec checkpoint-list <feature>
+
+# View changes since last snapshot
+morph-spec diff <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/
+│       ├── 2-ui/
+│       ├── 3-tasks/
+│       └── 4-implement/
+└── .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*