mk-decks

Sistema de apresentações HTML da metaKosmos — fork do html-ppt com camada de marca mK, skill /deck-mk para Claude Code, e 4 comandos de refino colaborativos.

Setup (uma vez)

git clone https://github.com/davidbenal/mk-decks.git
cd mk-decks
bash setup-deck-mk.sh

O script copia a skill /deck-mk e o comando de entrada para ~/.claude/, que é onde Claude Code procura skills e commands globais.

Os 4 comandos de refino (.claude/commands/deck-mk-*.md) já ficam no repo — Claude Code os detecta automaticamente quando você abre o projeto.

Sketchbook

Abre output/sketchbook-mk-decks.html no browser:

• T — cicla pelas 5 direções de marca mK
• S — abre presenter mode (4 cards: slide atual, próximo, script, timer)
• ←→ — navega slides

Comandos disponíveis

Comando	O que faz
/deck-mk	Gera apresentação HTML standalone a partir de outline
/deck-mk-review	Revisa componentes em status:draft — aprova, ajusta ou deprecia
/deck-mk-tweak [id] [ajuste]	Ajuste cirúrgico em componente existente
/deck-mk-add-component [descrição]	Adiciona componente novo ao catálogo
/deck-mk-lock [id]	Congela componente aprovado

Estrutura

references/deck-mk/
├── html-ppt/               # Fork base (MIT) — não modificar arquivos originais
│   ├── assets/themes/      # 36 temas nativos + 5 temas mK (mk-fashion, mk-3d, mk-institucional, mk-investor, mk-light-editorial)
│   └── templates/
│       ├── single-page/    # 31 layouts nativos + 6 layouts mK custom
│       └── full-decks/     # 15 full-deck templates
├── components.spec.json    # Source of truth — catálogo completo com status/owner/tweaks
└── skill/                  # Skill /deck-mk (copiada para ~/.claude pelo setup-deck-mk.sh)

scripts/
└── build-sketchbook.mjs    # Regenera output/sketchbook-mk-decks.html

output/
└── sketchbook-mk-decks.html  # 50 slides — todos os componentes do catálogo

.claude/commands/
├── deck-mk-review.md
├── deck-mk-tweak.md
├── deck-mk-add-component.md
└── deck-mk-lock.md

5 direções de marca

Direção	Quando usar
mk-fashion	mKFashion+, produto, energia (default)
mk-3d	mK3D, AR/VR, experiências imersivas
mk-institucional	Brand-level, board, apresentações institucionais
mk-investor	Captação, board externo, investidor
mk-light-editorial	B2B sério, casos de cliente, docs

Source of truth

references/deck-mk/components.spec.json — todo refino via /deck-mk-* atualiza esse JSON. Quando a arquitetura Atomic Payload estiver pronta, cada layout mapeia 1:1 para uma Molecule no schema.

Regenerar sketchbook

node scripts/build-sketchbook.mjs