Stack, Ciclo de Dev, Infraestrutura & Governança (Streams E–H)
Os Streams E a H cobrem o ecossistema de desenvolvimento mais amplo — decisões de stack, geração de agentes, tooling, integração com git, orquestração multi-agente e governança.
Stream E — Stack & Agentes
suggest_stack
Sugira uma stack tecnológica com base nos requisitos do projeto.
Quando usar: No início do projeto quando a equipe está escolhendo entre tecnologias concorrentes, ou ao validar uma escolha de stack contra as restrições do projeto.
Prompt: "Sugira uma stack para um editor de documentos colaborativo em tempo real para o projeto proj_abc123"check_versions
Verifique versões de dependências para atualizações, depreciações e problemas de segurança.
O que verifica:
- Versões atuais vs. últimas estáveis
- CVEs conhecidas e avisos de segurança
- Pacotes depreciados
- Avisos de breaking changes para grandes diferenças de versão
Prompt: "Verifique as versões de dependências para o projeto proj_abc123"generate_skill
Gere um arquivo de skill para um agente de IA específico.
Plataformas suportadas: Claude Code (skills CLAUDE.md), Cursor (fragmentos .cursorrules), Windsurf, instruções Copilot, definições de agentes customizados.
Prompt: "Gere uma skill do Claude Code para o fluxo de autenticação no projeto proj_abc123"detect_agent
Detecte a plataforma de agente de IA em uso no caminho do projeto.
Quando usar: Quando você precisa gerar artefatos específicos do agente (arquivos de regras, skills, arquivos de memória) e quer que o SpecForge selecione automaticamente o formato correto.
Prompt: "Detecte qual agente de IA está configurado em /Users/me/meu-app"generate_sub_agent
Gere uma definição de sub-agente para orquestração multi-agente.
O que produz: Uma definição estruturada de agente com capacidades, propriedade de recursos, protocolo de handoff e contrato de comunicação — pronto para uso com orchestrate_agents.
Prompt: "Gere um sub-agente para a tarefa de migração de banco de dados na spec SPEC-011 do projeto proj_abc123"generate_rules
Gere arquivos de regras para agentes — .cursorrules, CLAUDE.md, instruções Copilot, regras Windsurf — a partir da Constituição do projeto e padrões detectados.
Prompt: "Gere um CLAUDE.md para o projeto proj_abc123"
Prompt: "Gere .cursorrules para o projeto proj_abc123"Stream F — Ciclo de Dev
suggest_tooling
Avalie e sugira tooling para o ciclo de dev em toda a stack.
Cobertura:
- CI/CD (GitHub Actions, GitLab CI, CircleCI, etc.)
- Testes (unitário, integração, E2E, regressão visual)
- Monitoramento e observabilidade (OpenTelemetry, Datadog, Grafana)
- Tooling de IA nativa (observabilidade de LLM, cache semântico, gerenciamento de prompts, guardrails)
- Tooling de performance frontend (Lighthouse CI, regressão visual, bibliotecas de componentes)
Prompt: "Sugira tooling para o projeto proj_abc123"generate_tests
Gere um plano de testes e stubs de arquivos de teste a partir dos critérios de aceitação de uma spec.
O que produz:
- Plano de testes com nomes de casos de teste mapeados para critérios de aceitação
- Stubs de arquivos de teste no framework de testes do seu projeto (vitest, pytest, go test, JUnit, etc.)
- Metas de cobertura por critério
- Estratégia de mock para dependências externas
Prompt: "Gere testes para a spec SPEC-003 no projeto proj_abc123"generate_docs
Gere documentação a partir de specs e código — docs de API, seções de README, visões gerais de arquitetura.
Prompt: "Gere documentação de API para a spec SPEC-007 no projeto proj_abc123"
Prompt: "Gere uma seção de README para o módulo de autenticação a partir da spec SPEC-001"integrate_pm
Integre com ferramentas de gerenciamento de projetos — crie issues, epics ou tarefas a partir de specs.
Suportados: Jira, Linear, GitHub Issues, GitLab Issues, Trello, Notion.
Prompt: "Crie uma issue do GitHub para a spec SPEC-004 no projeto proj_abc123"
Prompt: "Crie uma tarefa no Linear para a spec SPEC-009 no projeto proj_abc123"Stream G — Infraestrutura
manage_context
Salve, carregue e gerencie notas de contexto persistentes entre sessões.
Quando usar: Quando você precisa preservar decisões arquiteturais importantes, restrições externas ou acordos da equipe que não estão capturados nas specs.
Prompt: "Salve o contexto: decidimos usar Postgres 16 com pgvector para todas as funcionalidades de IA no projeto proj_abc123"
Prompt: "Que contexto salvamos para o projeto proj_abc123?"manage_git
Integração com git — crie branches, gere descrições de PR, changelogs e hooks vinculados a specs.
Prompt: "Crie um branch para a spec SPEC-005 no projeto proj_abc123"
Prompt: "Gere uma descrição de PR para a spec SPEC-005 no projeto proj_abc123"
Prompt: "Gere um changelog das specs SPEC-001 a SPEC-010 para o projeto proj_abc123"orchestrate
Orquestração multi-agente — registre agentes, bloqueie recursos, distribua tarefas, coordene execução paralela.
Prompt: "Registre um agente para a spec SPEC-011 e bloqueie o módulo de auth no projeto proj_abc123"consult_docs
Consulte documentação de framework sobre um tópico específico — busca e resume docs relevantes sem sair da conversa.
Prompt: "Consulte os docs do React sobre renderização concorrente para o projeto proj_abc123"
Prompt: "O que os docs do FastAPI dizem sobre injeção de dependências?"discover_mcps
Descubra servidores MCP configurados no ambiente atual.
Prompt: "Quais servidores MCP estão disponíveis no meu ambiente?"suggest_mcps
Sugira servidores MCP que beneficiariam o projeto com base na sua stack e padrões detectados.
Prompt: "Sugira servidores MCP para o projeto proj_abc123"migrate_tech
Guie migrações de stack tecnológica — analise a base de código fonte, mapeie equivalências, gere um plano de migração, valide paridade funcional e planeje migração de banco de dados.
Quando usar: Ao mover de um framework para outro (Express → Fastify, Django → FastAPI, Create React App → Vite), fazer upgrade de uma dependência principal ou migrar bancos de dados.
Prompt: "Planeje uma migração de Express para Fastify para o projeto proj_abc123"
Prompt: "Migre de componentes de classe para funcionais em React no projeto proj_abc123"orchestrate_agents
Declare capacidades de agentes, roteie tarefas para o melhor agente, gere contextos estruturados de handoff e detecte conflitos de propriedade de arquivos antes da execução paralela.
Prompt: "Orquestre agentes para as specs SPEC-012, SPEC-013, SPEC-014 no projeto proj_abc123"validate_workflow
Valide convenções do fluxo de trabalho do desenvolvedor — seleção de modelo de IA, conformidade com Git Flow, convenções de ferramentas MCP ou auditoria completa do fluxo de trabalho.
Prompt: "Valide meu fluxo de trabalho para o projeto proj_abc123"
Prompt: "Verifique a conformidade com Git Flow para o projeto proj_abc123"log_decision
Registre, liste, pesquise ou substitua decisões arquiteturais e de processo para um projeto.
Quando usar: Alternativa leve a ADRs completos para decisões de processo, escolhas de ferramentas ou acordos da equipe.
Prompt: "Registre decisão: usaremos pnpm como gerenciador de pacotes para todos os novos projetos"
Prompt: "Liste todas as decisões do projeto proj_abc123"facilitate
Ponto de entrada para usuários não familiarizados com o SpecForge — guia-os pelo fluxo de trabalho SDD de forma interativa.
Quando usar: Ao integrar um novo membro da equipe ou quando alguém está usando o SpecForge pela primeira vez.
Prompt: "Facilite uma sessão do SpecForge para meu projeto em /Users/me/meu-app"request_context
Gere um prompt que pede ao usuário documentação de referência (README, PRD, docs de arquitetura) para enriquecer a base de conhecimento do projeto.
Prompt: "Solicite contexto para o projeto proj_abc123"contribute_context
Persista conhecimento estruturado extraído de documentos fornecidos pelo usuário na base de conhecimento do projeto.
Prompt: "Contribua o documento PRD anexado para o projeto proj_abc123"Stream H — Governança & Saúde da Stack
data_governance
Detecte PII em specs, gere políticas de retenção, rascunhe avisos de privacidade e audite conformidade com GDPR/CCPA/LGPD.
Quando usar: Antes de qualquer spec que lide com dados de usuários — fluxos de cadastro, gerenciamento de perfil, análises ou exportações de dados.
Prompt: "Execute uma verificação de governança de dados na spec SPEC-006 para o projeto proj_abc123"
Prompt: "Gere uma auditoria de conformidade com GDPR para o projeto proj_abc123"audit_stack
Audite todas as dependências do projeto — classifica como up_to_date, outdated, vulnerable ou unmaintained. Gera um StackHealthScore (0–100).
Quando usar: Periodicamente (mensalmente ou antes de cada release) para manter o grafo de dependências saudável.
Prompt: "Audite a stack do projeto proj_abc123"plan_upgrade
Gere um plano de migração para fazer upgrade de um pacote específico — breaking changes, esforço estimado e procedimento de rollback.
Prompt: "Planeje o upgrade do React 18 para React 19 no projeto proj_abc123"
Prompt: "Planeje o upgrade do Zod de v3 para v4 no projeto proj_abc123"detect_deprecations
Varre arquivos fonte do projeto em busca de padrões de API depreciadas (sem necessidade de rede) e retorna um relatório de depreciações com estimativa de dívida técnica.
Quando usar: Antes de um upgrade de versão principal, ou como parte de uma revisão trimestral de dívida técnica.
Prompt: "Detecte APIs depreciadas no projeto proj_abc123"check_config_health
Analisa arquivos de configuração do projeto para detectar erros, campos ausentes e violações de boas práticas em todos os ecossistemas.
Quando usar: Após o setup do projeto, durante onboarding, ou quando builds falham por razões de configuração.
Prompt: "Check config health for project proj_abc123"