Al0olo/Agents-village

Handoff

O objetivo: o próximo agente, sem memória desta conversa, continua sem perguntar a ninguém e sem redescobrir nada.

No início

1. Leia docs/HANDOFF.md na íntegra, depois as 3 primeiras entradas de docs/handoff/LOG.md.
2. Verifique contra a realidade: git status, git log --oneline -10, git branch -a e PRs abertos (gh api repos/al0olo/agents-village/pulls --jq '.[].title').
3. Se o handoff e a realidade discordarem, acredite na realidade, corrija o handoff antes de iniciar novo trabalho e registre isso no log.
4. Reapresente o próximo passo ao usuário em uma ou duas frases e, em seguida, execute-o.

Enquanto trabalha

Atualize docs/HANDOFF.md imediatamente quando qualquer um destes ocorrer: uma unidade de trabalho for concluída, uma decisão for tomada, uma abordagem falhar, você encontrar uma peculiaridade do ambiente, abrir ou mesclar um PR.

No final (ou quando interrompido)

1. Reescreva docs/HANDOFF.md usando o modelo abaixo. É estado atual, não histórico: substitua linhas desatualizadas, não acumule.
2. Adicione uma entrada datada no início de docs/handoff/LOG.md (a mais recente primeiro): o que você fez, por quê, o que falhou, links. O histórico fica lá.
3. Execute scripts/check-handoff.sh e faça commit do handoff junto com o trabalho.
4. Mensagem final para o usuário: o que foi feito, o que vem a seguir, qualquer coisa que precise de decisão.

Modelo para docs/HANDOFF.md

# Handoff
Atualizado: AAAA-MM-DD por <agente/modelo> · Ramo: <nome> · Último commit: <sha>

## Objetivo
Um parágrafo: o que o projeto está tentando alcançar agora.

## Estado
- Concluído: item (PR #n)
- Em andamento: item, exatamente onde parou, arquivos não commitados, se houver
- Não iniciado: item

## Próximo passo
A única próxima ação, concreta o suficiente para começar imediatamente, com comandos.

## Fila
Lista ordenada após o próximo passo.

## Decisões em aberto (o proprietário precisa decidir)
Pergunta, opções, minha recomendação.

## Peculiaridades
Peculiaridades do ambiente, abordagens que falharam e por quê, coisas que parecem erradas mas são intencionais.

## Como verificar
Comandos que provam que o estado atual está saudável.

## Referências
Arquivos e documentos para aprofundamento.

Padrão de qualidade

• Nomeie arquivos, ramos, números de PR, comandos. Sem "como acima", sem "a coisa que discutimos".
• Registre abordagens que falharam e por quê, para que ninguém as repita.
• Separe o que você verificou do que você assume, e diga qual é qual.
• Mantenha docs/HANDOFF.md com cerca de 150 linhas; mova o histórico para o log.