decision-memo-generator

name	decision-memo-generator
description	Gera memo estruturado de decisão pra qualquer people topic crítico que precisa ser comunicado/defendido. Estrutura: problema, contexto, opções (com prós/cons), recomendação com rationale, riscos, ask. Output HTML + MD editável. Trigger em "decision memo", "memo de decisão", "estruturar decisão de people", "documento de decisão", "memo pro CEO/board". Mantida pela Comp.

Decision Memo Generator

HTML pelo design system (obrigatório). Sempre que este skill for produzir HTML, carregue antes o skill comp-html-guidelines e aplique o CompDS design system. Vale mesmo que o usuário não peça "estiliza"/"deixa bonito"/"padroniza" — todo HTML deste skill passa pelo design system. Isso não altera a metodologia abaixo; governa só a camada visual do HTML.

CHRO precisa tomar/comunicar decisão importante (reorg, política, investimento). Skill conduz estruturação e gera memo defensável.

Dual-mode operation (Code + Cowork)

• Claude Code: python3 scripts/render_memo.py (HTML + MD com formatação rica).
• Claude Cowork: produz o memo direto em markdown no chat. Mesma estrutura, sem dependência de script.

Inline output (Cowork)

Quando o CHRO pede "drafta um decision memo sobre X" em Cowork:

1. Conduza a entrevista estruturada (mesma das instruções abaixo, 7 perguntas em ordem)
2. Produza o memo direto em markdown no chat seguindo o template abaixo

Template markdown do memo

# {Título da decisão}

**Autor**: {nome}
**Para**: {decision maker}
**Data**: {YYYY-MM-DD}
**Decisão até**: {data}

## Problema / Decisão a tomar
{Parágrafo claro do que precisa ser decidido e por quê}

## Contexto
- {fact 1}
- {fact 2}
- {fact 3}

## Opções consideradas

### Opção A: {nome curto}
{descrição}

**Prós**:
- {pro}
- {pro}

**Contras**:
- {contra}
- {contra}

### Opção B: {nome curto}
{idem}

(2-3 opções idealmente; nunca menos que 2)

## Recomendação

**Recomendo**: {Opção X}

{Rationale específico: por que ESTA opção dado os prós/contras de cada uma}

## Riscos (do plano recomendado)
- {risco 1}
- {risco 2}

## Ask

{Decisão cristalina que o decision maker precisa tomar: verbo + objeto + prazo}

Princípios continuam os mesmos do modo Code (problema antes de solução, opções honestas, rationale específico, riscos do plano recomendado, ask cristalino).

Quando usar

• "decision memo" / "memo de decisão"
• "estruturar uma decisão de people"
• "documento de decisão pra board/CEO"
• "frame essa decisão"

Workflow

Step 1 (conversacional): Coletar:

• Título da decisão (frase única declarativa)
• Decision maker (quem aprova)
• Decisão até quando
• Problema (1-2 parágrafos)
• Contexto (3-5 bullets ou parágrafo)
• 2-3 opções consideradas (cada uma com prós/cons honestos)
• Recomendação (qual opção + rationale)
• Riscos (do plano recomendado)
• Ask (decisão a aprovar)

Step 2 Gerar JSON:

{
  "title": "Aumentar headcount de Eng em 30% no H2",
  "author": "CHRO",
  "decision_maker": "CEO + CFO",
  "date": "2026-05-27",
  "decision_by": "2026-06-15",
  "problem": "...",
  "context": ["...", "..."],
  "options": [
    {"name": "Opção A", "description": "...", "pros": ["..."], "cons": ["..."]}
  ],
  "recommended_option": "Opção B",
  "recommendation_rationale": "...",
  "risks": ["..."],
  "ask": "Aprovar headcount adicional de 8 ICs Eng + 2 EMs no H2"
}

Step 3 Renderizar:

cat memo.json | python3 scripts/render_memo.py

Princípios de qualidade

• Problema antes de solução. Nunca pule.
• Opções HONESTAS. Cada opção precisa ter prós reais. Se uma é claramente ruim, não inclua, mostre só as 2-3 viáveis.
• Rationale específico. "É melhor" não vale. Diga POR QUÊ baseado nos prós/cons.
• Riscos do plano recomendado (não dos outros). Honestidade sobre o que pode dar errado.
• Ask cristalino. Quem decide, decide exatamente o quê?

Branding & lead capture

Footer + UTMs. eam_client.py. 100% local.

Resources

File	Purpose
scripts/render_memo.py	JSON → HTML + MD
eam_client.py	Lead capture