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

node bin/nova.js 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 format-check all
node bin/nova.js docx all --output _nova-output/exports/libro_final.docx
node bin/nova.js epub all --output _nova-output/exports/libro_final.epub
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
node bin/nova.js repo create "Mi novela"
node bin/nova.js repo ensure
node bin/nova.js update

Guias

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

Comandos

• nova install: crea la estructura _nova, _nova-output y manuscrito sin sobrescribir archivos existentes. Con nova install --migrate añade de forma no destructiva campos, estados y guías que falten y elimina las antiguas reglas de Nova que ignoraban manuscrito/ u otras carpetas de contenido del proyecto.
• 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 repo create [nombre] / nova repo ensure [nombre]: crea, o comprueba si ya existe, un repositorio privado BooksInc/<nombre-normalizado> en OwnGit. Si no se indica nombre, usa project.title de _nova/config.yaml. nova plan lo ejecuta automáticamente al terminar el plan.
• nova update / nova actualizar: comprueba y descarga los últimos cambios de la instalación de NOVA desde su origin Git mediante fast-forward; nova update --check solo informa si hay actualizaciones. Se detiene si la instalación tiene cambios locales y prepara dentro de esa misma instalación .nova-credentials para BooksInc cuando todavía no existe.
• 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 con párrafos conservados en manuscrito/formated/.
• El agente pov_capitulo (Ariadna POV por capítulo) se incluye por defecto en escritura, revisión, debate y QA final. Salvo una excepción explícita y localizada en el canon del proyecto, exige un único POV para todo el capítulo; una autorización general de varios narradores para la novela no basta.
• 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 format-check <capitulo|all> / nova format-qa / nova preflight: ejecuta la skill de formato al cerrar el QA, detecta cursiva, negrita, combinaciones y casos especiales, y deja Markdown preparado, manifiesto JSON e informe por capítulo. Los errores de marcado bloquean las exportaciones finales.
• nova docx all / nova final-docx all: ejecuta el preflight y genera un DOCX final desde _nova-output/exports/markdown/. Admite --template para reutilizar un modelo DOCX y toma la sinopsis, biografía, dedicatoria, edición e índice de los Markdown locales del proyecto.
• nova epub all / nova final-epub all: ejecuta el preflight y genera un EPUB 3 final desde el Markdown preparado, preservando <em>, <strong>, código inline, enlaces, citas, listas y separadores de escena. Busca automáticamente la portada en PNG/JPG/JPEG, priorizando nombres con portada o cover.

La revisión de continuidad de cada capítulo sigue un protocolo canónico: lee primero _nova/workflow-status.md, después el brief, la biblia, personajes, cronología e índice, luego el capítulo objetivo y finalmente los capítulos anteriores íntegros de manuscrito/capitulos/. El agente marca como nuevo no establecido cualquier dato que no tenga respaldo en esa planificación o en el manuscrito canónico. Sus informes incluyen tabla de hallazgos, gravedad, ubicación, evidencia, clasificación, riesgo, corrección mínima, correcciones imprescindibles y opcionales, comprobación final y veredicto APTO, APTO CON CAMBIOS o NO APTO.

La checklist _nova/checklists/revision_profesional.md añade diez comprobaciones: idea transformada y relevante, núcleo explicable en dos frases, apertura con función, tono consistente, personajes profundos, control de adjetivos/adverbios y puntos suspensivos, exposición dramatizada, identidad frente a modas, ortotipografía y pacto con el lector. Cada punto exige ubicación, evidencia, gravedad, acción mínima y estado. No convierte una convención de género, una voz experimental o una errata aislada en fallo automático. NOVA siempre incorpora la base completa de estas diez reglas; si un proyecto antiguo tiene una checklist ausente o personalizada, usa la base integrada y añade los ajustes locales sin permitir que desaparezca silenciosamente ningún control.

La integración puede comprobarse de forma aislada con node tests/rules-integration.mjs. La prueba crea un proyecto temporal y valida índice, escritura, revisión, debate, reescritura, reparación, moderación, QA final, sinopsis, portada y compatibilidad con checklists antiguas.

La checklist de integridad narrativa evita dos fallos de lectura frecuentes: cambios de narrador o hablante difíciles de seguir y finales que funcionan solo como gancho de saga. NOVA exige un contrato de POV, un único POV por escena y la identificación del nuevo narrador desde el primer párrafo mediante la propia narración (voz, acción concreta, percepción del entorno y circunstancias), tanto dentro del capítulo como entre capítulos. El separador gráfico solo marca el corte y nunca sustituye la transición; no se admiten rótulos de POV ni presentaciones artificiales, y hablar no equivale a narrar. La comprobación decisiva es la prueba sin separador: sin el marcador, el primer párrafo debe seguir dejando claro quién narra y cuál es su situación. También exige atribución reforzada en conversaciones con tres o más voces y un cierre de volumen con agencia causal del protagonista, coste, pago local, desenlace y nuevo equilibrio. Una revelación o una retirada voluntaria del antagonista no se considera resolución por sí sola.

La checklist de legibilidad del mundo obliga a presentar los términos propios cuando empiezan a importar: categoría, rasgo perceptible o regla biológica y una consecuencia comprensible. Para instituciones exige además aclarar qué son, qué autoridad o recurso controlan y cómo se traduce ese poder en acciones, sin confundir el interés institucional con la motivación de cada miembro. No obliga a llamar «elfo» o «enano» a los pueblos originales; exige que el lector pueda imaginarlos y entender escalas ajenas —como una vida de mil años— sin consultar la biblia del proyecto.

• 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: ejecuta también el preflight de formato y 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.
• Para la integración OwnGit define NOVA_OWNGIT_TOKEN con un token que pueda crear repositorios en BooksInc, o guárdalo en .nova-credentials dentro de la instalación de NOVA para que lo resuelva localmente. Puedes cambiar el servidor con NOVA_OWNGIT_URL y la organización con NOVA_OWNGIT_ORGANIZATION; el token nunca se guarda en los archivos del libro.
• 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/skills/
_nova/skills/formato_exportacion.md
_nova-output/
_nova-output/informes/
_nova-output/prompts/
_nova-output/versiones/
_nova-output/exports/
_nova-output/exports/markdown/
_nova-output/transversal/
manuscrito/
manuscrito/capitulos/
manuscrito/formated/

Alpha 0.1.0-alpha.34

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
• checklist editable de integridad narrativa en _nova/checklists/integridad_narrativa.md
• checklist editable de legibilidad del mundo en _nova/checklists/legibilidad_mundo.md
• checklist editable de revisión profesional en _nova/checklists/revision_profesional.md
• skill editable de preflight de formato en _nova/skills/formato_exportacion.md
• exportación final desde Markdown local para sinopsis, biografía, dedicatoria, edición, índice y portada PNG/JPG/JPEG
• 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
• preflight automático al terminar el QA de cada capítulo y exportación final DOCX/EPUB desde Markdown preparado
• 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)

• pov_capitulo (Ariadna POV por capítulo)

• 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

Las versiones 0.1.0-alpha.32 y posteriores se distribuyen bajo la NOVA Method Commercial Proprietary License. La copia del proyecto no concede por sí sola una licencia de producción o uso comercial; ese uso requiere un acuerdo comercial válido con el titular de los derechos.

Las versiones anteriores a 0.1.0-alpha.32 fueron publicadas bajo MIT y conservan los permisos de esa licencia. La licencia propietaria no revoca los derechos concedidos por esas versiones.