Communitygithub.com

Kit de Decisão

Crie ferramentas estruturadas de apoio à decisão — guias passo a passo, verificadores de viés, exploradores de cenários e painéis interativos. Use ao enfrentar escolhas significativas que exigem análise sistemática. Suporta múltiplos estilos cognitivos e formatos de saída.

O que é Kit de Decisão?

O Kit de Decisão (ASoudy/AGS) é uma skill para assistentes de IA que gera ferramentas interativas de apoio à decisão, ajudando humanos a pensar de forma sistemática sobre escolhas importantes. Em vez de tomar a decisão pela pessoa, a skill capacita o usuário a explorar o espaço de decisão por meio de guias passo a passo, verificadores de viés, calculadoras de custo de oportunidade e matrizes de cenários. Ela foi projetada para ser acessível e cognitivamente inclusiva, suportando estilos analítico, intuitivo, visual, verbal, sequencial e global. A skill pode produzir saídas em HTML interativo (com navegação progressiva por etapas, acessibilidade total e suporte a leitores de tela), Markdown para uso offline, resumo de voz e relatório PDF. Ela é ideal para decisões de colaboração, carreira, investimento, priorização de projetos e seleção de tecnologia, e não deve ser usada para decisões triviais ou emergências. A implementação segue nove etapas — Contexto, Primeiros Princípios, Timing, Partes Interessadas, Vieses, Custo de Oportunidade, Cenários, Perguntas e Síntese — e inclui considerações culturais (individualista, coletivista, distância de poder e tolerância à incerteza).

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/landing-page-mastery/skills/decision-toolkit

Perguntar na sua IA favorita

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

Documentação

O que Kit de Decisão faz?

Visão Geral

Crie materiais estruturados de apoio à decisão que ajudam humanos a pensar sistematicamente sobre escolhas significativas. Esta skill produz ferramentas interativas, não apenas análises — capacitando quem decide, em vez de decidir por ele.

Filosofia

Princípios

  1. Guiar, não decidir — As ferramentas iluminam o espaço de decisão; os humanos escolhem
  2. Uma coisa de cada vez — Reduza a carga cognitiva por meio de revelação progressiva
  3. Múltiplas lentes — A mesma decisão vista por diferentes estruturas revela pontos cegos
  4. Vieses visíveis — Torne os vieses cognitivos explícitos e verificáveis
  5. Resultado acionável — Termine com passos concretos, não conclusões abstratas

Acessibilidade em Primeiro Lugar

  • Suporte a leitores de tela (HTML semântico, rótulos ARIA)
  • Navegável por teclado (ordem de tabulação, estados de foco)
  • Alto contraste por padrão (WCAG AA mínimo)
  • Opção de movimento reduzido
  • Funciona sem JavaScript (degradação graciosa)
  • Alvos de toque compatíveis com dispositivos móveis (mínimo de 44px)

Inclusividade Cognitiva

Pessoas diferentes processam decisões de maneiras diferentes:

EstiloAcomodação
AnalíticoNúmeros, matrizes, pontuações ponderadas
IntuitivoPerguntas de intuição, "como isso faz você se sentir?"
VisualDiagramas, barras de progresso, código de cores
VerbalResumos escritos, perguntas orientadoras
SequencialFluxo passo a passo
GlobalOpção de visão geral em painel

Quando Usar

Invoque esta skill quando o usuário enfrentar:

  • Decisões de colaboração/parceria
  • Mudanças de carreira ou emprego
  • Investimento de tempo/dinheiro significativo
  • Priorização de projetos
  • Seleção de tecnologia/ferramenta
  • Qualquer escolha com múltiplos fatores e incerteza

Não para: Decisões triviais, respostas de emergência ou quando o usuário só precisa de informações.

Tipos de Decisão

Tipo 1: Avaliação de Oportunidade

Devo buscar esta oportunidade?

  • Parceria, oferta de emprego, investimento, projeto

Tipo 2: Alocação de Recursos

Onde devo investir meu tempo/dinheiro/atenção?

  • Priorização, orçamento, áreas de foco

Tipo 3: Avaliação de Risco

O que pode dar errado e vale a pena?

  • Novos empreendimentos, mudanças, experimentos

Tipo 4: Navegação de Trade-offs

Qual opção entre as alternativas?

  • Seleção de ferramenta, decisões de contratação, escolhas estratégicas

A Jornada da Decisão

Nove etapas, cada uma focada em uma dimensão:

┌─────────────────────────────────────────────────────────────┐
│  1. CONTEXTO         Qual é a decisão?                    │
│  2. PRIMEIROS PRINCÍPIOS Isso resolve um problema real?    │
│  3. TIMING          O momento é agora?                    │
│  4. PARTES INTERESSADAS Quem mais está envolvido? São estáveis?│
│  5. VIESES          O que pode nublar meu julgamento?      │
│  6. CUSTO DE OPORTUNIDADE O que estou abrindo mão?        │
│  7. CENÁRIOS        O que pode acontecer?                  │
│  8. PERGUNTAS       O que ainda preciso aprender?          │
│  9. SÍNTESE         Resumo + decisão                       │
└─────────────────────────────────────────────────────────────┘

Formatos de Saída

1. Guia Interativo HTML (Principal)

Assistente passo a passo com:

  • Indicador de progresso
  • Uma pergunta por tela
  • Persistência de estado entre etapas
  • Resumo final agregando todas as entradas
  • Navegação por teclado
  • CSS amigável para impressão

2. Estrutura Markdown

Para uso offline/em texto:

  • Perguntas estruturadas
  • Auditoria de viés estilo lista de verificação
  • Modelos para preencher

3. Resumo de Voz

Para consumo em áudio:

  • Resumo executivo de 5 a 7 parágrafos
  • Marcação TTS Orpheus para textura emocional
  • Decisão principal + fundamentação

4. Relatório PDF

Para documentação/compartilhamento:

  • Formatação profissional
  • Todas as estruturas aplicadas
  • Apêndice com análise bruta

Referência de Estruturas

Teste de Primeiros Princípios

1. Que problema isso resolve?
2. Posso resolvê-lo sozinho?
3. Esta é a melhor solução?
4. Que suposições estou fazendo?
5. Se começasse do zero hoje, escolheria isso?

Lista de Verificação de Vieses

□ FOMO — Estou com medo de ficar de fora?
□ Custo Irrecuperável — Estou considerando investimento passado?
□ Autoridade — Estou delegando a credenciais?
□ Prova Social — Estou seguindo a multidão?
□ Compromisso — Sinto-me preso por declarações passadas?
□ Otimismo — Estou assumindo que os problemas se resolverão?
□ Recência — Estou superponderando eventos recentes?
□ Confirmação — Estou buscando apenas informações validadoras?
□ Objeto Brilhante — A novidade está me distraindo?
□ Aversão à Perda — Estou superponderando perdas potenciais?

Calculadora de Custo de Oportunidade

Horas/semana × Semanas × Taxa horária = Custo direto
+ O que mais essas horas poderiam produzir?
+ Que relacionamentos/oportunidades podem ser prejudicados?
= Custo real de oportunidade

Matriz de Cenários

| Cenário | Probabilidade | Resultado | Valor Esperado |
|---------|---------------|-----------|----------------|
| Pior    | X%            | ...       | ...            |
| Ruim    | X%            | ...       | ...            |
| Neutro  | X%            | ...       | ...            |
| Bom     | X%            | ...       | ...            |
| Melhor  | X%            | ...       | ...            |

Pré-Mortem

Imagine que é [data futura]. Esta decisão falhou. Por quê?

Causas possíveis:
1. ...
2. ...
3. ...

Quais causas estão sob meu controle?
Quais sinais de alerta devo observar?

Estrutura 10-10-10

Como me sentirei sobre esta decisão em:
- 10 minutos?
- 10 meses?
- 10 anos?

Minimização de Arrependimento

Imagine que você tem 80 anos e olha para trás.
Você se arrependeria de ter feito isso?
Você se arrependeria de NÃO ter feito isso?

Guia de Implementação

Etapa 1: Coletar Contexto

Pergunte ao usuário:

  • Qual é a decisão?
  • Quais são as opções?
  • Qual é o cronograma?
  • O que está em jogo?
  • Algum contexto relevante?

Ou extraia de documentos existentes (transcrições de reuniões, anotações).

Etapa 2: Escolher Formato de Saída

Com base na preferência do usuário e no contexto:

  • Decisão complexa + tempo disponível → HTML interativo
  • Análise rápida → Estrutura Markdown
  • Consumo em movimento → Resumo de voz
  • Necessidade de compartilhar com outros → Relatório PDF

Etapa 3: Gerar Ferramenta

Use os modelos no diretório templates/:

  • decision-guide-template.html — Assistente interativo completo
  • decision-framework.md — Análise baseada em texto
  • decision-voice-summary.md — Modelo de script de áudio

Etapa 4: Personalizar

Substitua os placeholders:

  • {{DECISION_TITLE}} — O que está sendo decidido
  • {{CONTEXT}} — Informações de contexto
  • {{OPTIONS}} — Escolhas disponíveis
  • {{STAKEHOLDERS}} — Pessoas/equipes envolvidas
  • {{TIMELINE}} — Datas relevantes
  • {{FACTORS}} — Critérios-chave de avaliação

Etapa 5: Aplicar Marca (Opcional)

Se usar a marca Agency:

  • Importe as variáveis CSS da skill brand-agency
  • Use estilo neobrutalista
  • Aplique tipografia Geist/EB Garamond

Implementação de Acessibilidade

HTML Semântico

<main role="main" aria-label="Guia de Decisão">
  <nav aria-label="Progresso">
    <ol role="list">...</ol>
  </nav>
  <section aria-labelledby="step-title">
    <h1 id="step-title">...</h1>
  </section>
</main>

Navegação por Teclado

// Garanta que todos os elementos interativos sejam focalizáveis
// A ordem de tabulação segue a ordem visual
// Enter/Space ativam botões
// Teclas de seta navegam pelas opções

Anúncios para Leitores de Tela

<div role="status" aria-live="polite" id="announcer">
  <!-- Anuncie mudanças de etapa, seleções, resultados -->
</div>

Contraste de Cores

/* Mínimo 4,5:1 para texto normal, 3:1 para texto grande */
--text-on-light: #000000;  /* 21:1 no branco */
--text-on-dark: #ffffff;   /* 21:1 no preto */
--text-on-primary: #ffffff; /* Verifique cada cor */

Movimento Reduzido

@media (prefers-reduced-motion: reduce) {
  * {
    animation: none !important;
    transition: none !important;
  }
}

Considerações Culturais

Enquadramento Individualista

  • "O que VOCÊ quer?"
  • Metas e valores pessoais
  • Custo de oportunidade individual

Enquadramento Coletivista

  • "Como isso afeta sua equipe/família?"
  • Implicações nos relacionamentos
  • Considerações de harmonia do grupo

Consciência de Distância de Poder

  • Algumas culturas delegam a figuras de autoridade
  • A verificação de viés deve incluir "Estou delegando inapropriadamente?"
  • Inclua perspectivas das partes interessadas explicitamente

Tolerância à Incerteza

  • Alguns preferem análise detalhada de cenários
  • Outros a acham causadora de ansiedade
  • Ofereça visões detalhadas e simplificadas

Exemplos de Invocação

A partir de Transcrição de Reunião

Usuário: Analise esta transcrição de reunião e crie um kit de decisão
Claude: [Extrai decisão, partes interessadas, opções da transcrição]
        [Gera guia interativo HTML]
        [Cria resumo de voz]

Do Zero

Usuário: Preciso decidir se aceito uma nova oferta de emprego
Claude: [Faz perguntas esclarecedoras]
        [Gera estrutura de decisão]
        [Personaliza para tipo de decisão de carreira]

Análise Rápida

Usuário: Ajude-me a pensar sobre esta decisão de parceria, apenas me dê as estruturas
Claude: [Fornece estrutura Markdown]
        [Ignora ferramenta interativa]
        [Foca nas perguntas-chave]

Arquivos

  • SKILL.md — Este arquivo
  • templates/decision-guide-template.html — Modelo de assistente interativo
  • templates/decision-framework.md — Modelo de análise baseada em texto
  • templates/decision-voice-summary.md — Modelo de script de áudio
  • references/bias-encyclopedia.md — Descrições detalhadas de vieses
  • references/framework-deep-dives.md — Explicações estendidas das estruturas

Integração

Funciona bem com:

  • brand-agency — Aplique marca visual
  • transcript-analyzer — Extraia decisões de reuniões
  • pdf-generation — Crie relatórios compartilháveis
  • elevenlabs-tts — Gere resumos de áudio

Aprendizados

2026-01-09

Contexto: Criação inicial da skill a partir da sessão de decisão Synthius

Insight Principal: Painel com tudo de uma vez sobrecarrega. O assistente passo a passo com um conceito por tela melhora drasticamente a usabilidade.

Arquitetura: Jornada de 9 etapas cobrindo todas as principais dimensões de decisão. O objeto de estado persiste as seleções entre as etapas. O resumo agrega tudo.

Nota de Acessibilidade: O neobrutalismo de alto contraste na verdade ajuda na acessibilidade — bordas claras, estados distintos, sem gradientes sutis.

Individual skills in this repo

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

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Habilidades Relacionadas