NOVA Method

CLI editorial para crear una estructura de trabajo de novelas centrada en escritura, revisión y mejora de manuscritos.

Requisitos

• Node.js 18 o superior

Uso

npx @savocan/nova-method@alpha install

También puedes ejecutarlo localmente:

node bin/nova.js help
node bin/nova.js version
node bin/nova.js install
node bin/nova.js import
node bin/nova.js plan
node bin/nova.js index --chapters 22
node bin/nova.js indice --dry-run
node bin/nova.js write next
node bin/nova.js escribir 5 --scaffold
node bin/nova.js review 5
node bin/nova.js review all
node bin/nova.js debate 5 --rewrite
node bin/nova.js debate all
node bin/nova.js moderate 5
node bin/nova.js moderate all
node bin/nova.js rewrite 5
node bin/nova.js rewrite all
node bin/nova.js repair 5
node bin/nova.js repair all
node bin/nova.js final-qa all
node bin/nova.js synopsis all
node bin/nova.js sinopsis all --words 150
node bin/nova.js cover-prompt all
node bin/nova.js portada all --style "sobrio, literario"
node bin/nova.js pdf all
node bin/nova.js final-pdf all --output _nova-output/exports/libro_final.pdf --title "Título" --author "Autor" --synopsis-file _nova-output/exports/sinopsis.md --bio-file _nova/biografia_autor.md
node bin/nova.js analize all
node bin/nova.js analize all --scaffold
node bin/nova.js analize all --quiet
node bin/nova.js apply-rewrite 5
node bin/nova.js agents
node bin/nova.js agent add lector_beta

Guias

• docs/guia-de-uso.md
• CHANGELOG.md

Comandos

• nova install: crea la estructura _nova, _nova-output y manuscrito sin sobrescribir archivos existentes.
• nova import: lee .md, .txt y .docx dentro de manuscrito/, separa por capítulos y respeta los capítulos ya trabajados; si hay .docx dentro de manuscrito/capitulos/, los convierte a .md y los toma como fuente de verdad.
• nova plan: asistente guiado para definir premisa, inicio, final, arco, número de capítulos y objetivos de páginas o palabras; genera brief, biblia, personajes, cronología, índice funcional y plantillas de capítulo.
• nova index / nova indice: genera o actualiza _nova/indice.md como índice funcional ampliado, usando brief, biblia, personajes, cronología, story-config, capítulos existentes y revisiones en _nova/revisiones/. Crea backup antes de sobrescribir y deja un prompt-pack en _nova-output/prompts/. Usa --dry-run, --output o --chapters 22 según necesites.
• nova write <capitulo|next> / nova escribir <capitulo|next>: escribe un capítulo nuevo usando brief, biblia, personajes, cronología, índice, capítulos existentes, informes cercanos y agentes editoriales. La extensión sale de _nova/indice.md o _nova/story-config.yaml salvo que uses --words; el modelo lo decide el CLI detectado salvo que uses --model. Usa --scaffold para generar sólo borrador de trabajo y prompt-pack; si el capítulo ya tiene texto, escribe por defecto en _nova-output/versiones/ salvo que uses --force o --output. También crea una copia sin dobles saltos de línea en manuscrito/formated/.
• nova review <capitulo>: ejecuta una revisión multiagente y rellena el informe. Usa --scaffold para generar solo expediente y prompt-pack.
• nova debate <capitulo>: ejecuta una mesa editorial con rondas, cruce entre agentes y acta de moderación. Usa --scaffold para generar solo plantilla y prompt-pack.
• nova moderate <capitulo>: consolida un review o debate en una decisión editorial ejecutable. Usa --scaffold para generar solo plantilla.
• nova rewrite <capitulo>: ejecuta una reescritura guiada a partir del capítulo y, si existe, de un informe previo. Usa --scaffold para preparar solo los archivos de trabajo.
• nova repair <capitulo> / nova reparar <capitulo>: ejecuta solo una reparación quirúrgica de estilo usando _nova/checklists/reparacion_estilo.md, sin cambios de trama, estructura, cronología ni personajes. Usa --scaffold para preparar solo la versión, checklist y prompt-pack.
• nova review all, nova debate all, nova moderate all y nova rewrite all: ejecutan el mismo flujo sobre todos los capítulos manuscrito/capitulos/capitulo_XX.md.
• nova repair all: ejecuta la reparación de estilo sobre todos los capítulos.
• nova final-qa all: genera una síntesis global de novela, continuidad completa, arco total y QA final transversal. Escribe cada ejecución en una carpeta independiente bajo _nova-output/transversal/<timestamp>/.
• nova synopsis all / nova sinopsis all: genera una sinopsis breve del libro, de alrededor de 150 palabras por defecto, con bajo nivel de spoilers y sin contar demasiado argumento. Usa --words 150 para ajustar la longitud aproximada.
• nova cover-prompt all / nova portada all: genera una descripción/prompt listo para pedir a ChatGPT una portada del libro, con composición visual, tono, paleta, símbolos y bajo nivel de spoilers. Usa --style y --audience para orientar el resultado.
• nova pdf all / nova final-pdf all: genera el PDF final del libro en A5, márgenes de 1,5 cm, fuente serif, páginas iniciales con título, autor, sinopsis, biografía e índice de capítulos, capítulos en página impar y numeración inferior centrada. Busca esos datos en archivos existentes y, si faltan, los pide en modo interactivo. El PDF no añade marcas ni referencias a NOVA Method.
• nova analize all: ejecuta el proceso completo sobre todo el libro: revisión, debate, moderación, reescritura y QA final transversal. NOVA detecta automáticamente desde qué CLI se invoca (OpenCode, Codex, Gemini o Claude) y usa ese mismo agente para ejecutar los prompts, sin necesidad de configuración ni API keys externas. Usa --scaffold para generar solo expedientes y prompt-packs, o --quiet para no imprimir el contenido. También existe el alias nova analyze all.
• nova apply-rewrite <capitulo>: aplica una versión reescrita al manuscrito dejando backup automático.
• nova agents: lista los agentes disponibles en _nova/agents/.
• nova agent add <nombre>: crea un agente nuevo a partir de una plantilla base.
• nova version: muestra la versión actual.
• nova help: muestra la ayuda.

Estructura creada

_nova/
_nova/brief.md
_nova/biblia.md
_nova/personajes.md
_nova/cronologia.md
_nova/indice.md
_nova/agents/
_nova/revisiones/
_nova/templates/
_nova/workflows/
_nova/checklists/
_nova/checklists/reparacion_estilo.md
_nova-output/
_nova-output/informes/
_nova-output/prompts/
_nova-output/versiones/
_nova-output/exports/
_nova-output/transversal/
manuscrito/
manuscrito/capitulos/
manuscrito/formated/

Alpha 0.1.0-alpha.4

Esta alpha instala:

• configuración inicial en _nova/config.yaml
• configuración narrativa en _nova/story-config.yaml
• seguimiento de estado en _nova/workflow-status.md
• agentes editoriales base y especializados por defecto
• workflow de revisión de capítulo
• checklist editable de reparación de estilo en _nova/checklists/reparacion_estilo.md
• archivos base de brief, biblia, personajes, cronología e índice
• manuscrito/capitulos/capitulo_01.md si aún no existe
• nova import para importar .md, .txt y .docx
• nova plan para planificar la novela de forma guiada
• nova index / nova indice para crear un índice funcional ampliado
• nova write / nova escribir para escribir capítulos nuevos desde el contexto completo
• nova review, nova debate, nova rewrite y nova repair para orquestar revisión, reescritura y reparación de estilo
• nova agents y nova agent add para gestionar agentes
• conversión de capítulos Word existentes a Markdown
• guía de trabajo en docs/

Agentes instalados por defecto

Convención:

• id: nombre técnico estable del archivo y del comando

• nombre: nombre visible del agente dentro del Markdown

• qa_editorial (John QA)

• continuidad (Carmen Continuidad)

• ritmo (Will Ritmo)

• estilo (Paula Estilo)

• editor_personajes (Stanley Personajes)

• arquitecto_narrativo (GugHeim Arquitecto)

• worldbuilding (Asimov Worldbuilding)

• dialogo (Fluffy Dialogo)

• escenas (Cate Escenas)

• tension (Neo Tensión)

• cronologia_forense (Booth Cronologia)

• tema (Phillipa Tema)

• lector_beta (Paquito LectorA)

• line_editor (Jonah Editor)

Los agentes estilo y line_editor, y el cierre de qa_editorial, usan también _nova/checklists/reparacion_estilo.md cuando los prompt-packs incluyen reparación de estilo. Ese archivo es editable por proyecto.

Licencia

MIT