Arquitetura multi-agente para impressao 3D com Anycubic Kobra S1 + Claude Code, seguindo best practices oficiais da Anthropic
~/3d/ no M1color), adicionados maxTurns, modelos otimizados (haiku para API, sonnet para logica)
kobra-print-worker monolitico → model-worker + slice-worker + printer-worker
kobra-s1-orchestrator, kobra-setup-worker, kobra-print-worker, kobra-api-worker, resin-print-worker, resin-api-worker (backup em .claude/agents.bak-*)
Pasta: ~/3d/.claude/agents/
Lead orchestrator. Roteia tarefas para workers especializados. Nunca executa acoes diretamente.
Gera codigo OpenSCAD a partir de descricoes em linguagem natural. Renderiza preview PNG e exporta STL.
Fatia STL via OrcaSlicer CLI headless no M4. Gera G-code otimizado com perfis PLA/PETG/TPU.
Controla a Kobra S1 via Moonraker REST API. Status, upload, start/pause/cancel, temperatura.
Valida impressoes para seguranca infantil (ASTM F963). Verifica engasgo, bordas, paredes, material.
Pasta: ~/Documentos/Apps/tools/kobra-s1-setup/.claude/agents/
Mesmo papel do M1, mas com acesso direto aos scripts de setup, perfis OrcaSlicer, e API Moonraker.
Instalacao Rinkhals, configuracao de rede, OrcaSlicer, calibracao completa (6 fases).
Geracao OpenSCAD com templates especificos (pecas funcionais, brinquedos, mods da impressora).
OrcaSlicer CLI com perfis locais. Acesso direto aos profiles .json da impressora.
Moonraker API com bash helpers reutilizaveis (api/moonraker-helpers.sh).
Validacao ASTM F963 com acesso ao checklist e documentacao de seguranca.
| Pratica | Antes | Depois |
|---|---|---|
| CLAUDE.md conciso | 132 linhas, verboso, ASCII art boxes | ~60 linhas, direto ao ponto |
| Frontmatter YAML valido | color: teal (campo invalido) |
Removido. Apenas campos oficiais: name, description, model, tools, maxTurns |
| Modelos por complexidade | Todos opus (caro) |
Orchestrator: opus | Workers logicos: sonnet | API simples: haiku |
| maxTurns definido | Sem limite (risco de loops) | 5-15 turns conforme complexidade |
| Separacao de responsabilidades | 1 agente monolitico (print-worker: modelo + slice + upload) | 3 agentes especializados (model + slice + printer) |
| disallowedTools explicitamente | Usado de forma inconsistente | Removido — melhor limitar via tools positivo |
| Instrucoes especificas e verificaveis | "REGRA INVIOLAVEL" + caixas ASCII | Tabelas de roteamento claras, sem linguagem enfatica |
| Description orientada a trigger | Descricao generica | Keywords de ativacao explicitamente listadas na description |
~/3d/3d/
├── CLAUDE.md
├── .claude/
│ ├── agents/
│ │ ├── print-orchestrator.md
│ │ ├── model-worker.md
│ │ ├── slice-worker.md
│ │ ├── printer-worker.md
│ │ └── safety-worker.md
│ └── skills/
└── site/
└── index.html
kobra-s1-setup/kobra-s1-setup/ ├── CLAUDE.md ├── .claude/agents/ │ ├── print-orchestrator.md │ ├── setup-worker.md │ ├── model-worker.md │ ├── slice-worker.md │ ├── printer-worker.md │ └── safety-worker.md ├── setup/ (01→06) ├── scripts/ ├── api/ ├── profiles/ ├── claude-3d/ ├── mods/ ├── safety/ └── docs/