convez.ai
SkillEscrita & ConteúdoIntermediário
jacquardlabs

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 GitHub
InicialPluginScore · de 0 a 100

Skill 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/viva

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 1 mês
Versão
v2.22.0
Issues abertas
47
Contribuidores
1

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.

viva review UI

What it does

/viva turns any agent-written markdown document into a structured review session:

  1. Claude parses the doc into sections at its markdown headings — no summarising, the cards show the section content verbatim
  2. A local browser UI opens — one card per section, each with approve / request changes / need info actions
  3. You review; Claude rewrites any sections you flag, then loops
  4. A REVISIONS ledger in the UI tracks every change request and question — your notes verbatim — and is appended to the doc as ## Revision History at sign-off
  5. 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

VerdictWhat happens
approvedSection accepted; shown collapsed (green) in subsequent rounds, reopenable if needed
changesClaude rewrites the section using your note as the instruction
infoClaude answers your question and rewrites the section incorporating that answer
pendingSkipped; 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).

Ver o original no GitHub

Bom para

Relacionados