configuração-de-projeto

Configuração de projeto

Cada etapa usa o CLI oficial ou a documentação da ferramenta envolvida (skill official-docs). Pergunte antes de qualquer ação remota.

Acabou de criar (o CLI já gerou, instalou e verificou tudo)

1. Leia PROJECT.md e preencha O quê (nome, domínio, tipo, propósito) com o humano, nas palavras dele. {{#dotenv}}
2. O humano copia .env.example para .env e o preenche{{#auth}} ({{dlx}} auth@latest secret gera o segredo de autenticação){{/auth}}. Agentes nunca criam, leem ou escrevem .env. Até que ele exista, teste com valores descartáveis definidos apenas para aquele comando. {{/dotenv}} {{#postgres}}
3. Banco de dados local: docker compose up -d, depois {{run}} db:migrate (pergunte primeiro). {{/postgres}} {{#d1}}
4. Banco de dados local: {{run}} db:migrate (pergunte primeiro). {{/d1}}
5. {{run}} docs:sync, depois preencha docs/DEPLOYMENT.md (URLs, onde os segredos estão definidos). {{#cloudflare}} Substitua os placeholders de id em wrangler.jsonc assim que os recursos existirem (DEPLOYMENT.md → Configuração inicial). {{/cloudflare}}
6. Deixe design/DESIGN.md para a skill website-design, que coleta os inputs de design em ordem antes da primeira página; a página inicial é um placeholder.
7. Quando o repositório estiver no GitHub, o humano ativa Settings → Actions → General → "Allow GitHub Actions to create and approve pull requests", para que a atualização semanal das skills do agente possa abrir seu pull request. Dependabot e alterações de workflow: skills dependabot e github-actions-hardening.
8. {{run}} log "Projeto configurado" --by <agent>.

Projeto existente (adotando o kit)

1. {{dlx}} create-agent-ready-app@latest install . adiciona apenas a estrutura do agente (AGENTS.md, skills, scripts, guardrails); ele detecta os complementos a partir do package.json. AGENTS.md, CLAUDE.md, .cursorrules e arquivos similares antigos são movidos para docs/legacy-agents.md: incorpore as regras que ainda se aplicam em PROJECT.md → Regras para agentes, depois exclua-o (pergunte).
2. Preencha PROJECT.md com base no que existe (package.json, rotas, uma listagem rápida de pastas). Não explore profundamente.
3. Não reestruture. Liste as lacunas (estrutura, verificações, SEO, segurança) como uma única tarefa Grande proposta e pergunte.

Adicionando um complemento depois (Protegido)

1. Faça uma pergunta sim/não: o complemento, os pacotes que ele adiciona, os arquivos que ele cria.
2. {{dlx}} create-agent-ready-app@latest add <complemento> . cria os arquivos do complemento que ainda não existem, atualiza AGENTS.md e as skills, instala o pacote de skills dele e imprime os pacotes a serem adicionados.
3. {{add}} esses pacotes. Em seguida, integre-os nos arquivos que o projeto já possui, seguindo os arquivos do complemento no repositório create-agent-ready-app (template/frameworks/) e a documentação oficial:
   • query: {{#tanstack-start}}src/router.tsx (integração QueryClient + SSR) e src/routes/__root.tsx (painel de devtools){{/tanstack-start}}{{#next}}src/shared/lib/tanstack/query-provider.tsx em src/app/layout.tsx{{/next}};
   • shadcn: {{dlx}} shadcn@latest apply --preset nova, depois add os componentes que você precisa;
   • auth: os guards em {{#tanstack-start}}src/routes/_private/{{/tanstack-start}}{{#next}}src/app/(private)/{{/next}} e {{run}} auth:generate, depois {{run}} db:generate.
4. {{run}} docs:sync, {{run}} check, atualize PROJECT.md → Stack e Decisões, e adicione uma linha de log.

Removendo um complemento (Protegido)

{{dlx}} create-agent-ready-app@latest remove <complemento> . remove seus arquivos do kit, skills, scripts e permissões. Excluir seu código e pacotes é uma tarefa Grande: use rg para cada uso, exclua-o, depois {{run}} check.

Skills de agente

• As skills da comunidade em .agents/skills/ vêm de seus criadores (skills-lock.json registra cada fonte e um hash). {{run}} skills:update as atualiza; leia o diff antes de commitar, como para qualquer alteração de código.
• Mais skills: prefira as oficiais dos criadores da ferramenta (https://www.skills.sh/official); skill find-skills ou {{dlx}} skills@latest add <owner/repo> --skill <name> -a universal -a claude-code (pergunte primeiro). Um pacote opcional do kit: {{dlx}} create-agent-ready-app@latest add <pack> . (marketing, revisão de segurança…).

Atualizando o kit

{{run}} kit:update atualiza AGENTS.md, skills e scripts. Os arquivos do kit alterados neste projeto são mantidos e relatados; coloque regras específicas do projeto em PROJECT.md em vez de editar arquivos do kit.