felvieira Smart Suggestions
O Smart Suggestions analisa o estado atual do projeto, pipeline, pendencias e contexto para sugerir a proxima acao mais relevante ao usuario. Prioriza por impacto e risco, apresentando de 3 a 5 sugestoes com justificativa curta para cada uma.
Governanca Global
Esta skill segue GLOBAL.md, policies/execution.md, policies/persistence.md, policies/token-efficiency.md, policies/tool-safety.md, policies/handoffs.md e policies/evals.md.
Quando Usar
- quando o usuario nao sabe por onde comecar
- entre steps do pipeline para decidir prioridade
- quando o projeto tem multiplas pendencias concorrentes
- quando retomando sessao anterior e precisa de direcao
Quando Nao Usar
- para substituir o Orchestrator na definicao de pipeline
- para decisoes de negocio fora do escopo tecnico
- quando o usuario ja sabe exatamente o que quer fazer
Entradas Esperadas
- estado do pipeline atual
- repo audit (se existir em
docs/repo-audit/current.md) - git log recente
- session summaries anteriores (em
docs/context/) - pendencias registradas
memory/constitution.md(se existir — usar para sugerir gates faltantes)
Heuristicas de sugestao (Spec-Driven Development)
Detectar oportunidades de aplicar os novos commands quando contexto bate:
| Contexto detectado | Sugestao prioritaria |
|---|---|
Projeto maduro sem memory/constitution.md |
/constitution (bootstrap governance) |
| Spec recente sem checks marcados | /checklist <spec_path> antes de /plan |
Spec + plan + issues mas nenhum docs/analysis/ recente |
/analyze antes de /build |
/build em andamento sem TDD e constituicao exige |
rodar skill 37 antes de continuar |
Constituicao atualizada (commit recente em memory/) |
/analyze para detectar artefatos invalidados |
docs/specs/*.md ou docs/prd/*.md sem AC quantitativos |
revisitar com /checklist |
Saidas Esperadas
- lista priorizada de 3-5 sugestoes com justificativa curta
Responsabilidades
- Analisar estado atual do projeto e pipeline
- Identificar gaps e oportunidades de melhoria
- Priorizar sugestoes por impacto e risco
- Apresentar sugestoes com contexto e justificativa
- Adaptar sugestoes ao tipo de projeto e stack detectada
Fontes de Contexto
| Fonte | O que extrai |
|---|---|
| Repo Audit | gaps de stack, testes, docs e seguranca |
| Git log | trabalho recente, momentum, areas ativas |
| Session Summaries | pendencias, proximos passos, blockers |
| Pipeline state | onde parou, quais skills ja rodaram |
| CLAUDE.md | se o projeto esta configurado para o kit |
Padroes de Sugestao
- Projeto sem audit -> "Rodar Repo Auditor primeiro para mapear o estado atual"
- CLAUDE.md generico ou ausente -> "Rodar CLAUDE.md Generator para configurar o projeto"
- Sem testes detectados -> "Criar estrategia de testes com QA Testing"
- Interface desatualizada ou sem design system -> "Rodar Design Intelligence para avaliar UI"
- Codigo sem review recente -> "Executar Security Review + Reviewer para garantir qualidade"
Checkpoint antes de sugerir: confirmar a premissa contra o repo real, não contra o padrão genérico do tipo de projeto — "sem testes detectados" precisa ter checado package.json/pasta de testes de fato, não assumido pela ausência de menção no contexto atual. Sugestão baseada em premissa não verificada é ruído que o usuário aprende a ignorar, o que mata o valor da skill inteira.
Integracao com Outras Skills
- Orchestrator (09): usa as sugestoes para decidir proximo pipeline ou step
- Context Manager (08): fornece estado atual e historico de sessoes
- Repo Auditor (18): fornece gaps e riscos do projeto
Evidencia de Conclusao
- sugestoes apresentadas com justificativa clara
- usuario escolheu uma sugestao ou descartou com motivo
Handoff
Entregar:
- lista de sugestoes priorizadas
- contexto e fontes usadas para gerar as sugestoes
- skill recomendada para a sugestao escolhida
Seguir policies/handoffs.md.
Codigo Limpo
Manter sugestoes objetivas, priorizadas e com justificativa concisa para decisao rapida.