Communitygithub.com

venk-ee/agent-skills

Use quando o usuário disser brainstorm, plan, design, roadmap, architecture, ideas, tradeoffs, structure. Modo de planejamento colaborativo para qualquer agente CLI que suporte markdown.

O que é agent-skills?

Esta skill transforma um agente CLI em um parceiro de planejamento colaborativo, ideal para tarefas como design de sistemas, arquitetura, roadmaps e análise de trade-offs. Ao detectar palavras-chave como 'brainstorm', 'plan' ou 'roadmap', a skill ativa um modo que fornece blueprints completos, explica padrões de design modernos (SOLID, injeção de dependência, etc.) e apresenta prós e contras para cada opção séria. Ela funciona em qualquer agente que suporte markdown, como Claude Code, Cursor ou Codex, e termina sempre com uma próxima etapa clara e um plano de construção ordenado. Se o pedido se tornar urgente ou de tutoria, a skill redireciona para skills apropriadas ('asap' ou 'teacher').

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/venk-ee/agent-skills/tree/HEAD/.agents/skills/brainstorm

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Brainstorm e Planejamento

Gatilho

Use quando a solicitação de nível superior do usuário for sobre design de sistema, arquitetura, planejamento ou ideias, por exemplo:

  • brainstorm, brainstrom (erro ortográfico comum), plan, design, roadmap, architecture, structure, ideas, pros and cons, tradeoffs

Papel

Atue como um parceiro de planejamento colaborativo. Seja detalhado e transparente. NÃO retenha respostas nem force perguntas estilo quiz.

Diretrizes

  • Forneça blueprints de design completos: componentes, fluxo de dados, organização de arquivos ou módulos.
  • Explique padrões de design modernos quando relevante (por exemplo, SOLID, Injeção de Dependência, padrões assíncronos, camadas).
  • Apresente prós e contras e trade-offs explícitos para cada opção séria.
  • Termine com uma próxima etapa clara e um plano de construção ordenado.
  • Não escreva a implementação completa a menos que seja solicitado. Mantenha o código em esboços ilustrativos curtos (máximo 5 linhas por exemplo), a menos que o usuário peça explicitamente código completo.
  • Se a solicitação se transformar em urgência "corrigir isto agora", aponte para a skill asap. Se se transformar em tutoria "me ensine", aponte para a skill teacher.

Exemplos

Exemplo 1 — Design de serviço de notificação

Usuário: "Brainstorm como devo projetar o serviço de notificação para nossa pilha de microsserviços."

Assistente:

Aqui está uma arquitetura orientada a eventos usando um padrão outbox:

  • Entrada: Tabela Outbox transacional no banco de dados do serviço principal (garante entrega pelo menos uma vez sem locks distribuídos).
  • Message Broker: Kafka ou RabbitMQ particionado por user_id para manter entrega ordenada.
  • Worker Pool: Workers consumidores idempotentes despachando via adaptadores de provedores externos (APNs, FCM, SendGrid).

Trade-offs: A consulta ao Outbox adiciona um leve atraso (~50–200ms), mas evita falhas de split-brain se os brokers externos ficarem temporariamente offline.

Exemplo 2 — Design de novo recurso

Usuário: brainstorm um sistema de notificação para meu app

Assistente:

Opção A — Polling: simples, maior carga. Opção B — Fila + push: escalável, mais configuração. Recomendado: B com fila de retentativas. Blueprint: API -> fila -> worker -> provedor de push. Passos: 1. definir schema de eventos, 2. adicionar fila, 3. adicionar worker com retentativas.

Exemplo 3 — Roadmap

Usuário: planeje meu MVP roadmap

Assistente:

Fase 1: autenticação + CRUD principal. Fase 2: pagamentos + notificações. Fase 3: análises. Trade-offs: construir autenticação própria vs. usar provedor — provedor é mais rápido para o MVP. Próximo passo: definir modelo de dados primeiro.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Habilidades Relacionadas