@orchestrator-claude/cli 3.0.1 → 3.1.0

package/templates/base/claude/agents/specifier.md

@@ -258,29 +258,11 @@ O artefato deve:
 
 **ATENCAO:** Alem de gerar o artefato, voce DEVE manter a governanca do workflow.
 
-### 1. Registrar Artefato em orchestrator-index.json
-
-Apos criar o `spec.md`, atualize `.orchestrator/orchestrator-index.json`:
-
-```json
-{
-  "activeWorkflow": {
-    "currentPhase": "specify",
-    "status": "in_progress"
-  },
-  "artifacts": [
-    {
-      "id": "art-XXX",
-      "type": "specification",
-      "path": ".orchestrator/artifacts/specify/spec.md",
-      "status": "draft",
-      "createdAt": "{timestamp}",
-      "workflowId": "{workflowId}",
-      "phase": "specify"
-    }
-  ]
-}
-```
+### 1. Artifact Registration (automatic via MCP tools)
+
+Artifacts are automatically registered in PostgreSQL when stored via MCP `artifactStore` tool. Sub-agents MUST NOT edit `.orchestrator/orchestrator-index.json` directly.
+
+The CLI will use MCP tools to update workflow state in PostgreSQL after artifact storage.
 
 ### 2. Validar Artefato
 
@@ -304,28 +286,17 @@ Parametros:
   - description: "Complete SPECIFY phase - [nome da feature]"
 ```
 
-### 4. Atualizar Gate
+### 4. Return Structured Output
 
-Atualize o gate da fase specify:
-
-```json
-{
-  "gates": {
-    "specify": {
-      "passed": true,
-      "evaluatedAt": "{timestamp}"
-    }
-  }
-}
-```
+Return structured output to the CLI for state update. The CLI will use MCP tools to update the phase gate in PostgreSQL.
 
 ### Checklist de Governanca (OBRIGATORIO)
 
 Antes de considerar a fase SPECIFY finalizada:
 
 - [ ] spec.md criado em .orchestrator/artifacts/specify/
-- [ ] Artefato registrado em orchestrator-index.json
+- [ ] Structured output returned to CLI for state update
 - [ ] Validacao executada via artifact-validator
 - [ ] Status do artefato = "validated"
 - [ ] Checkpoint criado via MCP
-- [ ] Gate specify.passed = true
+- [ ] Gate specify.passed = true (updated via CLI)

package/templates/base/claude/agents/task-generator.md

@@ -298,29 +298,11 @@ O artefato deve:
 
 **ATENCAO:** Alem de gerar o artefato, voce DEVE manter a governanca do workflow.
 
-### 1. Registrar Artefato em orchestrator-index.json
-
-Apos criar o `tasks.md`, atualize `.orchestrator/orchestrator-index.json`:
-
-```json
-{
-  "activeWorkflow": {
-    "currentPhase": "tasks",
-    "status": "in_progress"
-  },
-  "artifacts": [
-    {
-      "id": "art-XXX",
-      "type": "tasks",
-      "path": ".orchestrator/artifacts/tasks/tasks.md",
-      "status": "draft",
-      "createdAt": "{timestamp}",
-      "workflowId": "{workflowId}",
-      "phase": "tasks"
-    }
-  ]
-}
-```
+### 1. Artifact Registration (automatic via MCP tools)
+
+Artifacts are automatically registered in PostgreSQL when stored via MCP `artifactStore` tool. Sub-agents MUST NOT edit `.orchestrator/orchestrator-index.json` directly.
+
+The CLI will use MCP tools to update workflow state in PostgreSQL after artifact storage.
 
 ### 2. Validar Artefato
 
@@ -344,39 +326,19 @@ Parametros:
   - description: "Complete TASKS phase - [nome da feature]"
 ```
 
-### 4. Atualizar Gate e Preparar para IMPLEMENT
-
-Atualize o gate da fase tasks e prepare para human-in-the-loop:
-
-```json
-{
-  "gates": {
-    "tasks": {
-      "passed": true,
-      "evaluatedAt": "{timestamp}"
-    },
-    "implement": {
-      "passed": false,
-      "pending": true,
-      "requiresApproval": true
-    }
-  },
-  "activeWorkflow": {
-    "status": "awaiting_approval",
-    "nextPhase": "implement"
-  }
-}
-```
+### 4. Return Structured Output for Human Approval
+
+Return structured output to the CLI indicating that tasks phase is complete and human approval is required before IMPLEMENT. The CLI will use MCP tools to update workflow state in PostgreSQL to "awaiting_approval".
 
 ### Checklist de Governanca (OBRIGATORIO)
 
 Antes de considerar a fase TASKS finalizada:
 
 - [ ] tasks.md criado em .orchestrator/artifacts/tasks/
-- [ ] Artefato registrado em orchestrator-index.json
+- [ ] Structured output returned to CLI for state update
 - [ ] Validacao executada via artifact-validator
 - [ ] Status do artefato = "validated"
 - [ ] Checkpoint criado via MCP
-- [ ] Gate tasks.passed = true
-- [ ] Gate implement.requiresApproval = true (prepara human-in-the-loop)
-- [ ] Status do workflow = "awaiting_approval"
+- [ ] Gate tasks.passed = true (updated via CLI)
+- [ ] Gate implement.requiresApproval = true (set via CLI)
+- [ ] Status do workflow = "awaiting_approval" (set via CLI)