configurar-projeto · git:20261111.4d81fa5 · 2026-11-11 · sha256 db8ca60a3338c8e6
configurar-projeto git:20261111.4d81fa5A
Immutable. This exact content never changes and is served at /api/v1/blob/db8ca60a3338c8e6.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_qd25h2cusjvcqvlb/db8ca60a3338c8e67e18c805f746dc331a9dc6852ffd1adc334f16a87fc064bc.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 e configura a tecnologia após decidir o 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. Antes das ferramentas, confira a seleção de clientes no pedido ou estado do kit. Se faltar, pergunte quais usa e aplique pela CLI com `--agents` ou `agents`. Não deduza pelo aplicativo, SO ou pastas; sem resposta disponível, use `all`. Depois, siga `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` e 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][ambiente] 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 a stack. 3. Aplique a [estrutura e o ambiente obrigatórios][estrutura], 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. [ambiente]: ../../../templates/ambiente-local/TEMPLATE.md [estrutura]: ../../../rules/ambiente-local/RULE.md