configurar-projeto · git:20261111.1b4910b · 2026-11-11 · sha256 f628125887bd6dbb
configurar-projeto git:20261111.1b4910bA
Immutable. This exact content never changes and is served at /api/v1/blob/f628125887bd6dbb.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_qd25h2cusjvcqvlb/f628125887bd6dbb4d782f4df99d28952e75410edf2d63138677cd311ee2be05.json
Then /plugin install configurar-projeto@markdownregistry-qd25h2cusjvcqvlb in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: configurar-projeto description: Prepara um projeto novo e configura sua estrutura técnica após as decisões de produto. --- # Configurar projeto Inspecione somente este repositório. Se a intenção for rodar ou reparar um projeto existente na máquina, use `preparar-dev`; não reinicie seu planejamento. Enquanto o usuário configurar apenas os agentes, mantenha modelos em `.pbai4devs/templates/`, sem criar produto, `docs/` ou aplicação. Comece por `instalar-ferramentas`: confira Node/npm antes dos scripts, prepare as ferramentas e rode o diagnóstico. Isso não escolhe a stack da aplicação. ## Preparar o projeto Reúna dúvidas no início e aproveite decisões existentes. Quando o projeto começar, crie ou retome `.pbai4devs/estado/configuracao/ESTADO.md` pelo modelo. Combine os arquivos `prd`, `ux_ui`, `design`, `roadmap` e diretórios `releases`, `specs`, `tarefas`, além dos documentos de apoio aplicáveis. Crie/evolua o README da raiz pelos [modelos da fase](../../../templates/README.md), preservando os fatos existentes; cada pasta de documentos terá seu README. Registre evidências da preparação e encaminhe a `criar-prd` → `criar-ux-ui` → `criar-design-doc` → roadmap → spec. Não escolha stack nem inicialize código antes dessas decisões. ## Configurar a tecnologia Exija PRD, design e spec aprovados; UX/UI aprovado ou não aplicável com justificativa aprovada. Siga o plano aprovado em `implementar-spec`, respeitando aprovações já dadas. 1. Use `executar-script` com `inspecionar-projeto` e `diagnosticar-ambiente` para identificar estrutura, SO, arquitetura e ferramentas. Reúna as perguntas do [modelo de ambiente](../../../templates/ambiente-local/TEMPLATE.md) antes de instalar. Decisões materiais faltantes voltam ao design. 2. Prepare as ferramentas definidas em `.pbai4devs/tools/<nome>/TOOL.json` com `preparar-ferramentas`; confira versões e compatibilidade com SO/arquitetura. Reutilize instalações e lockfiles; não repita init nem troque versões da stack. 3. Aplique a [estrutura e o ambiente obrigatórios](../../../rules/ambiente-local/RULE.md), preenchendo os modelos de Makefile, Compose e dockerignore. Configure os serviços reais, healthchecks, portas, volumes e comandos da tecnologia. 4. Configure VS Code e recomende EditorConfig, sem regras conflitantes. Termine `.gitignore` com o modelo CUSTOM IGNORE e os padrões da tecnologia; confirme que templates, scripts, testes e fixtures continuam versionáveis. 5. Documente versões, estrutura, setup, comandos, origem do template/init e decisões no README/estado. Use `atualizar-documentacao` para contribuição, configuração e ADRs aplicáveis. Preserve arquivos e convenções existentes. 6. Use `verificar-trabalho`: valide Compose, build, saúde dos serviços e testes acordados; confira a estrutura com `inspecionar-projeto --check`. Com aplicação, prove o fluxo real no navegador/desktop conforme seu tipo; sem aplicação, registre a prova funcional pendente. Marque `configuracao_tecnica: concluido` somente com evidência da configuração. Após alterações técnicas, conclua `revisar-entrega`. Sincronize apontamentos somente quando recursos dos agentes forem alterados.