aiox-core 5.0.2 → 5.0.4

package/pro/squads/squad-creator-pro/tasks/migrate-workflows-to-yaml.md

@@ -0,0 +1,259 @@
+# Migrate Workflows to YAML
+
+**Task ID:** `migrate-workflows-to-yaml`
+**Pattern:** HO-TP-001 (Task Anatomy Standard)
+**Version:** 1.0.0
+**Last Updated:** 2026-02-05
+
+## Task Anatomy
+
+| Field | Value |
+|-------|-------|
+| **task_name** | Migrate Workflows to YAML |
+| **status** | `completed` |
+| **responsible_executor** | @squad-chief |
+| **execution_type** | `Agent` |
+| **input** | Workflow .md files in workflows/ folder |
+| **output** | Migrated .yaml files + archived .md files |
+| **action_items** | 4 steps |
+| **acceptance_criteria** | 3 criteria |
+
+**Estimated Time:** 30min
+
+## Overview
+
+Migrar workflows em formato `.md` (legacy/narrativo) para o formato `.yaml` padrão do AIOS.
+
+**Motivação:**
+- Consistência no ecossistema (todos workflows em .yaml)
+- Parsing automático por scripts de validação
+- Suporte a tooling (templates, linters, geradores)
+- Validação por schema
+
+**Arquivos a migrar:**
+1. `workflows/mind-research-loop.md` → `workflows/wf-mind-research-loop.yaml`
+2. `workflows/research-then-create-agent.md` → `workflows/wf-research-then-create-agent.yaml`
+
+## Input
+
+- **source_files** (array)
+  - Description: Lista de arquivos .md a migrar
+  - Required: Yes
+  - Source: `squads/squad-creator-pro/workflows/*.md`
+
+- **template** (file)
+  - Description: Template de workflow YAML
+  - Required: Yes
+  - Source: `squads/squad-creator-pro/templates/workflow-tmpl.yaml`
+
+## Output
+
+- **migrated_workflows** (files)
+  - Description: Workflows convertidos para YAML
+  - Destination: `squads/squad-creator-pro/workflows/wf-*.yaml`
+  - Format: YAML seguindo workflow-tmpl.yaml
+
+- **archived_files** (files)
+  - Description: Arquivos .md originais movidos para backup
+  - Destination: `squads/squad-creator-pro/workflows/_archive/`
+  - Format: Original .md
+
+## Action Items
+
+### Step 1: Analisar Estrutura dos Workflows .md
+
+Ler cada arquivo .md e extrair:
+- workflow-id
+- name/purpose
+- version
+- phases (seções principais)
+- inputs/outputs
+- checkpoints
+- frameworks usados
+- agents envolvidos
+
+**Substeps:**
+- [ ] Ler `mind-research-loop.md` e mapear estrutura
+- [ ] Ler `research-then-create-agent.md` e mapear estrutura
+- [ ] Identificar gaps em relação ao template YAML
+
+### Step 2: Converter para Formato YAML
+
+Usar `workflow-tmpl.yaml` como base e preencher com dados extraídos.
+
+**Substeps:**
+- [ ] Criar `wf-mind-research-loop.yaml` com estrutura completa
+- [ ] Criar `wf-research-then-create-agent.yaml` com estrutura completa
+- [ ] Validar sintaxe YAML de ambos os arquivos
+
+### Step 3: Validar Workflows Migrados
+
+Executar validação para garantir conformidade.
+
+**Substeps:**
+- [ ] Verificar campos obrigatórios (workflow-id, name, version, phases)
+- [ ] Verificar que cada phase tem checkpoint
+- [ ] Verificar referências a frameworks/agents estão corretas
+- [ ] Rodar `*validate-workflow` em cada arquivo
+
+### Step 4: Arquivar Originais e Limpar
+
+Mover arquivos .md para pasta de archive.
+
+**Substeps:**
+- [ ] Criar pasta `workflows/_archive/` se não existir
+- [ ] Mover `mind-research-loop.md` para `_archive/`
+- [ ] Mover `research-then-create-agent.md` para `_archive/`
+- [ ] Atualizar referências em outros arquivos (se houver)
+
+## Acceptance Criteria
+
+The task is complete when ALL of the following criteria are met:
+
+- [ ] **AC1:** Ambos workflows convertidos para .yaml com estrutura válida
+  - Measurement: `*validate-workflow` passa sem erros
+
+- [ ] **AC2:** Pasta workflows/ contém apenas arquivos .yaml (exceto _archive/)
+  - Measurement: `ls workflows/*.md` retorna vazio
+
+- [ ] **AC3:** Arquivos originais preservados em `workflows/_archive/`
+  - Measurement: Ambos .md existem em _archive/
+
+## Quality Gate
+
+```yaml
+quality_gate:
+  id: "QG_WF_MIGRATE_001"
+  name: "Workflow Migration Quality Gate"
+  placement: "exit"
+  type: "automated"
+  severity: "blocking"
+
+  criteria:
+    - check: "YAML syntax valid"
+      type: "automated"
+      field: "yaml_valid"
+      value: true
+      operator: "eq"
+      weight: 3
+
+    - check: "Required fields present"
+      type: "automated"
+      field: "required_fields"
+      value: ["workflow-id", "name", "version", "phases"]
+      operator: "contains_all"
+      weight: 3
+
+    - check: "Each phase has checkpoint"
+      type: "automated"
+      field: "phase_checkpoints"
+      value: true
+      operator: "eq"
+      weight: 2
+
+  thresholds:
+    pass: 8
+    review: 6
+    fail: 5
+
+  pass_action:
+    - "Archive original .md files"
+    - "Update squad-creator dependencies"
+
+  fail_action:
+    - "Report validation errors"
+    - "Keep original .md files"
+```
+
+## Handoff
+
+| Attribute | Value |
+|-----------|-------|
+| **Next Task** | `refresh-registry` |
+| **Trigger** | Migration complete |
+| **Executor** | @squad-chief |
+
+### Handoff Checklist
+
+Before handoff, verify:
+- [ ] Todos workflows migrados passam validação
+- [ ] Nenhuma referência quebrada a arquivos .md
+- [ ] _archive/ contém backups
+
+### Handoff Package
+
+The following artifacts are passed to the next task:
+- **migrated_workflows**: Lista de novos arquivos .yaml
+- **migration_report**: Resumo da migração
+
+## Error Handling
+
+### YAML Syntax Error
+
+- **Trigger:** Parser YAML falha
+- **Detection:** Erro de parse ao carregar arquivo
+- **Recovery:** Corrigir indentação/sintaxe e re-validar
+- **Prevention:** Usar template como base, validar incrementalmente
+
+### Missing Required Fields
+
+- **Trigger:** Campo obrigatório ausente no .md original
+- **Detection:** Validação falha no campo específico
+- **Recovery:** Extrair informação do contexto ou pedir input
+- **Prevention:** Mapear todos campos antes de converter
+
+### Broken References
+
+- **Trigger:** Outro arquivo referencia o .md antigo
+- **Detection:** Grep por nome do arquivo nos dependencies
+- **Recovery:** Atualizar referências para novo .yaml
+- **Prevention:** Buscar referências antes de arquivar
+
+## Examples
+
+### Exemplo de Conversão
+
+**Antes (mind-research-loop.md):**
+```markdown
+# Workflow: Mind Research Loop
+
+**Workflow ID:** mind-research-loop
+**Version:** 2.1.0
+**Purpose:** Research and validate...
+
+## Core Philosophy
+...
+
+## Phase 1: Initial Research
+...
+```
+
+**Depois (wf-mind-research-loop.yaml):**
+```yaml
+workflow-id: wf-mind-research-loop
+name: Mind Research Loop
+version: 2.1.0
+description: |
+  Research and validate the world's best minds...
+
+phases:
+  - id: initial-research
+    name: Initial Research
+    checkpoint:
+      criteria: [...]
+    ...
+```
+
+## Notes
+
+- Manter prefixo `wf-` para consistência com outros workflows
+- Preservar toda informação semântica do .md original
+- Estrutura de phases deve mapear para seções do .md
+- Specialist handoffs devem ser preservados na nova estrutura
+
+---
+
+_Task Version: 1.0.0_
+_Pattern: HO-TP-001 (Task Anatomy Standard)_
+_Last Updated: 2026-02-05_
+_Compliant: Yes_