felvieira/smart-suggestions
skills/32-smart-suggestions/SKILL.md
Skill de sugestoes inteligentes de proxima acao. Analisa o estado atual do pipeline, artefatos produzidos, pendencias e contexto do projeto para sugerir a proxima acao mais relevante ao usuario. Trigger em: "o que fazer agora", "sugestao", "suggest", "proximo passo", "next", "what now", "me ajuda a decidir", "priorizar".
$ install --global
skillsauthnpx skillsauth add felvieira/claude-skills-fv smart-suggestionsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 16, 2026, 3:14 AM253.0s1 file scanned
SKILL.md
- name:
- smart-suggestions
- description:
- |
- Trigger em:
- o que fazer agora", "sugestao", "suggest", "proximo passo", "next", "what now",
- argument-hint:
- [--context pipeline | feature | general]
- allowed-tools:
- Read, Glob, Grep
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"
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.
Related Skills
felvieira/po-feature-spec
testing
VerifiedTrustedCommunity
Skill do Product Owner para especificação de features. Use quando precisar definir requisitos de negócio, escrever user stories, critérios de aceitação, priorização de backlog, ou qualquer documento de especificação de produto. Inclui fundamento de negócio para discovery: validação de hipótese, problema vs. necessidade, MVP, modelo de monetização e métricas pirata (AARRR) como input da spec. Trigger em: "nova feature", "especificação", "user story", "requisito", "backlog", "PO", "definir escopo", "critério de aceitação", "MVP", "roadmap", "validação de hipótese", "discovery", "monetização", "pricing", "product-market fit", "métricas AARRR".
20SKILL.mdUpdated Apr 4, 2026
felvieira/41-blog-publisher
development
VerifiedTrustedCommunity
Skill compositora que pega texto/assunto e gera post de blog HTML completo no repo {blog_repo_path} ({github_user_repo_url}), com imagens (via skill 17 fal.ai ou skill 42 Playwright screenshot), commit+push automático, retorna URL pública via GitHub Pages. Trigger em: "post no blog", "publicar post", "escrever post", "blog post", "publish blog", "gera post", "criar post", "novo post no meu blog".
19SKILL.mdUpdated May 25, 2026
felvieira/context-budget
tools
VerifiedTrustedCommunity
Audita o peso de contexto carregado na sessão — CLAUDE.md, agents, MCP descriptions, rules ativas, skills invocadas e histórico acumulado. Estima tokens por componente, reporta headroom disponível e emite alertas de overflow. Distinto do cost-tracker (skill 30) que rastreia tokens gastos em completions runtime. Trigger em: "contexto inchado", "context overflow", "quanto contexto estou usando", "peso do contexto", "context budget", "tokens carregados", "sessao lenta", "respostas degradadas", "headroom de contexto", "custo fixo de contexto", "overhead de rules", "overhead dos agents", "impacto do MCP no contexto", "espaco no context window", "quanto cabe no context window"
18SKILL.mdUpdated May 29, 2026
felvieira/research-prep
development
VerifiedTrustedCommunity
Coleta e organiza informacao tecnica multi-fonte antes de escrever docs, PRDs, ADRs ou artigos. Busca em: docs oficiais, GitHub (repos + issues), Stack Overflow, papers e blogs de referencia. Ranqueia fontes por autoridade (oficial 40% + recencia 30% + profundidade 20% + comunidade 10%). Output: memory/research/<slug>.md pronto para alimentar skill 10 (documenter), skill 01 (po-feature-spec), skill 26 (prompt-engineer) ou skill 41 (blog-publisher). Trigger em: "pesquisa tecnica", "levanta informacao", "coleta docs", "busca referencias", "preciso de fontes", "research antes de escrever", "levanta o que existe sobre", "benchmark de solucoes", "o que existe sobre X", "quero entender o estado da arte", "compara abordagens", "levanta referencias", "faz um research de", "coleta fontes sobre", "pesquisa sobre", "quero saber o que existe de", "monta um dossie tecnico", "background tecnico", "due diligence tecnica", "levantamento de alternativas".
18SKILL.mdUpdated May 29, 2026