@polymorphism-tech/morph-spec 2.3.0 → 3.0.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