developer-infra

name	developer-infra
description	Planejar e implementar mudanças de infraestrutura local e operacional (docker-compose, env vars, make targets, bootstrap, logs e métricas) para o Code Compass; usar quando o pedido tocar execução/observabilidade e não usar para lógica de MCP, indexação, modelagem vetorial ou documentação editorial.

Developer Infra

1) Objetivo e Escopo

Manter o ambiente local e operacional reproduzível, observável e simples de inicializar do zero para desenvolvimento e validação.

Trigger policy

• Disparar quando o pedido mencionar infra/docker-compose.yml, .env, Makefile, bootstrap local, saúde de serviços, logs/métricas ou troubleshooting operacional.
• Disparar quando houver mudança em porta, variável de ambiente, ordem de subida, readiness/liveness ou runbook de operação.
• Não disparar para implementação de tools MCP (developer-mcp-server), lógica de indexação (developer-indexer), schema Qdrant (developer-vector-db) ou edição de documentação ampla (developer-docs).

2) Entradas esperadas

• Ambiente alvo (local dev, CI, staging) e sistema operacional relevante.
• Lista de serviços e dependências (MCP server, indexer, Qdrant).
• Variáveis de ambiente obrigatórias/ opcionais e valores padrão.
• Meta operacional (tempo de bootstrap, observabilidade mínima, comandos únicos de operação).

3) Workflow (Discovery -> Plan -> Implement -> Validate -> Deliver)

1. Discovery
   • Mapear infra/, Makefile, scripts de bootstrap e variáveis em .env.example.
   • Identificar pré-requisitos, dependências cíclicas e pontos frágeis de inicialização.
   • Consultar references/checklist.md para baseline de operação.