@orchestrator-claude/definitions 3.5.0

package/skills/workflow-status/SKILL.md

@@ -0,0 +1,322 @@
+---
+name: workflow-status
+description: Consulta status detalhado do workflow atual incluindo fase, artefatos, gates e proximos passos. Use para verificar progresso ou diagnosticar problemas.
+allowed-tools: Read, Grep, Glob
+---
+
+# Workflow Status Skill
+
+## Descricao
+
+Esta skill fornece informacoes detalhadas sobre o status atual do workflow de orquestracao, incluindo fase atual, artefatos gerados, gates avaliados e proximos passos.
+
+## Quando Usar
+
+Use esta skill quando:
+- Precisar saber o status atual do workflow
+- Verificar quais artefatos foram gerados
+- Consultar progresso por fase
+- Identificar proximos passos
+- Verificar checkpoints disponiveis
+- Diagnosticar problemas no fluxo
+
+## Invocacao
+
+Exemplos de como invocar esta skill:
+
+```
+"Qual o status atual do workflow?"
+
+"Mostre o progresso da implementacao"
+
+"Quais artefatos ja foram gerados?"
+
+"Em qual fase estamos?"
+
+"Quais sao os proximos passos?"
+
+"Liste os checkpoints disponiveis"
+```
+
+## Parametros
+
+| Parametro | Tipo | Obrigatorio | Descricao |
+|-----------|------|-------------|-----------|
+| `workflowId` | string | Nao | ID do workflow (usa atual se omitido) |
+| `detail_level` | enum | Nao | summary, standard, detailed |
+| `include_artifacts` | boolean | Nao | Incluir lista de artefatos |
+| `include_checkpoints` | boolean | Nao | Incluir lista de checkpoints |
+| `include_gates` | boolean | Nao | Incluir status dos gates |
+
+### Valores de detail_level
+
+- **summary**: Apenas fase atual e status geral
+- **standard** (default): Fase, status, ultimos artefatos, proximo passo
+- **detailed**: Tudo incluindo historico completo
+
+## Output
+
+A skill retorna informacoes estruturadas:
+
+```json
+{
+  "success": true,
+  "workflow": {
+    "id": "wf-123",
+    "type": "feature_development",
+    "feature": "OAuth2 Authentication",
+    "status": "in_progress",
+    "startedAt": "2025-12-09T10:00:00Z",
+    "updatedAt": "2025-12-09T14:30:00Z"
+  },
+
+  "currentPhase": {
+    "name": "implement",
+    "status": "in_progress",
+    "startedAt": "2025-12-09T14:00:00Z",
+    "progress": {
+      "totalTasks": 10,
+      "completedTasks": 6,
+      "percentage": 60
+    }
+  },
+
+  "phases": [
+    {
+      "name": "research",
+      "status": "completed",
+      "duration": "45m",
+      "artifacts": ["research-context.md"]
+    },
+    {
+      "name": "specify",
+      "status": "completed",
+      "duration": "1h",
+      "artifacts": ["spec.md"]
+    },
+    {
+      "name": "plan",
+      "status": "completed",
+      "duration": "1h 30m",
+      "artifacts": ["plan.md"]
+    },
+    {
+      "name": "tasks",
+      "status": "completed",
+      "duration": "45m",
+      "artifacts": ["tasks.md"]
+    },
+    {
+      "name": "implement",
+      "status": "in_progress",
+      "duration": "2h (ongoing)",
+      "artifacts": ["impl-001.md", "impl-002.md"]
+    }
+  ],
+
+  "artifacts": [
+    {
+      "id": "art-001",
+      "type": "research",
+      "path": ".orchestrator/artifacts/research/research-context.md",
+      "status": "validated",
+      "createdAt": "2025-12-09T10:45:00Z"
+    },
+    {
+      "id": "art-002",
+      "type": "specification",
+      "path": ".orchestrator/artifacts/specify/spec.md",
+      "status": "validated",
+      "createdAt": "2025-12-09T11:45:00Z"
+    }
+  ],
+
+  "gates": {
+    "research": { "passed": true, "evaluatedAt": "2025-12-09T10:50:00Z" },
+    "specify": { "passed": true, "evaluatedAt": "2025-12-09T11:50:00Z" },
+    "plan": { "passed": true, "evaluatedAt": "2025-12-09T13:20:00Z" },
+    "tasks": { "passed": true, "evaluatedAt": "2025-12-09T14:00:00Z" },
+    "implement": { "passed": false, "pending": true }
+  },
+
+  "checkpoints": [
+    {
+      "id": "chk-001",
+      "phase": "specify",
+      "message": "[orchestrator] specify: specification validated",
+      "gitRef": "abc123",
+      "createdAt": "2025-12-09T11:50:00Z"
+    },
+    {
+      "id": "chk-002",
+      "phase": "plan",
+      "message": "[orchestrator] plan: technical plan approved",
+      "gitRef": "def456",
+      "createdAt": "2025-12-09T13:20:00Z"
+    }
+  ],
+
+  "nextSteps": [
+    "Completar TASK-007: Implementar middleware de autenticacao",
+    "Executar testes de integracao",
+    "Avaliar gate de implement para concluir workflow"
+  ],
+
+  "metrics": {
+    "totalDuration": "4h 30m",
+    "estimatedRemaining": "2h",
+    "artifactsGenerated": 6,
+    "gatesPassed": 4,
+    "checkpointsCreated": 4
+  }
+}
+```
+
+## Formato de Output para Usuario
+
+Quando invocada, a skill formata output amigavel:
+
+```markdown
+## Status do Workflow
+
+**ID**: wf-123
+**Tipo**: feature_development
+**Feature**: OAuth2 Authentication
+**Status**: 🟡 Em Progresso
+
+### Fase Atual: IMPLEMENT
+
+```
+[████████░░░░░░░░░░░░] 60% (6/10 tasks)
+```
+
+### Progresso por Fase
+
+| Fase | Status | Duracao | Artefatos |
+|------|--------|---------|-----------|
+| research | ✅ Completo | 45m | 1 |
+| specify | ✅ Completo | 1h | 1 |
+| plan | ✅ Completo | 1h 30m | 1 |
+| tasks | ✅ Completo | 45m | 1 |
+| implement | 🟡 Em Progresso | 2h | 2 |
+
+### Gates
+
+- [x] research-complete
+- [x] specification-complete
+- [x] plan-complete
+- [x] tasks-complete
+- [ ] implementation-complete (pendente)
+
+### Proximos Passos
+
+1. Completar TASK-007: Implementar middleware de autenticacao
+2. Executar testes de integracao
+3. Avaliar gate de implement para concluir workflow
+
+### Metricas
+
+- **Tempo Total**: 4h 30m
+- **Estimativa Restante**: 2h
+- **Artefatos**: 6
+- **Checkpoints**: 4
+```
+
+## Integracao com TypeScript
+
+Esta skill invoca o handler TypeScript:
+
+```typescript
+// src/presentation/skills/WorkflowStatusSkill.ts
+
+export class WorkflowStatusSkillHandler extends SkillHandler {
+  name = 'workflow-status';
+  description = 'Consulta status detalhado do workflow';
+
+  async execute(input: WorkflowStatusInput): Promise<SkillResult> {
+    // 1. Obtem workflow atual ou por ID
+    // 2. Carrega orchestrator-index.json
+    // 3. Coleta informacoes de fases
+    // 4. Coleta status de gates
+    // 5. Lista artefatos e checkpoints
+    // 6. Calcula metricas
+    // 7. Formata output
+  }
+}
+```
+
+## Casos de Uso
+
+### Verificar Status Rapido
+```
+User: "Status do workflow?"
+Skill: workflow-status com detail_level=summary
+Output: Fase atual, status, progresso percentual
+```
+
+### Relatorio Detalhado
+```
+User: "Me de um relatorio completo do progresso"
+Skill: workflow-status com detail_level=detailed, todos includes=true
+Output: Relatorio completo com historico
+```
+
+### Verificar Artefatos
+```
+User: "Quais artefatos ja temos?"
+Skill: workflow-status com include_artifacts=true
+Output: Lista de artefatos com status e paths
+```
+
+### Diagnostico de Problema
+```
+User: "Por que o workflow esta travado?"
+Skill: workflow-status com include_gates=true
+Output: Status detalhado mostrando gate pendente
+```
+
+## Comportamento em Casos Especiais
+
+### Nenhum Workflow Ativo
+```json
+{
+  "success": false,
+  "error": {
+    "code": "NO_ACTIVE_WORKFLOW",
+    "message": "Nenhum workflow ativo encontrado",
+    "suggestion": "Use 'orchestrate start' para iniciar um novo workflow"
+  }
+}
+```
+
+### Workflow Nao Encontrado
+```json
+{
+  "success": false,
+  "error": {
+    "code": "WORKFLOW_NOT_FOUND",
+    "message": "Workflow 'wf-xyz' nao encontrado",
+    "suggestion": "Verifique o ID ou use sem parametro para workflow atual"
+  }
+}
+```
+
+### Index Corrompido
+```json
+{
+  "success": false,
+  "error": {
+    "code": "INDEX_CORRUPTED",
+    "message": "orchestrator-index.json esta corrompido ou invalido",
+    "suggestion": "Execute 'orchestrator config validate' para diagnosticar"
+  }
+}
+```
+
+## Notas Importantes
+
+1. Esta skill e **read-only** - apenas consulta, nao modifica estado
+2. Dados vem de `orchestrator-index.json` e artefatos
+3. Metricas de tempo sao calculadas a partir de timestamps
+4. Progresso de tarefas requer leitura de tasks.md
+5. Cache de 30 segundos para evitar leituras repetidas

package/workflows/bug-fix.json

@@ -0,0 +1,74 @@
+{
+  "name": "bug-fix",
+  "type": "bug_fix",
+  "displayName": "Bug Fix",
+  "description": "Workflow for fixing bugs and issues",
+  "version": "1.0.0",
+  "triggers": [
+    "bug",
+    "fix",
+    "issue",
+    "error",
+    "broken",
+    "crash",
+    "problem"
+  ],
+  "phases": [
+    {
+      "name": "ANALYZE",
+      "displayName": "Analysis",
+      "agent": "researcher",
+      "artifact": "bug-analysis.md",
+      "gates": []
+    },
+    {
+      "name": "REPRODUCE",
+      "displayName": "Reproduction",
+      "agent": "implementer",
+      "artifact": "reproduction-steps.md",
+      "gates": [
+        {
+          "type": "artifact",
+          "config": {
+            "required": true
+          }
+        }
+      ]
+    },
+    {
+      "name": "FIX",
+      "displayName": "Fix Implementation",
+      "agent": "implementer",
+      "artifact": "fix-report.md",
+      "requiresApproval": true,
+      "gates": [
+        {
+          "type": "tests",
+          "config": {
+            "mustPass": true
+          }
+        }
+      ]
+    },
+    {
+      "name": "VERIFY",
+      "displayName": "Verification",
+      "agent": "reviewer",
+      "artifact": "verification-report.md",
+      "gates": [
+        {
+          "type": "tests",
+          "config": {
+            "mustPass": true
+          }
+        },
+        {
+          "type": "artifact",
+          "config": {
+            "required": true
+          }
+        }
+      ]
+    }
+  ]
+}

package/workflows/feature-development.json

@@ -0,0 +1,88 @@
+{
+  "name": "feature-development",
+  "type": "feature_development",
+  "displayName": "Feature Development",
+  "description": "Standard workflow for implementing new features",
+  "version": "1.0.0",
+  "triggers": [
+    "feature",
+    "new feature",
+    "implement",
+    "create",
+    "add",
+    "build"
+  ],
+  "phases": [
+    {
+      "name": "RESEARCH",
+      "displayName": "Research",
+      "agent": "researcher",
+      "artifact": "research-context.md",
+      "optional": true,
+      "gates": []
+    },
+    {
+      "name": "SPECIFY",
+      "displayName": "Specification",
+      "agent": "specifier",
+      "artifact": "spec.md",
+      "gates": [
+        {
+          "type": "artifact",
+          "config": {
+            "required": true
+          }
+        }
+      ]
+    },
+    {
+      "name": "PLAN",
+      "displayName": "Technical Plan",
+      "agent": "planner",
+      "artifact": "plan.md",
+      "gates": [
+        {
+          "type": "artifact",
+          "config": {
+            "required": true
+          }
+        }
+      ]
+    },
+    {
+      "name": "TASKS",
+      "displayName": "Task Generation",
+      "agent": "task-generator",
+      "artifact": "tasks.md",
+      "gates": [
+        {
+          "type": "artifact",
+          "config": {
+            "required": true
+          }
+        }
+      ]
+    },
+    {
+      "name": "IMPLEMENT",
+      "displayName": "Implementation",
+      "agent": "implementer",
+      "artifact": "implementation-report.md",
+      "requiresApproval": true,
+      "gates": [
+        {
+          "type": "tests",
+          "config": {
+            "mustPass": true
+          }
+        },
+        {
+          "type": "coverage",
+          "config": {
+            "minimum": 80
+          }
+        }
+      ]
+    }
+  ]
+}