# Decision Memo Generator

> 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.

- **Type:** Skill
- **Install:** `agentstack add skill-trycomp-io-comp-skills-decision-memo-generator`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [trycomp-io](https://agentstack.voostack.com/s/trycomp-io)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [trycomp-io](https://github.com/trycomp-io)
- **Source:** https://github.com/trycomp-io/comp-skills/tree/main/skills/decision-memo-generator

## Install

```sh
agentstack add skill-trycomp-io-comp-skills-decision-memo-generator
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:
```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:
```bash
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 |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [trycomp-io](https://github.com/trycomp-io)
- **Source:** [trycomp-io/comp-skills](https://github.com/trycomp-io/comp-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-trycomp-io-comp-skills-decision-memo-generator
- Seller: https://agentstack.voostack.com/s/trycomp-io
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.