@polymorphism-tech/morph-spec 4.3.1 → 4.3.2

package/stacks/blazor-azure/.morph/schemas/agent.schema.json

@@ -0,0 +1,296 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://polymorphism.com.br/morph-spec/schemas/agent.schema.json",
+  "title": "MORPH-SPEC Agent Configuration Schema",
+  "description": "JSON Schema for validating agents.json configuration file",
+  "type": "object",
+  "required": ["version", "agents"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Schema version",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "examples": ["1.0.0", "2.1.0"]
+    },
+    "agents": {
+      "type": "object",
+      "description": "Agent definitions organized by type",
+      "required": ["core", "specialists"],
+      "properties": {
+        "core": {
+          "type": "array",
+          "description": "Core agents (always active)",
+          "items": {
+            "$ref": "#/definitions/agent"
+          },
+          "minItems": 1
+        },
+        "specialists": {
+          "type": "array",
+          "description": "Specialist agents (activated on-demand by keywords)",
+          "items": {
+            "$ref": "#/definitions/specialistAgent"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "agent": {
+      "type": "object",
+      "description": "Base agent definition",
+      "required": ["id", "name", "emoji", "type", "description", "responsibilities"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique agent identifier (kebab-case)",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "examples": ["standards-architect", "azure-architect"]
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable agent name",
+          "minLength": 3,
+          "maxLength": 50,
+          "examples": ["Standards Architect", "Azure Architect"]
+        },
+        "emoji": {
+          "type": "string",
+          "description": "Agent emoji (single character)",
+          "pattern": "^.{1,2}$",
+          "examples": ["📐", "☁️", "🔥"]
+        },
+        "type": {
+          "type": "string",
+          "description": "Agent type",
+          "enum": ["core", "specialist"],
+          "examples": ["core", "specialist"]
+        },
+        "skillPath": {
+          "type": "string",
+          "description": "Path to agent skill file (relative to repo root)",
+          "pattern": "^[^/].*\\.md$",
+          "examples": [".claude/skills/specialists/standards-architect.md"]
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief agent description (PT-BR or EN)",
+          "minLength": 10,
+          "maxLength": 200,
+          "examples": ["Guardião dos padrões de código e arquitetura"]
+        },
+        "responsibilities": {
+          "type": "array",
+          "description": "List of agent responsibilities",
+          "items": {
+            "type": "string",
+            "minLength": 5,
+            "maxLength": 150
+          },
+          "minItems": 1,
+          "maxItems": 10,
+          "examples": [
+            ["Validar aderência aos padrões", "Revisar nomenclatura"]
+          ]
+        },
+        "validatesPhases": {
+          "type": "array",
+          "description": "Which MORPH phases this agent validates",
+          "items": {
+            "type": "string",
+            "enum": ["setup", "uiux-design", "design", "clarify", "tasks", "implement", "sync"]
+          },
+          "uniqueItems": true,
+          "examples": [["design", "implement"]]
+        },
+        "expertise": {
+          "type": "array",
+          "description": "Areas of expertise",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          },
+          "examples": [["Container Apps", "Azure SQL", "Bicep"]]
+        },
+        "patterns": {
+          "type": "array",
+          "description": "Technical patterns the agent specializes in",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          },
+          "examples": [["CQRS", "Repository", "DI"]]
+        },
+        "limits": {
+          "type": "object",
+          "description": "Agent-specific limits (e.g., for Cost Guardian)",
+          "additionalProperties": true
+        },
+        "defaultModel": {
+          "type": "string",
+          "description": "Default AI model for this agent",
+          "examples": ["gpt-4o-mini", "claude-3-5-sonnet"]
+        },
+        "deliverables": {
+          "type": "array",
+          "description": "Outputs this agent is responsible for",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          },
+          "examples": [["ui-design-system.md", "ui-mockups.md"]]
+        },
+        "workflow": {
+          "type": "array",
+          "description": "Step-by-step workflow for this agent",
+          "items": {
+            "type": "string",
+            "minLength": 5,
+            "maxLength": 200
+          },
+          "examples": [
+            ["1. Analisar contexto", "2. Gerar proposta", "3. Validar com usuário"]
+          ]
+        },
+        "techniques": {
+          "type": "array",
+          "description": "Techniques or methodologies the agent uses",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          },
+          "examples": [["5 Whys", "MoSCoW", "User story mapping"]]
+        }
+      },
+      "additionalProperties": false
+    },
+    "specialistAgent": {
+      "type": "object",
+      "required": ["id", "name", "emoji", "type", "description", "responsibilities", "autoActivation"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique agent identifier (kebab-case)",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable agent name",
+          "minLength": 3,
+          "maxLength": 50
+        },
+        "emoji": {
+          "type": "string",
+          "description": "Agent emoji (single character)",
+          "pattern": "^.{1,2}$"
+        },
+        "type": {
+          "const": "specialist"
+        },
+        "skillPath": {
+          "type": "string",
+          "description": "Path to agent skill file",
+          "pattern": "^[^/].*\\.md$"
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief agent description",
+          "minLength": 10,
+          "maxLength": 200
+        },
+        "responsibilities": {
+          "type": "array",
+          "description": "List of agent responsibilities",
+          "items": {
+            "type": "string",
+            "minLength": 5,
+            "maxLength": 150
+          },
+          "minItems": 1,
+          "maxItems": 10
+        },
+        "autoActivation": {
+          "type": "object",
+          "description": "Auto-activation configuration for specialist agents",
+          "required": ["keywords"],
+          "properties": {
+            "keywords": {
+              "type": "array",
+              "description": "Keywords that trigger this agent (lowercase, alphanumeric + hyphens/underscores)",
+              "items": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_-]*$",
+                "minLength": 2,
+                "maxLength": 50
+              },
+              "minItems": 1,
+              "uniqueItems": true
+            },
+            "minKeywords": {
+              "type": "integer",
+              "description": "Minimum number of keyword matches required (default: 1)",
+              "minimum": 1,
+              "default": 1
+            }
+          },
+          "additionalProperties": false
+        },
+        "validatesPhases": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["setup", "uiux-design", "design", "clarify", "tasks", "implement", "sync"]
+          },
+          "uniqueItems": true
+        },
+        "expertise": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          }
+        },
+        "patterns": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          }
+        },
+        "deliverables": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          }
+        },
+        "workflow": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 5,
+            "maxLength": 200
+          }
+        },
+        "techniques": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/stacks/blazor-azure/.morph/schemas/tasks.schema.json

@@ -0,0 +1,220 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://morph-spec.dev/schemas/tasks.schema.json",
+  "title": "MORPH-SPEC Tasks Schema",
+  "description": "Schema for tasks.json files in MORPH-SPEC features",
+  "type": "object",
+  "required": ["version", "feature", "tasks"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Schema version",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "examples": ["3.0.0"]
+    },
+    "feature": {
+      "type": "string",
+      "description": "Feature name (kebab-case)",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
+      "examples": ["scheduled-reports", "user-auth"]
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Creation timestamp"
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Last update timestamp"
+    },
+    "summary": {
+      "type": "object",
+      "description": "Task summary statistics",
+      "properties": {
+        "total": { "type": "integer", "minimum": 0 },
+        "completed": { "type": "integer", "minimum": 0 },
+        "inProgress": { "type": "integer", "minimum": 0 },
+        "pending": { "type": "integer", "minimum": 0 },
+        "blocked": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "tasks": {
+      "type": "array",
+      "description": "List of tasks",
+      "items": {
+        "$ref": "#/definitions/task"
+      }
+    },
+    "checkpoints": {
+      "type": "array",
+      "description": "Checkpoint definitions",
+      "items": {
+        "$ref": "#/definitions/checkpoint"
+      }
+    }
+  },
+  "definitions": {
+    "task": {
+      "type": "object",
+      "required": ["id", "title", "status"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Task ID (format: T001, T002, etc.)",
+          "pattern": "^T\\d{3}$",
+          "examples": ["T001", "T002", "T010"]
+        },
+        "title": {
+          "type": "string",
+          "description": "Task title (short description)",
+          "maxLength": 100,
+          "examples": ["Create ScheduledReport entity"]
+        },
+        "description": {
+          "type": "string",
+          "description": "Detailed task description"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["pending", "in_progress", "completed", "blocked", "skipped"],
+          "description": "Current task status"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["entity", "command", "query", "handler", "service", "component", "page", "test", "migration", "config", "infra", "docs"],
+          "description": "Type of task"
+        },
+        "priority": {
+          "type": "string",
+          "enum": ["low", "medium", "high", "critical"],
+          "description": "Task priority"
+        },
+        "dependencies": {
+          "type": "array",
+          "description": "IDs of tasks that must be completed first",
+          "items": {
+            "type": "string",
+            "pattern": "^T\\d{3}$"
+          },
+          "examples": [["T001", "T002"]]
+        },
+        "files": {
+          "type": "array",
+          "description": "Files to be created or modified",
+          "items": {
+            "type": "string"
+          },
+          "examples": [["Domain/Entities/ScheduledReport.cs", "Infrastructure/Persistence/Config/ScheduledReportConfig.cs"]]
+        },
+        "checkpoint": {
+          "type": "string",
+          "description": "Checkpoint ID this task belongs to",
+          "pattern": "^CP\\d{3}$"
+        },
+        "estimatedLines": {
+          "type": "integer",
+          "description": "Estimated lines of code",
+          "minimum": 0
+        },
+        "actualLines": {
+          "type": "integer",
+          "description": "Actual lines of code (after completion)",
+          "minimum": 0
+        },
+        "completedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Completion timestamp"
+        },
+        "notes": {
+          "type": "string",
+          "description": "Additional notes or comments"
+        },
+        "blockedReason": {
+          "type": "string",
+          "description": "Reason for blocked status"
+        }
+      }
+    },
+    "checkpoint": {
+      "type": "object",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Checkpoint ID",
+          "pattern": "^CP\\d{3}$",
+          "examples": ["CP001", "CP002"]
+        },
+        "name": {
+          "type": "string",
+          "description": "Checkpoint name",
+          "examples": ["Entity Layer Complete", "Backend Complete"]
+        },
+        "afterTasks": {
+          "type": "array",
+          "description": "Task IDs after which this checkpoint triggers",
+          "items": {
+            "type": "string",
+            "pattern": "^T\\d{3}$"
+          }
+        },
+        "validation": {
+          "type": "array",
+          "description": "Validation steps for this checkpoint",
+          "items": {
+            "type": "string"
+          },
+          "examples": [["Run tests", "Build project", "Review code"]]
+        }
+      }
+    }
+  },
+  "examples": [
+    {
+      "version": "3.0.0",
+      "feature": "scheduled-reports",
+      "createdAt": "2024-01-15T10:00:00Z",
+      "summary": {
+        "total": 9,
+        "completed": 0,
+        "inProgress": 0,
+        "pending": 9,
+        "blocked": 0
+      },
+      "tasks": [
+        {
+          "id": "T001",
+          "title": "Create ScheduledReport entity",
+          "status": "pending",
+          "type": "entity",
+          "priority": "high",
+          "files": [
+            "Domain/Entities/ScheduledReport.cs",
+            "Infrastructure/Persistence/Config/ScheduledReportConfig.cs"
+          ],
+          "estimatedLines": 100
+        },
+        {
+          "id": "T002",
+          "title": "Create CreateReportCommand + Handler",
+          "status": "pending",
+          "type": "command",
+          "dependencies": ["T001"],
+          "files": [
+            "Application/Features/Reports/Commands/CreateReportCommand.cs"
+          ]
+        }
+      ],
+      "checkpoints": [
+        {
+          "id": "CP001",
+          "name": "Entity Layer Complete",
+          "afterTasks": ["T001", "T002", "T003"],
+          "validation": ["Build project", "Run unit tests"]
+        }
+      ]
+    }
+  ]
+}

package/stacks/blazor-azure/.morph/specs/.gitkeep

@@ -0,0 +1,20 @@
+# Specs Ativas
+
+Esta pasta contém as especificações ATIVAS do projeto.
+Specs são extraídas de features arquivadas e representam a "verdade atual" do sistema.
+
+## Estrutura
+
+```
+specs/
+└── {domain}/
+    └── spec.md
+```
+
+## Como usar
+
+1. Quando uma feature é arquivada, specs relevantes são extraídas para cá
+2. Specs aqui são a referência para comportamento do sistema
+3. Novas features podem referenciar e modificar estas specs
+
+*Gerado pelo MORPH Framework*