@polymorphism-tech/morph-spec 2.2.0 → 2.4.0

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

@@ -1,148 +1,149 @@
-# Feature Specification: {{FEATURE_NAME_TITLE}}
-
-## 📋 Metadata
-
-| Field | Value |
-|-------|-------|
-| **ID** | {{FEATURE_NAME}} |
-| **Status** | Draft / In Review / Approved / In Progress / Done |
-| **Created** | {{DATE}} |
-| **Stack** | {{STACK}} |
-| **Agents** | Core: All / Specialists: {list} |
-| **Estimated Cost** | ${X}/month |
-
----
-
-## 🎯 Overview
-
-### Problem Statement
-{Descreva o problema que esta feature resolve}
-
-### Proposed Solution
-{Descreva a solução em alto nível}
-
-### Success Criteria
-- [ ] {Critério 1}
-- [ ] {Critério 2}
-- [ ] {Critério 3}
-
----
-
-## 👤 User Stories
-
-### US001: {Título}
-
-**Como** {tipo de usuário}
-**Quero** {funcionalidade}
-**Para** {benefício}
-
-**Acceptance Criteria:**
-1. {Critério 1}
-2. {Critério 2}
-
-**Edge Cases:**
-- {Edge case 1}: {Como tratar}
-
----
-
-## 🏗️ Technical Design
-
-### Stack
-| Component | Technology |
-|-----------|------------|
-| Frontend | Blazor Server |
-| Backend | .NET 10 / C# 14 |
-| Database | Azure SQL |
-| AI | Microsoft Agent Framework (obrigatório) |
-
-### Architecture
-```
-User → Blazor UI → Service → Repository → Database
-                      ↓
-                 AI Agent → Azure OpenAI
-```
-
-### Data Model
-
-#### {EntityName}
-| Column | Type | Constraints |
-|--------|------|-------------|
-| Id | int | PK, Identity |
-| Name | nvarchar(200) | Required |
-| CreatedAt | datetime2 | Default: GETUTCDATE() |
-
-### Contracts
-```csharp
-public interface I{{FEATURE_NAME_PASCAL}}Service
-{
-    Task<{{FEATURE_NAME_PASCAL}}Dto> GetByIdAsync(int id);
-    Task<{{FEATURE_NAME_PASCAL}}Dto> CreateAsync(Create{{FEATURE_NAME_PASCAL}}Request request);
-}
-```
-
----
-
-## 🎨 UI/UX Design
-
-### Wireframes
-```
-┌─────────────────────────────────────┐
-│ {Page Title}                    [+] │
-├─────────────────────────────────────┤
-│ ┌─────────────────────────────────┐ │
-│ │ {Item}                   [Edit] │ │
-│ └─────────────────────────────────┘ │
-└─────────────────────────────────────┘
-```
-
-### User Flow
-1. Usuário acessa página
-2. Sistema carrega lista
-3. Usuário clica em [+]
-4. Modal de criação abre
-5. Usuário salva
-
----
-
-## 💰 Cost Analysis
-
-| Resource | Tier | Monthly Cost |
-|----------|------|--------------|
-| Azure SQL | Free | $0 |
-| Container Apps | Consumption | ~$2 |
-| Azure OpenAI | gpt-4o-mini | ~$2 |
-| **Total** | | **~$4** |
-
----
-
-## 🔐 Security
-
-| Action | Required Policy |
-|--------|-----------------|
-| View | CanView{Feature} |
-| Create | CanManage{Feature} |
-| Delete | CanManage{Feature} |
-
----
-
-## ⚠️ Risks
-
-| Risk | Impact | Mitigation |
-|------|--------|------------|
-| {Risk 1} | High | {Mitigation} |
-
----
-
-## 🚫 Out of Scope
-
-- {Item fora do escopo}
-
----
-
-## ✅ Definition of Done
-
-- [ ] Código implementado
-- [ ] Testes >80% coverage
-- [ ] Code review aprovado
-- [ ] Deploy em staging
-- [ ] Recap.md gerado
+# Feature Specification: {{FEATURE_NAME_TITLE}}
+
+| Field | Value |
+|-------|-------|
+| **ID** | {{FEATURE_NAME}} |
+| **Status** | Draft / In Review / Approved / In Progress / Done |
+| **Created** | {{DATE}} |
+| **Stack** | {{STACK}} |
+| **Complexity** | Low / Medium / High |
+| **Estimated Cost** | $X/month |
+| **Agents** | Core: All / Specialists: {list} |
+
+---
+
+## Overview
+
+**Problem:** {What problem this feature solves}
+
+**Solution:** {High-level solution}
+
+**Success Criteria:**
+- [ ] {Criterion 1}
+- [ ] {Criterion 2}
+
+---
+
+## Requirements
+
+**Functional:** FR1: {desc} | FR2: {desc} | FR3: {desc}
+
+**Non-Functional:** NFR1: Performance - {target} | NFR2: Reliability - {target}
+
+---
+
+## User Stories
+
+### US001: {Title}
+**As** {user type} **I want** {feature} **so that** {benefit}
+
+**Acceptance Criteria:** 1. {criterion} 2. {criterion}
+
+**Edge Cases:** {edge case}: {handling}
+
+---
+
+## Technical Design
+
+### Stack
+| Component | Technology |
+|-----------|------------|
+| Frontend | {Blazor Server / Next.js} |
+| Backend | .NET 10 / C# 14 |
+| Database | {Azure SQL / Cosmos DB} |
+
+### Data Model
+
+#### {EntityName}
+| Column | Type | Constraints |
+|--------|------|-------------|
+| Id | Guid | PK |
+| {Property} | {Type} | {Constraints} |
+| CreatedAt | datetime2 | Default: GETUTCDATE() |
+
+### Contracts
+
+> **Ref:** `framework/standards/blazor-efcore.md` for background operations
+
+```csharp
+public interface I{{FEATURE_NAME_PASCAL}}Service
+{
+    Task<{{FEATURE_NAME_PASCAL}}Dto> GetByIdAsync(int id);
+    Task<{{FEATURE_NAME_PASCAL}}Dto> CreateAsync(Create{{FEATURE_NAME_PASCAL}}Request request);
+}
+```
+
+**Contracts Workflow:** Generate `contracts.cs` FIRST → validate names → reference in spec → approve with user.
+
+**Validation Checklist:**
+- [ ] Property names are descriptive (not generic "Data", "Value")
+- [ ] Records use correct types (Stream vs byte[], Guid vs string)
+- [ ] Response DTOs have all properties needed for UI
+- [ ] Request DTOs have implicit validations (required, nullable)
+
+---
+
+## UI/UX Design (if front-end)
+
+### Wireframes
+```
+{ASCII wireframe per screen - include states: loading, error, empty}
+```
+
+### User Flow
+1. {Step} → {System response}
+
+---
+
+## Flows
+
+### {Flow Name}
+**Trigger:** {what starts this flow}
+1. {Actor} {action} → {system response}
+2. If {condition}: Path A / Else: Path B
+**End State:** {final state}
+
+---
+
+## Cost Estimate
+
+| Resource | SKU | Monthly Cost | Justification |
+|----------|-----|--------------|---------------|
+| {Resource} | {SKU} | ${X} | {Why} |
+| **Total** | | **${X}/month** | |
+
+---
+
+## ADRs (Architectural Decision Records)
+
+### ADR-001: {Decision Title}
+**Status:** Proposed / Accepted
+**Context:** {Why decide now}
+**Decision:** {What we chose}
+**Alternatives:** 1. {Alt} (pros/cons) 2. {Alt} (pros/cons)
+**Trade-offs:** {key trade-offs}
+
+---
+
+## Security
+
+| Action | Required Policy |
+|--------|-----------------|
+| View | CanView{Feature} |
+| Create | CanManage{Feature} |
+
+## Risks
+
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| {Risk} | {H/M/L} | {Mitigation} |
+
+## Out of Scope
+- {Item}
+
+## Definition of Done
+- [ ] Code implemented
+- [ ] Tests >80% coverage
+- [ ] Code review approved
+- [ ] Deploy to staging
+- [ ] Recap.md generated

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

@@ -1,68 +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
+# 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