colony-dogfood

name	colony-dogfood
description	Conduz um experimento de dogfood onde a colônia Pi executa uma task do .project/tasks.json em dois tempos (research → código) com gates do operador. Use quando o operador quiser ativar um experimento colony-experiment-phase1 ou colony-experiment-phase2.

Colony Dogfood

Este skill guia a execução de um experimento de auto-uso onde o agents-lab usa sua própria colônia para evoluir. Siga os passos na ordem — nunca pule um gate do operador.

Pré-condições

Antes de iniciar qualquer experimento:

pnpm run pi:runtime:health

Esperado: decision=continue. Se retornar decision=stop, investigue o watchdog antes de continuar.

Fase 1: Research

1. Selecionar a task

Escolha uma task com milestone: "colony-experiment-phase1" e status: "in_progress". Leia a description e os acceptance_criteria.

2. Abrir execution envelope

No Pi, use ant_colony com:

• goal: reproduzir a description da task + "Produzir síntese em .project/reports/TASK-ID-research.md seguindo o template _template-research.md"
• maxCost: 2.0 (USD) — suficiente para leitura de repo externo + síntese
• Worker model: modelo econômico (ex: flash/mini) — research não requer o modelo mais caro
• Sem permissão de escrita de código ou push
• Não criar nem editar .project/reports/TASK-ID-decision.md; esse arquivo é exclusivo do operador

3. Output esperado do worker

O worker deve criar .project/reports/TASK-ID-research.md preenchendo todos os campos do template. Se o budget for atingido antes da síntese estar completa, o worker deve marcar status: parcial e salvar o que conseguiu. Se o worker criar ou editar o arquivo de decisão, trate o gate como inválido até nova revisão explícita do operador.

4. Gate do operador (obrigatório)

Leia .project/reports/TASK-ID-research.md. Preencha .project/reports/TASK-ID-decision.md a partir do template. Marque approved: true ou approved: false.

Só avance para Fase 2 se approved: true E Fase 2 autorizada?: sim, ambos preenchidos pelo operador.

Fase 2: Código

1. Proposta de impl-plan

Com o gate aprovado, abra um segundo envelope colony:

• goal: "Ler .project/reports/TASK-ID-research.md e .project/reports/TASK-ID-decision.md. Propor plano de implementação em .project/reports/TASK-ID-impl-plan.md seguindo o template. NÃO implementar — apenas propor."
• maxCost: 1.0 (USD) — apenas leitura e escrita de documento

2. Gate do operador (obrigatório)

Leia .project/reports/TASK-ID-impl-plan.md. Aprove o plano ou peça revisão antes de avançar.

3. Implementação

Com o plano aprovado:

• goal: "Implementar o plano em .project/reports/TASK-ID-impl-plan.md. Produzir branch + commit + entrada de changeset. NÃO fazer push — apenas commit local."
• maxCost: 5.0 (USD)

4. Gate de verificação

Execute o smoke da task antes de revisar o diff:

pnpm run ci:local:parity

5. Gate do operador — revisão final

Revise o diff. Se aprovado, faça o merge. Atualize tasks.json: status: "completed".

Promoção de Evidência

Após completar ≥1 experimento, promova o melhor artefato:

cp .project/reports/TASK-ID-research.md docs/research/TASK-ID-synthesis.md

Adicione frontmatter:

---
title: Síntese: [nome da task]
date: YYYY-MM-DD
evidence_type: colony-dogfood-experiment
task: TASK-ID
---

Budget de Referência

Fase	maxCost sugerido	Finalidade
Research	$2.00	Leitura externa + síntese
Impl-plan	$1.00	Proposta de documento
Implementação	$5.00	Código + commit