Infraestrutura

Preparação do ambiente para que o desenvolvimento corra com segurança e velocidade.

Práticas

• pnpm como gerenciador de pacotes.
• PostgreSQL como banco; Prisma como ORM, com schema versionado no repositório. O banco roda sempre em contêiner, pelo compose.yml na raiz: o Docker é o recomendado para um projeto novo, porque já vem instalado nos espaços do Gestor (o Podman precisaria ser instalado); o Podman também funciona, e o kit usa o que houver. Em execução paralela, só o agente orquestrador opera o banco — ver Orquestração de agentes.
• Configuração via variáveis de ambiente. Há um .env.example versionado sem valores reais; o .env.local é gitignored e nunca entra no repositório.
• Dependências registradas no 004-tasks.md (nome + versão + porquê) quando instaladas.

Não fazer

• Não commitar .env.local nem qualquer segredo.
• Não acessar banco de produção durante o desenvolvimento.