Viva — Revisão Estruturada de Markdown
jacquardlabs/viva
Revisão colaborativa de markdown com histórico e aprovação seção a seção
Ver no GitHubSkill para Claude Code que transforma documentos markdown em sessões de revisão seção-por-seção, com interface interativa em browser. Você aprova, solicita mudanças ou pede esclarecimentos; Claude reescreve e o ciclo continua até aprovação total. Mantém histórico completo de revisões no documento.
Instalação
npx convez-ai jacquardlabs/viva1 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
- Validar especificações técnicas geradas por agentes IA
- Revisar documentação e guias antes de publicação
- Conduzir ciclos iterativos de melhoria de conteúdo com rastreamento de mudanças
Veredito

Ferramenta bem arquitetada para fluxo de revisão colaborativa entre humano e IA. Adequada para quem precisa validar documentos gerados automaticamente com controle fino e auditoria completa; requer Python 3.11+ e integração com Claude Code.
README
A tradução para o português deste README ainda está na fila.
viva
Section-by-section markdown review for Claude Code. Named after the PhD oral exam — Claude presents its work, you drill every section for correctness and full understanding, Claude defends and revises, and the document only passes when it all holds up.

What it does
/viva turns any agent-written markdown document into a structured review session:
- Claude parses the doc into sections at its markdown headings — no summarising, the cards show the section content verbatim
- A local browser UI opens — one card per section, each with approve / request changes / need info actions
- You review; Claude rewrites any sections you flag, then loops
- A REVISIONS ledger in the UI tracks every change request and question — your notes verbatim — and is appended to the doc as
## Revision Historyat sign-off - The session ends when every section is approved
One browser tab stays open for the entire session. After you submit a round, a spinner appears while Claude rewrites; the next round loads in place without a page reload.
Installation
claude install github:jacquardlabs/viva
Requires Python 3.11+ and Claude Code.
Or install manually via git clone:
git clone https://github.com/jacquardlabs/viva ~/.claude/skills/viva
Usage
In Claude Code:
/viva path/to/file.md
If no path is given, Claude scans the current directory for a single .md file.
Brainstorming integration
viva adds a batch Q&A phase to the built-in brainstorming skill so Claude can surface key design questions before writing a spec. Run once in your Claude Code prompt to install:
! bash "$(find ~/.claude/skills/viva ~/.claude/plugins/cache -name install.sh -path "*/viva*" 2>/dev/null | head -1)"
Re-run after any superpowers plugin update.
Verdicts
| Verdict | What happens |
|---|---|
approved | Section accepted; shown collapsed (green) in subsequent rounds, reopenable if needed |
changes | Claude rewrites the section using your note as the instruction |
info | Claude answers your question and rewrites the section incorporating that answer |
pending | Skipped; re-presented unchanged next round |
How it works
The server is a single Python file with no dependencies beyond stdlib. Claude Code is the agent — no API key required. Claude launches the server as a background subprocess, polls for the output JSON, and calls HTTP endpoints to signal between rounds.
.viva/
├── server.url ← server writes on startup; deleted on shutdown
├── review-input-r1.json ← agent writes before each round
├── review-r1.json ← server writes after user submits
└── ...
Server CLI (advanced)
# Review mode
python3 ~/.claude/skills/viva/server.py \
--mode review \
--input .viva/review-input-r1.json \
--output .viva/review-r1.json
# Q&A mode (brainstorming integration)
python3 ~/.claude/skills/viva/server.py \
--mode qa \
--input .viva/qa-input.json \
--output .viva/answers.json
Add --no-browser to skip opening a browser tab (useful for testing).