tjboudreaux/ready-agent-1

Correção de Prontidão para Agentes

Eleve a prontidão de um repositório aplicando apenas alterações seguras. O mecanismo planeja e escreve scaffolds de configuração; você gerencia o git e escreve qualquer prosa. Três buckets, três níveis diferentes de segurança.

Passos

1. Garanta que um relatório exista. Se .agents/readiness/latest.json estiver ausente, execute a skill ra1-report primeiro.

2. Execute o dry-run do plano para ver o que mudaria:

   python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <caminho-do-repo>
   

   Ele imprime três buckets: Auto-aplicar (scaffolds de configuração seguros), Propor (rascunhos para revisão), Configurações do GitHub (manual).

3. Crie um branch local primeiro (nunca trabalhe no branch padrão):

   git -C <caminho-do-repo> checkout -b readiness/fixes
   

4. Aplique os scaffolds seguros (idempotente; recusa em worktree suja; nunca sobrescreve arquivos não vazios):

   python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <caminho-do-repo> --apply
   

5. Escreva você mesmo os itens "Propor" — seções de README, um AGENTS.md personalizado, runbooks, um primeiro teste. Escreva-os como rascunhos para o usuário revisar; não invente fatos sobre o codebase. templates/AGENTS.md é um esqueleto inicial — preencha-o com o que o repositório realmente faz.

6. Mostre o diff e faça commit localmente. Resuma as alterações, depois:

   git -C <caminho-do-repo> add -A && git -C <caminho-do-repo> commit -m "chore: raise agent readiness"
   

   Termine a mensagem de commit com o trailer Co-Authored-By obrigatório.

7. Execute novamente o ra1-report para mostrar o delta de nível.

Contrato (não viole)

• Nunca faça push e nunca abra um PR sem confirmação explícita do usuário. Construa e faça commit localmente primeiro.
• Auto-aplique apenas scaffolds de configuração. README/AGENTS.md/testes/runbooks são rascunhos propostos que o usuário revisa — escrever prosa automaticamente corre o risco de "documentar ficção".
• Nunca agrupe alterações de configuração do GitHub (proteção de branch, verificação de segredos, labels) com commits de código. Apresente-as como uma lista de verificação de comandos gh para o usuário executar e confirmar.
• Respeite uma worktree suja: não use --force sobre trabalho não comitado sem perguntar.