Skip to content

Livro de Receitas do Pantheon: Casos Práticos do Dia a Dia

🇺🇸 English version available: Read in English

Este livro de receitas reúne os fluxos de trabalho mais comuns no desenvolvimento diário com o Pantheon, apresentando os prompts exatos, ferramentas utilizadas e qual especialista acionar em cada cenário.


Receita 1: Funcionalidade Full-Stack com TDD e Portão de Qualidade

Cenário: Implementar uma nova funcionalidade de ponta a ponta (ex: endpoint de exportação de relatórios em CSV com validação de schema e testes).

Prompt:

@zeus Adicione suporte a exportação CSV em /reports com testes unitários e validação de schema.

Fluxo de Execução: 1. O @zeus analisa o escopo e delega o planejamento para a @athena. 2. A @athena estrutura as fases e critérios de aceite; dúvidas de design são apresentadas pela ferramenta interativa nativa question. 3. Após aprovação, o @hermes escreve testes que falham (RED) e implementa até passarem (GREEN). 4. A @themis roda linters, auditoria de segurança e valida a cobertura de testes antes da conclusão.


Receita 2: Hotfix em 1 Turno (Bugs e Correções Pontuais)

Cenário: Corrigir um erro visual de CSS, um erro de digitação ou um import quebrado sem cerimônia de planejamento.

Prompt:

@talos Altere a cor de fundo do botão de login de azul para verde esmeralda no arquivo login.css

Por que usar o @talos? O @talos é a faixa expressa do Pantheon. Ele opera sem subagentes, pula rituais de planejamento Deepwork, realiza edições cirúrgicas em um único turno e finaliza imediatamente.


Receita 3: Migrações de Banco de Dados e Otimização de Consultas

Cenário: Criar uma nova tabela ou coluna com índices adequados e integridade referencial.

Prompt:

@demeter Crie uma migration Alembic adicionando a tabela 'user_preferences' com chave estrangeira para 'users' e índice em 'created_at'.

Por que usar o @demeter? O @demeter é o especialista em persistência do Pantheon. Ele domina SQLAlchemy, Prisma, Alembic e PostgreSQL, prevenindo problemas clássicos de consultas N+1 e índices ausentes.


Receita 4: Refatoração Visual Baseada em Captura de Tela (Screenshot)

Cenário: Reconstruir ou refinar um componente frontend para corresponder a um mockup.

Prompt: (Cole a imagem da área de transferência com Ctrl+V / Cmd+V no chat)

@aphrodite Refatore este card de métricas para refletir fielmente o espaçamento, tipografia e cores da captura colada.

Fluxo de Execução: 1. O Pantheon Vision processa a imagem silenciosamente via contexto de sistema (session.context). 2. A @aphrodite analisa a hierarquia visual, espaçamentos e acessibilidade WCAG AA, atualizando os componentes React/Tailwind.


Receita 5: Investigação Segura da Base de Código (Somente Leitura)

Cenário: Compreender uma lógica complexa espalhada por vários arquivos sem risco de edições indesejadas.

Prompt:

@apollo Rastreie o repositório e explique como os tokens de autenticação são validados em conexões WebSocket ativas.

Por que usar o @apollo? O @apollo opera em modo estritamente somente leitura (edit: deny, bash: deny). Ele realiza buscas rápidas e paralelas, retornando caminhos exatos de arquivos e intervalos de linhas relevantes.


Receita 6: Auditoria de Segurança e Qualidade Pré-PR

Cenário: Fazer uma revisão completa de todas as alterações feitas na branch antes de abrir um Pull Request.

Prompt:

@themis Audite as mudanças desta branch contra o OWASP Top 10, execute os testes e o linter Biome, e emita o veredicto de qualidade.

Por que usar a @themis? A @themis atua como auditora independente em modo read-only. Ela nunca altera código diretamente; executa suítes de teste, analisa regras estáticas e emite pareceres formais (PASS, PASS_WITH_NOTES, BLOCK).


Receita 7: Inteligência Artificial e Pipelines de RAG

Cenário: Implementar busca semântica com embeddings vetoriais.

Prompt:

@hephaestus Crie um pipeline de busca vetorial usando LangChain e pgvector para recuperação semântica de trechos de documentos.

Por que usar o @hephaestus? O @hephaestus é especialista em embeddings, bancos de dados vetoriais, orquestração de LLMs e ferramentas de inteligência artificial.


Receita 8: Docker e Automação de CI/CD

Cenário: Criar Dockerfile multi-stage e workflow do GitHub Actions.

Prompt:

@prometheus Crie um Dockerfile multi-stage otimizado para produção em Node.js e um workflow do GitHub Actions para testar PRs.

Por que usar o @prometheus? O @prometheus é o especialista em DevOps, contêineres, pipelines de integração contínua e scripts de infraestrutura.


Receita 9: Síntese de Conselho para Decisões de Arquitetura (/pantheon)

Cenário: Decidir entre duas soluções arquiteturais com múltiplos prós e contras técnicos.

Prompt:

/pantheon Devemos utilizar Server-Sent Events (SSE) ou WebSockets para o feed de notificações em tempo real do dashboard?

Por que usar /pantheon? Dispara 2 ou 3 especialistas em paralelo (@athena para modularidade, @hermes para vazão/APIs, @themis para limites de conexões e segurança) e sintetiza uma decisão unificada com precedência de domínio.


Receita 10: Projeto Multidisciplinar com Checkpoints (/pantheon-deepwork)

Cenário: Migrar ou refatorar subsistemas complexos que levam múltiplos turnos e dias de trabalho.

Prompt:

/pantheon-deepwork Migre o armazenamento de sessões de usuário de memória para cookies JWT criptografados com lista de revogação no Redis.

Fluxo de Execução: 1. O plano e o progresso são salvos em .pantheon/deepwork/<slug>/ (plan.json, PLAN.md, logs). 2. Especialistas trabalham concorrentemente em git worktrees isolados (.pantheon-worktrees/). 3. Cada fase concluída passa pelo portão de aprovação da @themis antes do avanço.


Receita 11: Tomada de Decisão Interativa via Portão de Perguntas

Cenário: Resolver trade-offs técnicos durante o planejamento de forma dinâmica e interativa.

Fluxo de Execução: Quando a @athena elabora um plano com caminhos técnicos alternativos, o @zeus aciona a ferramenta nativa question do OpenCode: - A interface exibe caixas interativas com opções claras. - A alternativa mais alinhada às boas práticas vem marcada como (Recomendado). - O desenvolvedor clica na opção preferida e a orquestração prossegue imediatamente sem atrito de digitação no chat.


Receita 12: Diagnóstico de Saúde e Detecção de Drift (doctor)

Cenário: Verificar a saúde dos servidores MCP locais, permissões e integridade de arquivos do Pantheon.

Comando:

npx pantheon-opencode doctor

Quando Executar: - Após alternar entre branches git ou sincronizar atualizações do repositório remoto. - Ao atualizar o Node.js ou o OpenCode. - Caso alguma ferramenta MCP relate falhas de conexão ou dependências ausentes.