Habilidade de Loops Autônomos

Nota de compatibilidade (v1.8.0): autonomous-loops é mantido por mais uma versão. O nome canônico da habilidade agora é continuous-agent-loop. Novas orientações de loop devem ser criadas lá, enquanto esta habilidade permanece disponível para evitar quebrar fluxos de trabalho existentes.

Padrões, arquiteturas e implementações de referência para executar o Claude Code autonomamente em loops. Abrange tudo, desde simples pipelines claude -p até orquestração DAG multiagente completa baseada em RFC.

Quando Usar

• Configurar fluxos de trabalho de desenvolvimento autônomos que rodam sem intervenção humana
• Escolher a arquitetura de loop correta para o seu problema (simples vs. complexo)
• Construir pipelines de desenvolvimento contínuo no estilo CI/CD
• Executar agentes paralelos com coordenação de mesclagem
• Implementar persistência de contexto entre iterações de loop
• Adicionar portões de qualidade e passes de limpeza a fluxos de trabalho autônomos

Espectro de Padrões de Loop

Do mais simples ao mais sofisticado:

1. Pipeline Sequencial (claude -p)

O loop mais simples. Divida o desenvolvimento diário em uma sequência de chamadas claude -p não interativas. Cada chamada é um passo focado com um prompt claro.

Ideia Central

Se você não consegue criar um loop como este, significa que você nem consegue fazer o LLM corrigir seu código em modo interativo.

O flag claude -p executa o Claude Code de forma não interativa com um prompt, e sai quando termina. Encadeie chamadas para construir um pipeline:

#!/bin/bash
# daily-dev.sh — Sequential pipeline for a feature branch

set -e

# Step 1: Implement the feature
claude -p "Read the spec in docs/auth-spec.md. Implement OAuth2 login in src/auth/. Write tests first (TDD). Do NOT create any new documentation files."

# Step 2: De-sloppify (cleanup pass)
claude -p "Review all files changed by the previous commit. Remove any unnecessary type tests, overly defensive checks, or testing of language features (e.g., testing that TypeScript generics work). Keep real business logic tests. Run the test suite after cleanup."

# Step 3: Verify
claude -p "Run the full build, lint, type check, and test suite. Fix any failures. Do not add new features."

# Step 4: Commit
claude -p "Create a conventional commit for all staged changes. Use 'feat: add OAuth2 login flow' as the message."

Princípios Chave de Design

1. Cada passo é isolado — Uma nova janela de contexto por chamada claude -p significa que não há vazamento de contexto entre os passos.
2. A ordem importa — Os passos executam sequencialmente. Cada um se baseia no estado do sistema de arquivos deixado pelo anterior.
3. Instruções negativas são perigosas — Não diga "não teste sistemas de tipos". Em vez disso, adicione um passo de limpeza separado (veja Padrão De-Sloppify).
4. Códigos de saída se propagam — set -e para o pipeline em caso de falha.

Variações

Com roteamento de modelo:

# Research with Opus (deep reasoning)
claude -p --model opus "Analyze the codebase architecture and write a plan for adding caching..."

# Implement with Sonnet (fast, capable)
claude -p "Implement the caching layer according to the plan in docs/caching-plan.md..."

# Review with Opus (thorough)
claude -p --model opus "Review all changes for security issues, race conditions, and edge cases..."

Com contexto de ambiente:

# Pass context via files, not prompt length
echo "Focus areas: auth module, API rate limiting" > .claude-context.md
claude -p "Read .claude-context.md for priorities. Work through them in order."
rm .claude-context.md

Com restrições de --allowedTools:

# Passo de análise somente leitura
claude -p --allowedTools "Read,Grep,Glob" "Audite esta base de código em busca de vulnerabilidades de segurança..."

# Passo de implementação somente escrita
claude -p --allowedTools "Read,Write,Edit,Bash" "Implemente as correções de security-audit.md..."

…