| name | agents-dev |
| description | Modo desenvolvedor do fazer.ai agents: trabalhar no código-fonte. Clona o repo (Free público ou Pro via git proxy do hub), orienta nas boas práticas e invariantes (separação Free/Full, aditividade e convenções de docs/), pergunta proativamente o que o usuário quer implementar e conduz a implementação, e ajuda a gerar a própria imagem de deploy. Use quando o usuário quer DESENVOLVER, estender ou contribuir com o código do fazer.ai agents, não apenas subir (onboarding) ou operar (operação) uma instância. |
Modo desenvolvedor do fazer.ai agents
Leva um desenvolvedor de "quero mexer no código" até "implementou com as boas práticas do projeto e, se quiser, gerou a própria imagem". Audiência: desenvolvedor, não operador. Para subir uma instância do zero use a skill agents-onboarding; para debugar/ajustar uma instância em produção use agents-operation.
⚠️ Distribuição: o Pro é privado
- O repositório Pro/Full (
fazer-ai/agents-pro) e a imagem Pro são privados. Nunca publique o código, a imagem, ou trechos exclusivos do Full em local público (gist, fork público, registry público, post, screenshot).
- O acesso ao Pro é concedido individualmente. Vazar repo/imagem quebra esse modelo.
- Sugestões e contribuições vão para o repositório Free (open-source):
fazer-ai/agents. Abra issues/PRs lá.
Fluxo
- Obter o código (
references/00-get-the-code.md), bifurca por edição: Free clona o repo público (sem credencial); Pro clona via git proxy do hub (credencial per-user).
- Layout + porta de qualidade (
references/01-layout-and-bun-check.md): mapa do repo, bun install/bun dev, o ciclo bun check.
- Aditividade + invariantes (
references/02-free-full-and-invariants.md): aditividade e onde estão as convenções e os docs por subsistema.
- Implementação conduzida (
references/03-implement.md): perguntar o que implementar, desenhar desafiando premissas, implementar no estilo vizinho, validar.
- Imagem própria + deploy (
references/04-own-image-and-deploy.md): gerar a própria imagem e plugá-la num deploy (casa com o Tier C da agents-onboarding).
Guardrails
Ver guardrails.md (Pro privado, segredos fora do repo, bun check verde) e gotchas.md (armadilhas de DB/RLS/CSP).
Skills irmãs
agents-onboarding: subir uma instância nova num VPS (do zero ao agente).agents-operation: debugar/ajustar uma instância em produção.
Pendências
- Wording de não-redistribuição (Pro): é conteúdo público-facing; confirmar a redação com a revisão de licenciamento.
