vibework-knowledge › research › 2026-05-artifacts-publisher › poc-skill-design

POC — Skill `artifacts-publisher`

2026-05-17 claude-code vw2-root-cc POC validada

Contexto

Felipe compartilhou print de documentação do repo blessy-knowledge mostrando padrão de artefatos navegáveis: cada estudo gera uma pasta artifacts/ com index.html publicado no GitHub Pages com password gate. Workflow: gera Markdown (raw, edição/IA) + HTML (consumo, visualização) e publica.

Objetivo

Adaptar esse padrão para o VibeworkV2 como skill global reutilizável, com dois modos:

Simple: template básico, rápido, tipografia limpa (esta página é um exemplo)
Full: chama a skill visual-explainer para HTML "fodástico"

Decisões tomadas

Decisão	Escolha
Onde mora	`docs/research/YYYY-MM-tema/artifacts/`
Password gate	Client-side JS hash (SHA-256)
Renderização	Dois modos: `--simple` e `--full`
Repo destino	`vibework-knowledge` (dedicado)
Theme	Snapshot do Maestro via `maestro-cli settings get`
Fonte	JetBrains Mono (web-font Google Fonts)

Arquitetura da skill

~/.claude/skills/artifacts-publisher/
├── SKILL.md                        ← orquestração
├── templates/
│   ├── artifact-readme.md.tpl
│   ├── password-gate.html.tpl
│   ├── simple-page.html.tpl
│   └── theme-snapshot.css.tpl      ← snapshot Maestro
└── scripts/
    ├── publish.sh
    ├── gate.sh
    ├── theme-fetch.sh              ← chama maestro-cli
    └── slugify.sh

Flags propostas

(sem flag) → modo simple (default)
--full → chama visual-explainer
--password <senha> → define senha do gate
--no-gate → publica público
--slug <nome> → override do slug
--no-theme → ignora theme Maestro (cores genéricas)

Pipeline comum

Captura snapshot do theme via maestro-cli settings get customThemeColors
Gera raw.md
Gera index.html (simple ou full) com tokens injetados
Aplica password gate JS
Cria/atualiza artifacts/README.md
Commit + push no repo
Habilita Pages se necessário
Retorna URL final

Theme aplicado

Cores capturadas do seu Maestro em 2026-05-17 06:54:

{
  "bgMain":     "#0c0e0c",   ← background
  "bgSidebar":  "#0f100f",   ← cards, code
  "bgActivity": "#141415",   ← table headers
  "border":     "#111311",
  "textMain":   "#f2f2c0",   ← cream-yellow body
  "textDim":    "#cec8ba",   ← metadata
  "accent":     "#5b675b",   ← military green
  "success":    "#bed78e",   ← status badges
  "warning":    "#d0a795",
  "error":      "#ff5555"    ← senha incorreta
}

Visual: terminal-hacker / fallout-CRT. Texto cream-yellow sobre near-black green-tinted. Monospace JetBrains Mono em tudo. Coerente com a estética do Maestro.

Status

POC manual em execução para validar o fluxo end-to-end antes de codificar a skill. Esta página é o output do teste — agora com theme do Maestro aplicado.

Acesso restrito