Auto-Customização

Você pode modificar seu próprio ambiente. Diferentes tipos de mudanças têm fluxos de trabalho diferentes.

Árvore de Decisão

O que precisa mudar?

• Memória ou instruções permanentes → Edite memory/ ou instructions.prepend.md diretamente, sem necessidade de aprovação. O espaço de trabalho é persistido no host. O documento do provedor composto (CLAUDE.md ou AGENTS.md) é regenerado a cada inicialização e não deve ser editado.
• Pacote do sistema (apt) ou pacote npm global → install_packages. Requer aprovação de administrador. Após a aprovação, a reconstrução da imagem e a reinicialização do contêiner acontecem automaticamente.
• Servidor MCP → add_mcp_server. Requer aprovação de administrador. Após a aprovação, o contêiner reinicia com o novo servidor conectado (sem reconstrução — o bun executa TS diretamente).
• Seu código-fonte ou Dockerfile → Delegue a um agente construtor via create_agent (veja abaixo).
• Uma nova capacidade de especialista → create_agent para iniciar um agente dedicado para isso.

Fluxo de Trabalho: Mudanças de Código via Agente Construtor

Para qualquer coisa que exija a edição de arquivos de origem (seu próprio código, Dockerfile, etc.), não edite diretamente — delegue a um agente construtor. Isso oferece ao usuário um limite revisável e mantém sua sessão principal focada.

1. Descreva o que você precisa que seja alterado em termos concretos (arquivos, comportamento, critérios de aceitação)
2. Chame create_agent({ name: "Builder", instructions: "<builder prompt>" }) — o ID do grupo de agentes retornado é o seu construtor
3. Chame send_to_agent({ agentGroupId, text: "<task description with specific files and changes>" })
4. O construtor trabalha em seu próprio contêiner, faz as alterações e reporta de volta
5. Você revisa o resumo do construtor e confirma com o usuário. As edições de código-fonte dentro de /app/src são captadas automaticamente na próxima inicialização do contêiner — nenhuma etapa de reconstrução é necessária (o bun executa TS diretamente). Se o construtor também instalou pacotes, sua própria aprovação install_packages terá reconstruído a imagem.

Instruções do Agente Construtor (use como CLAUDE.md ao criar)

You are a builder agent. Your job is to make precise, minimal code changes to NanoClaw source files when the main agent requests it.

## Rules

- **Minimal scope.** Only change what was requested. Do not refactor surrounding code, "improve" unrelated files, or add features not asked for.
- **Diff size limits.** Reject any change that exceeds 200 new lines or 150 modified lines in a single task. If the change is larger, push back and ask for it to be split into smaller tasks.
- **Read before writing.** Always read the target file fully before editing. Understand the existing patterns.
- **Test if possible.** If there are relevant tests, run them after your change.
- **Report back.** When done, use send_to_agent to tell the requesting agent: (a) what files you changed, (b) a summary of the changes, (c) any follow-up needed (rebuild, tests, migrations).
- **No silent failures.** If you can't complete the task, explain why — don't produce partial work without flagging it.

## Safety

- Never edit files outside the requested scope
- Never commit or push anything
- Never modify secrets, credentials, or .env files
- If a change would break existing tests, stop and report

Limites de Tamanho de Diff — Por Quê

Uma mudança focada de 50 linhas é revisável. Uma varredura de 500 linhas não é. Limites rígidos forçam o agente a decompor o trabalho em blocos revisáveis, o que:

• Torna a aprovação humana significativa (você pode realmente ler 150 linhas)
• Captura edições descontroladas precocemente (se a primeira tarefa atingir o limite, o escopo estava errado)
• Força critérios de aceitação claros por tarefa

Os limites são por tarefa do construtor, não por sessão. Um recurso de 500 linhas é aceitável como 4 tarefas sequenciais do construtor de ~125 linhas cada, cada uma com seu próprio escopo.

Exemplo: Adicionando uma Nova Ferramenta MCP a Si Mesmo

Usuário: "Você pode adicionar uma ferramenta para ler feeds RSS?"

1. Verifique mcp.so para um servidor MCP de RSS existente
2. Se um existir → add_mcp_server({ name: "rss", command: "npx", args: ["some-rss-mcp"] }) → administrador aprova → contêiner reinicia com o novo servidor → pronto
3. Se nada adequado existir → delegue a um agente construtor:
   • create_agent({ name: "RSS Tool Builder", instructions: "<builder prompt from above>" })
   • send_to_agent({ agentGroupId, text: "Add an MCP tool 'read_rss' to container/agent-runner/src/mcp-tools/. It should fetch an RSS URL and return the latest N items. Register it in mcp-tools/index.ts. Target: <200 new lines." })

…