smart-suggestions
Skill28 starsChanged 3 months agoApache-2.0View on GitHub
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".
In this repository92 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- po-feature-specSkill
- ui-ux-designSkill
- backend-apiSkill
- frontend-integrationSkill
- qa-testingSkill
- security-reviewSkill
- deploy-dockerSkill
- context-managerSkill
- orchestratorSkill
- documenterSkill
- reviewerSkill
- motion-designSkill
- marketing-copySkill
- seo-specialistSkill
- mobile-tauriSkill
- image-generatorSkill
- repo-auditorSkill
- asset-librarianSkill
- observability-sreSkill
- data-analyticsSkill
- accessibility-specialistSkill
- migration-refactor-specialistSkill
- release-managerSkill
- ai-integration-architectSkill
- prompt-engineerSkill
- video-integration-specialistSkill
- claude-md-generatorSkill
- design-intelligenceSkill
- cost-trackerSkill
- session-summarySkill
- detective-specSkill
- static-analysisSkill
- skill-authorSkill
- web-asset-generatorSkill
- tdd-engineerSkill
- architecture-deepenerSkill
- program-routerSkill
- parallel-dispatcherSkill
- blog-publisherSkill
- blog-screenshotSkill
- canary-deploymentSkill
- zoom-outSkill
- handoff-contextSkill
- post-deploy-canary-monitorSkill
- pattern-conformitySkill
- research-prepSkill
- context-budgetSkill
- direct-response-copySkill
- ux-researchSkill
- ui-polishSkill
- doubt-driven-reviewSkill
- video-analysisSkill
- marketing-reporting-analyticsSkill
- responsive-conversionSkill
- mobile-ux-foundationsSkill
- i18n-localizationSkill
- closed-loop-revenueSkill
- app-reference-architectureSkill
- The first 60 shown.
The file
Files
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.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

