Skip to content

Commit 7d1b1ed

Browse files
committed
docs(claude): add per-task autonomous cycle to standing permissions
Spell out the end-to-end cycle the agent runs without per-step confirmation for each plan.md task: create branch -> write code+tests -> clean build/rebuild as needed -> run all tests -> if green, commit/push/open PR -> watch check-runs until done -> redo any step until the PR is green. Only merge (and the listed destructive ops) still require explicit confirmation.
1 parent ee2a702 commit 7d1b1ed

1 file changed

Lines changed: 15 additions & 1 deletion

File tree

CLAUDE.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ O handoff esperado do Claude Design são quatro entregáveis (`tokens.css`, `com
9393

9494
## Permissões permanentes do agente (concedidas pelo mantenedor)
9595

96-
O agente tem permissão **permanente** para executar, sem pedir confirmação a cada vez, o ciclo completo de trabalho de um PR:
96+
O agente tem permissão **permanente** (tem permissão pra tudo no ciclo abaixo, sem pedir confirmação a cada vez):
9797

9898
- **Leitura irrestrita.** Qualquer comando de leitura/inspeção em qualquer parte do sistema: ler/listar/buscar arquivos, `git` de leitura (`status`, `log`, `diff`, `show`, `branch`, `ls-files`, …), inspecionar build/testes, etc.
9999
- **Inspecionar arquivos, rodar quaisquer testes e analisar os resultados.**
@@ -103,6 +103,20 @@ O agente tem permissão **permanente** para executar, sem pedir confirmação a
103103
- **Commit, push e abrir PR** (`git commit`, `git push`, `gh pr create`).
104104
- **Esperar o CI, corrigir o que for necessário, commitar e fazer push de novo** — iterar até o PR ficar verde.
105105

106+
### Ciclo de cada task (executar autonomamente, sem pedir confirmação)
107+
108+
Para cada item do `plan.md` (ou tarefa equivalente), seguir este ciclo de ponta a ponta:
109+
110+
1. **Criar a branch** a partir do `master` atualizado (`git branch --show-current` p/ confirmar que não está no master antes de codar/commitar).
111+
2. **Escrever todo o código necessário** (e os testes).
112+
3. **Clean build / rebuild quando necessário** — na dúvida sobre cache, apagar `obj/bin` ou usar `--no-incremental`.
113+
4. **Criar e executar todos os testes**; ler a linha real `Passed!/Failed!` e `Build succeeded/FAILED`.
114+
5. **Se tudo estiver verde** (0 falhas, build ok): **commit, push e abrir o PR**.
115+
6. **Após abrir o PR, acompanhar os check-runs até concluírem** (`check runs until done`) — confirmando que o `headRefOid` do PR == último commit.
116+
7. **Se precisar refazer algum passo** (CI vermelho, conflito, etc.): corrigir, commitar e push de novo, e repetir 3–6 até o PR ficar verde. Tudo isso é permitido sem nova confirmação.
117+
118+
**parar e pedir confirmação** no final (merge) e nas exceções abaixo.
119+
106120
Ainda exigem confirmação explícita: **merge de PR**, deletar branch remota de terceiros, force-push, e ações destrutivas/irreversíveis (`reset --hard` em remoto, mudar visibilidade do repo, dropar schema, etc.).
107121

108122
## Lições operacionais (erros já cometidos — não repetir)

0 commit comments

Comments
 (0)