ENGINEERING TEMPLATE · MICRO FLOW · ETAPA 01 / 17
template.py · perfis · multi-provider · diretórios
Instalação e Configuração Inicial
Pré-requisitos · template.py init · seleção de perfis base · configuração multi-provider · estrutura de pastas
PRÉ-REQUISITOS
INIT
PROVIDERS
PERFIS
ESTRUTURA
VALIDAÇÃO
🐍 Python ≥ 3.11
+ Node.js + Git instalados
python --version · git --version
📦 Instalar Template
pip install engineering-template
ou: git clone + pip install -e .
🔑 API Keys
ANTHROPIC_API_KEY
OPENAI_API_KEY · GEMINI_KEY
⚙️ template.py init
python template.py init
wizard interativo de setup
🧩 Selecionar Perfis
base → github-projects
→ product-team → stacks
✅ template.py validate
config ok · keys ok · providers ok
pronto para uso
CHECKLIST PRÉ-INSTALL
• pip ≥ 23 (pip install --upgrade pip)
• virtualenv recomendado
• SO: Linux / macOS / WSL2
• RAM ≥ 8 GB recomendado
DEPENDÊNCIAS INSTALADAS
• anthropic · openai · google-genai
• pydantic · rich · typer · httpx
• gitpython · jinja2 · yaml
• pytest · ruff · mypy (dev)
CONFIGURAÇÃO DE KEYS
• .env na raiz do projeto
• ou variáveis de ambiente
• NUNCA comitar .env no git!
• .gitignore automático
WIZARD INIT — PERGUNTAS
1. Nome do projeto
2. Perfis a ativar (multi-select)
3. Providers prioritários
4. GitHub org / repo
PERFIS DISPONÍVEIS
• base (sempre ativo)
• github-projects (tracker)
• product-team (28 agentes)
• stacks (infra especialistas)
SAÍDA ESPERADA
✓ config.yaml gerado
✓ /agents/ · /prompts/ criados
✓ live-state.md inicializado
✓ .github/workflows/ prontos
ESTRUTURA DE DIRETÓRIOS GERADA
📁 projeto/
raiz do template
📁 /agents
28 arquivos YAML de agentes
📁 /prompts
templates de system prompt
📁 /worktrees
git worktrees por tarefa
📁 /docs
specs · ADRs · diagramas
📁 /sessions
diários · live-state.md
📄 config.yaml
perfis · providers · limites
🐍 template.py
ponto de entrada CLI
📁 .github/
workflows · templates
.env
gitignore!
CONFIGURAÇÃO MULTI-PROVIDER (config.yaml)
🟣 Anthropic
claude-opus-4 · sonnet · haiku
tier: deep · standard · light
🟢 OpenAI
gpt-4o · gpt-4o-mini
fallback provider
🔵 Google Gemini
gemini-2.0-flash · pro
fallback provider
prioridade:
1 → 2 → 3
→
💰 Budget por Wave
max_tokens_per_wave: 50_000
token_economy: enabled = true
🔄 Retry Config
max_retries: 3 · backoff: exp
timeout: 120s
⚡ Concorrência
max_parallel_agents: 4
semaphore por provider
🚀 SETUP COMPLETO
template.py validate → OK
próxima etapa: Perfis
LEGENDA
Pré-requisito / Setup
Configuração Crítica
Execução Ativa
Completo / Validado
Sistema de Suporte
Atenção / Risco
PRÓX.
→ Etapa 02: Seleção de Perfis — 10 perfis empilháveis · base → github-projects → product-team → stacks → customizações
ETAPA 01/17
·
Instalação e Configuração Inicial
template.py init · perfis · multi-provider · dirs