@polymorphism-tech/morph-spec 1.0.4 → 2.1.0

package/content/.morph/templates/infra/parameters.prod.json

@@ -16,6 +16,12 @@
         "secretName": "sql-admin-password"
       }
     },
+    "hostingType": {
+      "value": "containerapp"
+    },
+    "appServiceSku": {
+      "value": "P1v2"
+    },
     "containerImage": {
       "value": "{{ACR_NAME}}.azurecr.io/{{APP_NAME}}:{{VERSION}}"
     }

package/content/.morph/templates/infra/parameters.staging.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
+  "contentVersion": "1.0.0.0",
+  "parameters": {
+    "environment": {
+      "value": "staging"
+    },
+    "appName": {
+      "value": "{{APP_NAME}}"
+    },
+    "sqlAdminPassword": {
+      "reference": {
+        "keyVault": {
+          "id": "/subscriptions/{{SUBSCRIPTION_ID}}/resourceGroups/{{RESOURCE_GROUP}}/providers/Microsoft.KeyVault/vaults/{{KEY_VAULT_NAME}}"
+        },
+        "secretName": "sql-admin-password"
+      }
+    },
+    "hostingType": {
+      "value": "containerapp"
+    },
+    "appServiceSku": {
+      "value": "B1"
+    },
+    "containerImage": {
+      "value": "{{ACR_NAME}}.azurecr.io/{{APP_NAME}}:latest"
+    }
+  }
+}

package/content/.morph/templates/proposal.md

@@ -1,4 +1,4 @@
-# Feature Proposal: {FEATURE_NAME}
+# Feature Proposal: {{FEATURE_NAME_TITLE}}
 
 > Proposta para nova feature. Este documento descreve O QUE e POR QUÊ.
 > Para detalhes técnicos, veja `spec.md`.
@@ -7,8 +7,8 @@
 
 | Field | Value |
 |-------|-------|
-| **Proposed** | {date} |
-| **Author** | {name} |
+| **Proposed** | {{DATE}} |
+| **Author** | {{AUTHOR}} |
 | **Status** | Draft / Under Review / Approved / Rejected |
 | **Priority** | High / Medium / Low |
 

package/content/.morph/templates/recap.md

@@ -1,11 +1,11 @@
-# Feature Recap: {Feature Name}
+# Feature Recap: {{FEATURE_NAME_TITLE}}
 
 ## 📋 Summary
 
 | Field | Value |
 |-------|-------|
 | **Feature ID** | {feature-id} |
-| **Completed** | {date} |
+| **Completed** | {{DATE}} |
 | **Total Tasks** | {X} |
 | **Time Spent** | {X}h |
 | **Agents Used** | {list} |
@@ -102,4 +102,4 @@ See full ADRs in `decisions.md`
 
 ---
 
-*Generated by MORPH Framework on {date}*
+*Generated by MORPH Framework on {{DATE}}*

package/content/.morph/templates/spec.md

@@ -1,12 +1,13 @@
-# Feature Specification: {FEATURE_NAME}
+# Feature Specification: {{FEATURE_NAME_TITLE}}
 
 ## 📋 Metadata
 
 | Field | Value |
 |-------|-------|
-| **ID** | {feature-id} |
+| **ID** | {{FEATURE_NAME}} |
 | **Status** | Draft / In Review / Approved / In Progress / Done |
-| **Created** | {date} |
+| **Created** | {{DATE}} |
+| **Stack** | {{STACK}} |
 | **Agents** | Core: All / Specialists: {list} |
 | **Estimated Cost** | ${X}/month |
 
@@ -50,9 +51,9 @@
 | Component | Technology |
 |-----------|------------|
 | Frontend | Blazor Server |
-| Backend | .NET 9 |
+| Backend | .NET 10 / C# 14 |
 | Database | Azure SQL |
-| AI | MS Agent Framework |
+| AI | Microsoft Agent Framework (obrigatório) |
 
 ### Architecture
 ```
@@ -72,10 +73,10 @@ User → Blazor UI → Service → Repository → Database
 
 ### Contracts
 ```csharp
-public interface I{Feature}Service
+public interface I{{FEATURE_NAME_PASCAL}}Service
 {
-    Task<{Feature}Dto> GetByIdAsync(int id);
-    Task<{Feature}Dto> CreateAsync(Create{Feature}Request request);
+    Task<{{FEATURE_NAME_PASCAL}}Dto> GetByIdAsync(int id);
+    Task<{{FEATURE_NAME_PASCAL}}Dto> CreateAsync(Create{{FEATURE_NAME_PASCAL}}Request request);
 }
 ```
 

package/content/.morph/templates/sprint-status.yaml

@@ -0,0 +1,68 @@
+# MORPH-SPEC Sprint Status
+# Auto-updated by create-story.js and update-sprint-status.js
+# Tracks story-level progress within a feature/epic
+
+feature: {{FEATURE_NAME}}
+epic: {{EPIC_NAME}}
+sprint: {{SPRINT_NUMBER}}
+created: {{DATE}}
+updated: {{DATE}}
+
+# Story progression
+stories:
+  - id: {{STORY_ID_1}}
+    title: {{STORY_TITLE_1}}
+    file: .morph/project/outputs/{{FEATURE_NAME}}/stories/{{STORY_ID_1}}.md
+    status: ready           # ready | in_progress | ready_for_qa | done
+    assigned: {{AGENT}}     # sm | dev | qa
+    created: {{DATE}}
+    started: null
+    completed: null
+
+  - id: {{STORY_ID_2}}
+    title: {{STORY_TITLE_2}}
+    file: .morph/project/outputs/{{FEATURE_NAME}}/stories/{{STORY_ID_2}}.md
+    status: pending
+    assigned: sm
+    created: {{DATE}}
+    started: null
+    completed: null
+
+# Progress metrics
+metrics:
+  total_stories: {{TOTAL_STORIES}}
+  ready: {{READY_COUNT}}
+  in_progress: {{IN_PROGRESS_COUNT}}
+  ready_for_qa: {{QA_COUNT}}
+  done: {{DONE_COUNT}}
+  completion_percent: {{COMPLETION_PERCENT}}
+
+# Current focus
+current:
+  story_id: {{CURRENT_STORY_ID}}
+  agent: {{CURRENT_AGENT}}
+  phase: implementation  # planning | implementation | review
+
+# Next story to work on
+next:
+  story_id: {{NEXT_STORY_ID}}
+  recommendation: "Story {{NEXT_STORY_ID}} is ready for development"
+
+---
+# Usage Notes:
+#
+# Status Transitions:
+# pending → ready (SM creates story with full context)
+# ready → in_progress (Dev starts implementation)
+# in_progress → ready_for_qa (Dev completes, adds Dev Notes)
+# ready_for_qa → done (QA approves, adds QA Notes)
+#
+# Fresh Chat Pattern (BMAD-inspired):
+# Each story should run in a FRESH Claude session to avoid context pollution
+#
+# Example workflow:
+# 1. SM: node bin/create-story.js scheduled-reports SR-001
+# 2. Dev: Open NEW chat → /dev → Implement SR-001
+# 3. QA: Open NEW chat → /qa → Review SR-001
+#
+# This prevents token bloat and reduces hallucinations

package/content/.morph/templates/state.template.json

@@ -0,0 +1,222 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MORPH-SPEC State Schema",
+  "description": "Schema for tracking project state, features, and progress in MORPH-SPEC framework",
+  "type": "object",
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "MORPH-SPEC framework version",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "project": {
+      "type": "object",
+      "description": "Project information",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Project name"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["blazor-server", "nextjs", "shopify"],
+          "description": "Primary stack type"
+        },
+        "createdAt": {
+          "type": ["string", "null"],
+          "format": "date-time",
+          "description": "Project creation timestamp"
+        },
+        "updatedAt": {
+          "type": ["string", "null"],
+          "format": "date-time",
+          "description": "Last update timestamp"
+        }
+      },
+      "required": ["name", "type"]
+    },
+    "features": {
+      "type": "object",
+      "description": "Dictionary of features by name",
+      "patternProperties": {
+        "^[a-z0-9-]+$": {
+          "type": "object",
+          "properties": {
+            "status": {
+              "type": "string",
+              "enum": ["draft", "in_review", "approved", "in_progress", "done", "archived"],
+              "description": "Current feature status"
+            },
+            "phase": {
+              "type": "string",
+              "enum": ["proposal", "setup", "ui-ux-design", "design", "clarify", "tasks", "implement"],
+              "description": "Current workflow phase"
+            },
+            "createdAt": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "updatedAt": {
+              "type": "string",
+              "format": "date-time"
+            },
+            "activeAgents": {
+              "type": "array",
+              "description": "List of currently active agent IDs",
+              "items": {
+                "type": "string"
+              }
+            },
+            "outputs": {
+              "type": "object",
+              "description": "Generated outputs for this feature",
+              "properties": {
+                "proposal": {
+                  "type": "object",
+                  "properties": {
+                    "created": { "type": "boolean" },
+                    "path": { "type": "string" }
+                  }
+                },
+                "spec": {
+                  "type": "object",
+                  "properties": {
+                    "created": { "type": "boolean" },
+                    "path": { "type": "string" }
+                  }
+                },
+                "contracts": {
+                  "type": "object",
+                  "properties": {
+                    "created": { "type": "boolean" },
+                    "path": { "type": "string" }
+                  }
+                },
+                "tasks": {
+                  "type": "object",
+                  "properties": {
+                    "created": { "type": "boolean" },
+                    "path": { "type": "string" }
+                  }
+                },
+                "uiDesignSystem": {
+                  "type": "object",
+                  "properties": {
+                    "created": { "type": "boolean" },
+                    "path": { "type": "string" }
+                  }
+                },
+                "uiMockups": {
+                  "type": "object",
+                  "properties": {
+                    "created": { "type": "boolean" },
+                    "path": { "type": "string" }
+                  }
+                },
+                "uiComponents": {
+                  "type": "object",
+                  "properties": {
+                    "created": { "type": "boolean" },
+                    "path": { "type": "string" }
+                  }
+                },
+                "uiFlows": {
+                  "type": "object",
+                  "properties": {
+                    "created": { "type": "boolean" },
+                    "path": { "type": "string" }
+                  }
+                },
+                "decisions": {
+                  "type": "object",
+                  "properties": {
+                    "created": { "type": "boolean" },
+                    "path": { "type": "string" }
+                  }
+                },
+                "recap": {
+                  "type": "object",
+                  "properties": {
+                    "created": { "type": "boolean" },
+                    "path": { "type": "string" }
+                  }
+                }
+              }
+            },
+            "tasks": {
+              "type": "object",
+              "description": "Task progress counters",
+              "properties": {
+                "total": { "type": "integer", "minimum": 0 },
+                "completed": { "type": "integer", "minimum": 0 },
+                "inProgress": { "type": "integer", "minimum": 0 },
+                "pending": { "type": "integer", "minimum": 0 }
+              }
+            },
+            "checkpoints": {
+              "type": "array",
+              "description": "List of checkpoints recorded",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "timestamp": {
+                    "type": "string",
+                    "format": "date-time"
+                  },
+                  "phase": { "type": "string" },
+                  "completedTasks": { "type": "integer" },
+                  "note": { "type": "string" }
+                },
+                "required": ["timestamp", "phase", "completedTasks"]
+              }
+            },
+            "costs": {
+              "type": "object",
+              "description": "Cost tracking information",
+              "properties": {
+                "estimated": {
+                  "type": "number",
+                  "description": "Estimated monthly cost in USD"
+                },
+                "approved": { "type": "boolean" },
+                "approvedBy": { "type": "string" },
+                "approvedAt": {
+                  "type": ["string", "null"],
+                  "format": "date-time"
+                }
+              }
+            }
+          },
+          "required": ["status", "phase", "createdAt", "updatedAt", "activeAgents", "outputs", "tasks"]
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Global project metadata",
+      "properties": {
+        "totalFeatures": {
+          "type": "integer",
+          "description": "Total number of features ever created"
+        },
+        "completedFeatures": {
+          "type": "integer",
+          "description": "Number of completed features"
+        },
+        "totalCostEstimated": {
+          "type": "number",
+          "description": "Sum of all estimated costs"
+        },
+        "totalTimeSpent": {
+          "type": "number",
+          "description": "Total hours spent on all features"
+        },
+        "lastUpdated": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        }
+      }
+    }
+  },
+  "required": ["version", "project", "features", "metadata"]
+}

package/content/.morph/templates/story.md

@@ -0,0 +1,143 @@
+# Story {{STORY_ID}}: {{STORY_TITLE}}
+
+> **Feature:** {{FEATURE_NAME_TITLE}}
+> **Epic:** {{EPIC_NAME}}
+> **Created:** {{DATE}}
+
+---
+
+## 📋 Context
+
+{{STORY_CONTEXT}}
+
+**Related Spec Section:** `.morph/outputs/{{FEATURE_NAME}}/spec/{{SPEC_SHARD}}.md`
+
+---
+
+## 🔗 Dependencies
+
+### Architecture References
+{{#ARCHITECTURE_REFS}}
+- {{.}}
+{{/ARCHITECTURE_REFS}}
+
+### Contract References
+{{#CONTRACT_REFS}}
+- {{.}}
+{{/CONTRACT_REFS}}
+
+### Related Stories
+{{#RELATED_STORIES}}
+- [ ] {{.}}
+{{/RELATED_STORIES}}
+
+---
+
+## ✅ Tasks
+
+{{#TASKS}}
+- [ ] {{.}}
+{{/TASKS}}
+
+**Estimated Effort:** {{EFFORT}} (max 1 developer-day)
+
+---
+
+## 💡 Dev Notes (Auto-Injected by SM)
+
+{{#DEV_NOTES}}
+- {{.}}
+{{/DEV_NOTES}}
+
+### Standards to Follow
+- **Coding:** `.morph/standards/coding.md#{{CODING_PATTERN}}`
+- **Architecture:** `.morph/standards/architecture.md#{{ARCH_PATTERN}}`
+{{#AZURE_PATTERN}}
+- **Azure/IaC:** `.morph/standards/azure.md#{{AZURE_PATTERN}}`
+{{/AZURE_PATTERN}}
+
+---
+
+## 🎯 Acceptance Criteria (Gherkin Format)
+
+{{#ACCEPTANCE_CRITERIA}}
+- [ ] **GIVEN** {{given}} **WHEN** {{when}} **THEN** {{then}}
+{{/ACCEPTANCE_CRITERIA}}
+
+---
+
+## 🛠️ Implementation Notes
+
+### Dev Notes (Added by Dev Agent)
+```
+[Dev agent adds notes here after implementation]
+
+Example:
+✅ Implemented ScheduledReport.cs with Primary Constructor
+✅ EF mapping configured in ReportDbContext.cs (line 45)
+✅ Migration: 20251209_AddScheduledReports.cs
+⚠️ ATTENTION QA: RecurrencePattern uses complex regex (validate edge cases line 67)
+✅ Tests: 12 unit tests, 95% coverage in ScheduledReportTests.cs
+```
+
+### QA Notes (Added by QA Agent)
+```
+[QA agent adds notes here after review]
+
+Example:
+✅ Review complete - code follows standards
+✅ Refactored: extracted ValidateRecurrence() method (line 89)
+✅ Added 3 edge case tests (invalid cron expressions)
+✅ Documented regex pattern in decisions.md (ADR-007)
+⚠️ TODO: Add integration test for full CRUD cycle
+```
+
+---
+
+## 📊 Status Tracking
+
+**Current Status:** {{STATUS}}
+
+| Status | Date | Agent | Notes |
+|--------|------|-------|-------|
+| Created | {{CREATED_DATE}} | SM | Story created from epic |
+| Ready | {{READY_DATE}} | SM | Prerequisites met, ready for dev |
+| In Progress | {{IN_PROGRESS_DATE}} | Dev | Implementation started |
+| Ready for QA | {{QA_DATE}} | Dev | Implementation complete, awaiting review |
+| Done | {{DONE_DATE}} | QA | Approved, ready for merge |
+
+---
+
+## 🔄 Handoff Protocol
+
+### SM → Dev Handoff
+- ✅ Story file created with complete context
+- ✅ Dev Notes injected with architectural guidance
+- ✅ Acceptance criteria defined and verifiable
+- ✅ Dependencies documented
+- ✅ Status: **Ready for Dev**
+
+### Dev → QA Handoff
+- [ ] All tasks checked off
+- [ ] Dev Notes added with implementation details
+- [ ] Tests written (unit + integration as needed)
+- [ ] Code follows standards (validated via pre-commit hooks)
+- [ ] Status updated to: **Ready for QA**
+
+### QA → Done
+- [ ] QA Notes added with review findings
+- [ ] Code reviewed and refactored if needed
+- [ ] All acceptance criteria validated
+- [ ] Documentation updated (if applicable)
+- [ ] Status updated to: **Done**
+
+---
+
+## 📝 Additional Notes
+
+{{ADDITIONAL_NOTES}}
+
+---
+
+*Generated by MORPH-SPEC Framework - Story-Driven Development*
+*Inspired by BMAD Method: Self-contained stories for AI agents*

package/content/.morph/templates/tasks.md

@@ -1,4 +1,4 @@
-# Tasks - {FEATURE_NAME}
+# Tasks - {{FEATURE_NAME_TITLE}}
 
 > Checklist de implementação para a feature.
 > Atualize o status conforme progresso.