haos-handoff-artefato

Files (1)

• SKILL.md

SKILL.md (first lines)

# HAOS - Handoff por Artefato

## O caso que originou esta skill (leia, e o argumento inteiro)

O diretor-criativo produziu uma spec visual pixel a pixel de uma peca de campanha:
hex, tipografia, peso, espacamento, hierarquia. O main leu a spec, resumiu e
briefou o dev com **"preto e dourado"**. O dev inventou o resto.

A squad produziu. O especialista foi chamado. O main delegou certo. E o
resultado ficou **indistinguivel de nao ter chamado especialista nenhum**.

A falha nao foi de delegacao, foi de **transporte**: o main e um compressor com
perda entre a saida de A e a entrada de B. Um agente nao le o transcript do
outro; ele le o que o main digitou no prompt dele. Se o main digitou um resumo,
o resumo E a spec, e tudo que ficou de fora vira invencao do executor.

**Solucao: tirar o main do caminho do conteudo.** A spec vai pro disco. O
executor recebe o CAMINHO e a ordem de ler o arquivo inteiro. O main transporta
um ponteiro, nao um resumo. Ponteiro nao comprime.

---

## a. Quando usar (gatilho objetivo)

**OBRIGATORIA quando:**

1. **A saida de um agente entra no trabalho de outro.** Qualquer encadeamento:
   diretor-criativo -> dev-frontend, copy-specialist -> designer,
   estrategista-chefe -> media-buyer, pesquisador -> copy-specialist,
   funnel-architect -> automation-engineer.
2. **O dono vai olhar o resultado com o olho.** Design, landing page, criativo,
   copy publicada, PDF, apresentacao. Ai a fidelidade visual/textual e o
   produto; "mais ou menos" e defeito.

**FORA do gatilho (nao use, so atrapalha):**

- Diagnostico, leitura, consulta, auditoria ("por que o container caiu?").
- Infra e comando de servidor.
- Tarefa de agente unico, sem encadeamento e sem entrega visual.

Na duvida: **o proximo agente vai precisar de um DETALHE que so existe na cabeca
do anterior?** Se sim, artefato em disco. Se nao, toca o barco.

**Gatilhos textuais reais** (frases do dono que quase sempre significam
encadeamento): "manda o dev montar isso", "pega o que o criativo fez e", "usa a
spec do", "aplica esse design na pagina", "transforma isso em LP".

---

## b. Pre-requisitos

- Pasta base do handoff (ja existe, e versionada e commitada pelo `finish_task`):
  `workspace/_handoff/` na raiz do repo da sessao. Exemplo absoluto na arvore
  canonica: `<SEU_CAMINHO>\workspace\_handoff\`. Fallback,
  ultimo candidato e so enquanto o legado existir:
  `<SEU_CAMINHO_LEGADO>\workspace\_handoff\`
- Os agentes envolvidos precisam de `Read` e `Write` (sub-agente ja tem: o
  `main_guard` libera sub-agente por padrao).
- Skill relacionada, NAO substituida por esta: `verification-before-completion`
  ("Iron Law: no completion claims without fresh verification evidence"). Esta
  skill diz **onde** a evidencia mora no encadeamento de agentes; a outra diz
  que sem evidencia fresca nao existe "concluido". As duas valem juntas.

---

## c. Passo a passo

### Convencao de pasta

```
workspace/_handoff/<AAAAMMDD>-<slug-da-tarefa>/
    01-diretor-criativo-spec-visual.md
    02-copy-specialist-copy-lp.md
    03-dev-frontend-conformidade.md
```

Regras do nome:
- `<AAAAMMDD>` = data de abertura da tarefa (ex.: `20260805`).
- `<slug-da-tarefa>` = minusculo, sem acento, com hifen (ex.: `landing-page-nova`).
- `NN-` = ordem na cadeia, com dois digitos. **A numeracao e o que deixa a cadeia
  legivel por um `ls` simples**: da pra ver quem produziu, em que ordem, e se o
  arquivo de conformidade do executor existe, sem abrir nada.
- Depois do `NN-`, o nome do agente que produziu, depois o tipo do conteudo.

### Por que aqui e nao no scratchpad

O scratchpad (`AppData\Local\Temp\claude\...\scratchpad`) e **temporario,
escopado por sessao e invisivel pro dono**. Serve pra rascunho e arquivo
intermediario descartavel.

O artefato de handoff e o oposto disso: e **EVIDENCIA**. Precisa
(1) sobreviver a sessao, porque a auditoria do "por que a pagina saiu diferente
da spec" acontece dias depois; (2) ser commitado pelo `finish_task.ps1`, que
versiona o repo da sessao; (3) ser abrivel pelo dono direto no storage
compartilhado do time, sem pedir nada pra ninguem. Rascunho no scratchpad, evidencia no `workspace/`.

### Bloco do PRODUTOR (colar no prompt do agente A)

```
SAIDA EM DISCO (OBRIGATORIA):
Grave a spec COMPLETA em:
...\workspace\_handoff\<data>-<slug>\01-<seu-agente>-<tipo>.md
Escreva para outro agente EXECUTAR sem te perguntar nada: valores concretos
(hex, px, fonte, peso, ordem das secoes), nao adjetivos. "Preto e dourado
elegante" nao e spec. Sua resposta pra mim pode ser resumo; o ARQUIVO nao pode.
```

### Bloco do CONSUMIDOR (colar no prompt do agente B)

```
ARTEFATO DE ENTRADA (LER INTEIRO ANTES DE QUALQUER ACAO):
<caminho absoluto do arquivo>

Leia esse arquivo com Read, do inicio ao fim, antes de escrever uma linha.
Ele E a especificacao. Eu (main) NAO resumi o conteudo dele aqui de proposito:
o que vale e o arquivo, nao o que esta escrito neste briefing.
PROIBIDO inventar cor, tipografia, espacamento, secao, texto ou ordem que nao
esteja no arquivo. Faltou algo na spec? PARE e pergunte. Nao preencha lacuna
com bom senso.

From simtransforma/HAOS-CC-Model, MIT.

More from simtransforma/HAOS-CC-Model