IB Deck Engine — Plugin de Geração de Slides para Investment Banking
gorajing/ib-deck-plugin
Templates de IB com renderização determinística: JSON → slides pixel-perfect
Ver no GitHubPlugin Claude Code que gera slides determinísticos de investment banking a partir de especificações JSON, com biblioteca de 12 templates pré-construídos. Separa raciocínio de conteúdo (força do LLM) de renderização espacial (força de código determinístico), garantindo alinhamento, proporções e sem colisões de labels por construção.
Instalação
npx convez-ai gorajing/ib-deck-plugin1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Geração automática de pitch decks de M&A com dados financeiros estruturados
- Construção de tabelas de comparáveis, football fields e análises de sensibilidade
- Extração de dados de 10-K e normalização em schema canônico para slides auditáveis
Veredito

Solução técnica robusta que inverte o problema convencional: em vez de treinar LLM em renderização, centraliza a lógica visual em código determinístico e deixa o modelo fazer o que sabe fazer bem (raciocínio sobre dados). Prototipo maduro (v0.1) com proposta clara de primitivos de proveniência e auditoria para slides financeiros gerados por IA, ainda em consolidação para produção.
README
A tradução para o português deste README ainda está na fila.
IB Deck Engine — Claude Code Plugin
A Claude Code plugin with a 12-template investment banking slide library built on a renderer-first architecture, plus a proposal for a canonical JSON schema and audit contract for AI-generated finance slides.
The core idea: separate content reasoning (LLM's strength) from spatial rendering (deterministic code's strength). The LLM never writes Inches(), Pt(), or EMU values. It picks a template and passes data. The renderer guarantees right-alignment, proportional chart bars, and collision-free label placement by construction.
This repo serves two purposes:
- an installable Claude Code plugin for deterministic slide rendering
- a reviewable proposal for canonical slide-spec, provenance, exception, and audit primitives
The plugin is an alternative architecture worth considering alongside anthropics/financial-services-plugins. The proposal is the higher-level ask: are these primitives the right shape for Claude for Excel / PowerPoint to absorb internally, or are they the wrong shape?
Status
Version 0.1.0 — early prototype. What's shipped today is the 12-template rendering library and slash-command workflows that guide Claude through filling the JSON specs. It's installable and runnable. Extraction, model import, and auditing are proposed workflow primitives in this repo, not implemented end-to-end commands yet.
Start Here
If you're reviewing this repo cold, use whichever entry point matches your depth:
comparison/— empirical artifact: renderer-first vs prompt-guided slide generation on one fixed taskdocs/v0.2-scope.md— proposal: canonical schema, provenance, exceptions, and audit loopdocs/schemas/— formal JSON Schemas for the proposal- Everything below — the current installable plugin and 12-template renderer
Installation
claude plugin marketplace add gorajing/ib-deck-plugin
claude plugin install ib-deck-engine@ib-deck-plugin
Or install directly:
git clone https://github.com/gorajing/ib-deck-plugin ~/.claude/plugins/local/ib-deck-plugin
Verify installation:
claude plugin list | grep ib-deck
Available commands
Each command loads the ib-deck-engine skill, which walks Claude through picking the right template, filling a JSON spec from your data, and calling the renderer. The commands are workflow guides — not autonomous pipelines.
| Command | Purpose |
|---|---|
/ib-deck [TICKER] | Walk through building a complete IB pitch deck (orchestrates multiple templates) |
/ib-extract [TICKER] | Guided workflow: extract 10-K data into the master JSON schema the templates expect |
/ib-financial [COMPANY] | Build a single financial summary table slide |
/ib-football [COMPANY] | Build a football field valuation summary slide |
/ib-comps [TARGET] | Build a trading comparables peer multiples table |
/ib-sources-uses [DEAL] | Build an LBO Sources & Uses table |
/ib-sensitivity [COMPANY] | Build a DCF sensitivity grid (WACC × TGR) |
Quick start
After installing the plugin and restarting Claude Code:
/ib-financial ADUS
Claude will load the skill, ask for the historical financials (or pull them from a JSON you provide), fill out the render_financial_summary JSON spec, and call the renderer. The output is a single PPTX slide with right-aligned numerics, bold subtotals, italic gray % rows, and a navy section header — rendered by deterministic Python code, not by the model guessing coordinates.
The 12 templates
| # | Template | Pattern | Reference |
|---|---|---|---|
| 1 | render_cover | Cover with confidential mark + bank badge | GS board presentation format |
| 2 | render_section_divider | Full navy background with section title | GS / Moelis style |
| 3 | render_toc | Numbered agenda with light blue bands | GS agenda slides |
| 4 | render_exec_summary | Blue callout + ■ / — bullet hierarchy | GS executive summary |
| 5 | render_investment_highlights | 4-card 2×2 grid with numbered headers | GS highlights format |
| 6 | render_financial_summary | Historical P&L with bold subtotals | Standard IB financials |
| 7 | render_stacked_bar_table | Stacked bars + data table below | Moelis revenue by segment |
| 8 | render_dual_chart | Two bar charts side by side with CAGR | GS dual analysis |
| 9 | render_football_field | Valuation methodologies with range bars | Evercore / Moelis valuation |
| 10 | render_sensitivity | WACC × TGR grid with base case highlight | Standard DCF sensitivity |
| 11 | render_sources_uses | LBO capital structure (two-column) | Standard LBO |
| 12 | render_trading_comps | Peer multiples with target highlighted | Standard comps table |
See skills/ib-deck-engine/reference/template-catalog.md for the full pattern catalog.
Architecture
┌─────────────────────────────────────┐
│ CONTENT REASONING (Claude) │
│ │
│ - Pick the right template │
│ - Write the action title │
│ - Select the data │
│ - Cite the source │
└────────────────┬────────────────────┘
│
│ Output: structured JSON spec
│
▼
┌─────────────────────────────────────┐
│ JSON SPEC │
│ { │
│ "title": "...", │
│ "headers": [...], │
│ "rows": [...] │
│ } │
└────────────────┬────────────────────┘
│
│ Pure data, no coordinates
│
▼
┌─────────────────────────────────────┐
│ DETERMINISTIC RENDERER │
│ - Right-alignment of numeric cells │
│ - Bar heights computed from data │
│ - Real PPT table objects │
│ - Layout rules enforced in code │
└────────────────┬────────────────────┘
│
▼
output.pptx
The LLM never writes Inches(), Pt(), RGBColor(), or pixel coordinates. Layout rules live in the renderer functions, enforced by code.
This is the same pattern used by Beautiful.ai, Gamma, and UpSlide: layout is a function of data, not a prompt-time decision.
Tests
Determinism is the core promise of the architecture, so every template has a test that verifies it:
python -m pytest tests/ -v
13 tests pass:
- 12 per-template determinism tests (each template rendered twice, normalized content hashes compared)
- 1 stability test (
render_financial_summaryrendered 10 times, all 10 content hashes identical)
The tests use a normalized PPTX hash that strips volatile ZIP metadata (creation timestamps, last-modified fields) before hashing, so only the parts of the output that affect appearance are compared.
This is the evidence trail for the "fixed input, repeated renders, identical output" claim. If any of those tests fail, the architecture's core promise is broken.
Proposal Direction
The current plugin is the reference implementation. The forward-looking proposal in
docs/v0.2-scope.md is narrower and more useful than "full
autonomous deck generation":
- a canonical core of 5 IB slide primitives
- workbook provenance and import mapping
- durable reviewed exceptions
- machine-readable audit reports
The goal is not "replace Claude for PowerPoint" or "mutate working decks in place." The goal is to propose a deterministic layer that can sit inside the existing analyst workflow: Excel -> canonical JSON spec -> standalone slide -> audit.
What this architecture optimizes for
Repeatability. Same input → same output. The renderer doesn't depend on what the LLM felt like typing in any particular run.
Evaluability. "Did the LLM pick the right template and fill the right data?" is a simpler test than "did the LLM write correct python-pptx code for this specific slide?"
Maintainability. New templates are code, not prompts. They can be reviewed, versioned, and tested.
Lower failure surface. Every pixel decision the LLM doesn't make is a pixel decision that can't be wrong.
What this plugin does not do (yet)
Being honest about the scope of v0.1.0:
- No end-to-end Excel import command.
/ib-extractis still a guided workflow; the proposedimport_config.json/ provenance flow lives indocs/v0.2-scope.md, not in shipped commands yet. - No workbook-to-slide audit command. The handshake files and
audit_report.jsoncontract are specified indocs/schemas/, but/ib-auditis not implemented in this repo today. - No mutation of working decks in place. The renderer produces standalone
.pptxoutput. That is intentional for the current workflow and proposal. - No Office JS / in-PowerPoint implementation. The renderer is python-pptx and runs out-of-app.
- Only 12 template types in the current plugin. The canonical proposal focuses on a 5-template core; broader coverage remains future work.
Earlier roadmap notes have been superseded by the proposal in
docs/v0.2-scope.md, which is the reviewable statement of
direction for this repo.
Companion repo
The standalone Python library (without the plugin packaging) and the complete ADUS case study artifacts live at gorajing/ib-deck-engine. That repo includes the DCF model (401 formulas), LBO model (244 formulas), master JSON extraction example, and a 14-slide rendered ADUS deck.
Disclaimer
This is a learning project and early prototype. Models in the companion case study are simplified. Example numbers are illustrative. Always verify financial data against primary sources before relying on it for any investment decision.
License
MIT — see LICENSE.