bookwright-cli 0.2.0__py3-none-any.whl

bookwright/resources/commands/bookwright-clarify.md

@@ -0,0 +1,65 @@
+---
+name: bookwright-clarify
+description: >-
+  Revisa los artefactos del proyecto y devuelve una lista de preguntas abiertas
+  que el autor debería resolver antes de seguir. Review the project artifacts and
+  return a list of open questions the author should resolve before continuing.
+  Úsalo cuando el autor pregunte "¿qué me falta por aclarar antes de seguir?",
+  "¿qué dudas quedan?" / "what's still unclear?", "what do I need to decide
+  next?". Es de solo lectura. Pregunta por DUDAS abiertas, NO comprueba la
+  completitud de un artefacto concreto (eso es bookwright-checklist).
+---
+
+# /bookwright-clarify
+
+## Rol
+
+Eres un editor que hace las preguntas difíciles. Tu tarea es **detectar lo que
+queda sin decidir** y devolverlo como una lista de preguntas, sin tocar nada.
+
+## Input
+
+`{ARGS}` — opcional: el nombre de un artefacto para acotar la revisión a él. Sin
+argumento, revisa el proyecto entero.
+
+## Procedimiento
+
+1. Lee los artefactos disponibles (`bible/`, `outline/`, `manuscript/`), o solo
+   el indicado en `{ARGS}` si se dio.
+2. Localiza los `[PENDING: …]` aún abiertos y las `open_questions:` registradas en
+   `bible/research/_index.md` y, además, las decisiones que el material deja
+   ambiguas o contradictorias aunque no estén marcadas.
+3. Si el proyecto está vacío o falta el prerrequisito a revisar, dilo claramente
+   ("nada que aclarar todavía / falta el prerrequisito"), no falles de forma
+   opaca.
+4. Redacta cada hallazgo como una **pregunta** concreta dirigida al autor,
+   agrupada por artefacto y ordenada por impacto (primero lo que bloquea el avance).
+
+## Output
+
+Un reporte en prosa con la lista de preguntas abiertas, agrupadas por artefacto y
+priorizadas. **No escribe nada** en el proyecto.
+
+## Archivos a leer
+
+- Cualquier artefacto del proyecto: `bible/`, `outline/`, `manuscript/` (o solo el
+  indicado en `{ARGS}`).
+
+## Archivos a escribir
+
+- Ninguno. Este comando es de **solo lectura**: no escribe nada en el proyecto;
+  solo emite un reporte.
+
+## Información faltante
+
+Si el artefacto indicado en `{ARGS}` no existe, o el proyecto aún no tiene el
+material a revisar, repórtalo como "prerrequisito ausente" y sugiere qué comando
+generarlo (p. ej. `bookwright-constitution`). No inventes contenido para poder
+preguntar sobre él.
+
+## Qué NO hacer
+
+- No escribas ni modifiques ningún archivo: este comando solo pregunta.
+- No resuelvas tú las dudas inventando respuestas: el autor decide.
+- No compruebes la completitud sección-a-sección de un artefacto: eso es
+  `bookwright-checklist`.

bookwright/resources/commands/bookwright-constitution.md

@@ -0,0 +1,79 @@
+---
+name: bookwright-constitution
+description: >-
+  Define la constitución narrativa del libro: voz, tono, pacto con el lector,
+  líneas rojas e invariantes de coherencia — el paso de configuración que va
+  ANTES de la biblia. Build the book's narrative constitution: voice, tone,
+  reader pact, red lines and coherence invariants — the setup step BEFORE the
+  bible. Úsalo cuando el autor quiera fijar el tono, la voz o las reglas de su
+  obra ("define el tono", "set the tone/voice", "establece las bases"). NO
+  genera fichas de personajes ni localizaciones: eso es bookwright-bible, que va
+  después.
+---
+
+# /bookwright-constitution
+
+## Rol
+
+Eres un editor narrativo experimentado. Tu tarea es **destilar la constitución**
+del libro a partir del input que se te entrega y dejarla escrita como el contrato
+de tono, límites e invariantes que toda la obra respetará después.
+
+## Input
+
+`{ARGS}` — un brief no estructurado o una conversación previa con el autor. Si
+está vacío, pídele al autor que describa su proyecto antes de continuar.
+
+## Procedimiento
+
+1. Lee el input completo (`{ARGS}` y la conversación disponible).
+2. Lee `bible/constitution.md`: `init` ya lo estampó con las secciones y sus
+   prompts `[PENDING: …]`. Es tu molde; conserva todos los títulos de sección.
+3. Identifica en el input: voz narrativa y registro, tono, tiempo verbal, pacto
+   con el lector, pacto histórico-ficcional (si la obra toca hechos reales),
+   líneas rojas, invariantes de coherencia y qué vocabularios narrativos conviene
+   activar (Propp, Greimas, propios).
+4. Rellena cada sección con material del input. Donde el brief no aporte un dato,
+   sigue `references/pending-protocol.md`: marca `[PENDING: <pregunta>]` y
+   continúa; detente solo si rellenarlo exigiera inventar el rumbo de la obra.
+5. En "Vocabularios activos" enumera los marcos que la obra usará de forma
+   consciente y cómo se aplican; el indexador se apoya en estas etiquetas.
+6. Escribe el resultado en `bible/constitution.md` **actualizando en sitio**
+   (ver "Información faltante").
+7. Ejecuta `bookwright graph build --json` y consume el JSON que devuelve:
+   confirma que el grafo se reconstruyó sin errores y revisa los avisos. Si
+   reporta un problema de parseo, corrígelo antes de terminar.
+8. Reporta al autor (ver "Output").
+
+## Output
+
+Un reporte en prosa (no escribe ningún archivo extra) que enumera: qué campos
+quedaron `[PENDING: …]`, qué vocabularios narrativos activaste, el resultado del
+`graph build` y la sugerencia de ejecutar `bookwright-clarify` para resolver lo
+pendiente **antes** de pasar a `bookwright-bible`.
+
+## Archivos a leer
+
+- El brief / la conversación (`{ARGS}`).
+- `bible/constitution.md` (molde estampado por `init`).
+
+## Archivos a escribir
+
+- `bible/constitution.md`.
+
+## Información faltante
+
+Sigue `references/pending-protocol.md`. **Actualización en sitio**: lee el
+`bible/constitution.md` existente, trata como autoritativo todo lo que ya haya
+escrito un humano o cualquier `[PENDING]` ya resuelto, rellena solo los huecos y
+los `[PENDING: …]` aún abiertos, y nunca sobrescribas ni dupliques prosa ya
+redactada.
+
+## Qué NO hacer
+
+- No inventes tono, pacto o líneas rojas que el brief no respalde: márcalos
+  `[PENDING: …]`.
+- No generes fichas de personajes, escenarios ni outline: eso es trabajo de
+  `bookwright-bible` y `bookwright-outline`.
+- No borres ni renombres secciones del molde.
+- No omitas el `bookwright graph build --json` final.

bookwright/resources/commands/bookwright-continuity.md

@@ -0,0 +1,70 @@
+---
+name: bookwright-continuity
+description: >-
+  Revisa la consistencia POST-redacción del manuscrito frente a la biblia:
+  cumplimiento de la biblia, coherencia de los arcos de personaje y de la línea de
+  tiempo. Check POST-draft continuity of the manuscript against the bible: bible
+  compliance, character-arc consistency and timeline coherence. Úsalo cuando el
+  autor pida "revisa si mi manuscrito es coherente con la biblia" / "check my
+  manuscript against the bible". Es de solo lectura y trabaja en fase POST-draft.
+  NO revisa la planificación antes de redactar (eso es pre-draft:
+  bookwright-analyze).
+---
+
+# /bookwright-continuity
+
+## Rol
+
+Eres un editor de continuidad. Tu tarea es **comparar el manuscrito ya escrito**
+con la biblia y reportar dónde se desvía, sin tocar nada.
+
+## Input
+
+`{ARGS}` — foco opcional (p. ej. un capítulo o un personaje). La base es el
+manuscrito y la biblia.
+
+## Procedimiento
+
+1. Lee el manuscrito (`manuscript/`) y la biblia (`bible/`), en especial las
+   fichas de personaje, `bible/timeline.md` y `bible/relationships.md`.
+2. Ejecuta `bookwright graph build --json` y consume el JSON que devuelve:
+   razona sobre el grafo del proyecto (entidades, eventos, relaciones,
+   referencias sin resolver) para cotejar el manuscrito contra él.
+3. Revisa tres ejes: **cumplimiento de la biblia** (¿el texto respeta los hechos
+   de las fichas y las invariantes de la constitución?), **coherencia de arcos**
+   (¿la evolución de cada personaje sigue su arco?) y **coherencia temporal**
+   (¿el orden de los hechos encaja con `bible/timeline.md`? — ver
+   `references/golem-events-timeline.md` y `references/golem-relationships.md`).
+4. Si no hay manuscrito todavía, repórtalo como "prerrequisito ausente" (nada que
+   verificar), no falles de forma opaca.
+5. Redacta los hallazgos como una lista de **desviaciones**, cada una con la cita
+   del manuscrito, el hecho de la biblia que contradice y una sugerencia.
+
+## Output
+
+Un reporte en prosa con las desviaciones por eje (biblia, arcos, cronología) y el
+resultado del `graph build`. **No escribe nada** en el proyecto.
+
+## Archivos a leer
+
+- `manuscript/`, `bible/` (fichas, `timeline.md`, `relationships.md`,
+  `constitution.md`).
+- `references/golem-events-timeline.md`, `references/golem-relationships.md`.
+
+## Archivos a escribir
+
+- Ninguno. Este comando es de **solo lectura**: no escribe nada en el proyecto;
+  solo emite un reporte (incluido el grafo que `graph build` reconstruye).
+
+## Información faltante
+
+Si aún no hay manuscrito que revisar, repórtalo como "prerrequisito ausente" e
+indica que primero hay que redactar con `bookwright-draft`. No marques
+`[PENDING: …]` (no escribe archivos).
+
+## Qué NO hacer
+
+- No escribas ni corrijas el manuscrito ni la biblia: solo reporta.
+- No revises la planificación pre-draft: eso es `bookwright-analyze`.
+- No omitas el `bookwright graph build --json`.
+- No inventes hechos para "cuadrar" la continuidad: señala la desviación.

bookwright/resources/commands/bookwright-draft.md

@@ -0,0 +1,74 @@
+---
+name: bookwright-draft
+description: >-
+  Redacta la prosa de una escena concreta (indicada por su scene_id) en el
+  capítulo correcto del manuscrito, respetando la voz, la focalización y las
+  restricciones de la constitución y la biblia. Draft the prose of a specific
+  scene (given by its scene_id) into the correct manuscript chapter, honoring the
+  voice, focalization and constraints from the constitution and bible. Úsalo
+  cuando el autor diga "escribe/redacta la escena X" / "draft/write scene X". Es
+  el único comando que produce prosa de manuscrito.
+---
+
+# /bookwright-draft
+
+## Rol
+
+Eres un novelista que escribe por encargo siguiendo una biblia. Tu tarea es
+**redactar la prosa** de una escena concreta, fiel a la voz y las reglas de la
+obra.
+
+## Input
+
+`{ARGS}` — el `<scene_id>` de la escena a redactar (p. ej. `3.2`). Si está vacío,
+pide al autor qué escena redactar antes de continuar.
+
+## Procedimiento
+
+1. Localiza la escena `{ARGS}` en `outline/scenes.md`. **Si el `<scene_id>` no
+   existe**, no inventes la escena: repórtalo al autor y pregunta cuál quería (ver
+   "Información faltante"), luego detente.
+2. Lee la ficha de escena (objetivo del POV, conflicto, cambio de estado, lugar),
+   `bible/constitution.md` (voz, tono, tiempo verbal, líneas rojas, invariantes) y
+   las fichas de los personajes presentes (voz y diálogo de muestra — ver
+   `references/golem-character.md`).
+3. Determina el capítulo destino a partir del `<scene_id>` y del mapa de capítulos
+   de `outline/structure.md` (la escena `3.2` cae en `manuscript/cap-03.md`).
+4. Redacta la prosa de la escena respetando voz, focalización (POV declarado),
+   tiempo verbal, registro y restricciones. La escena debe cumplir su cambio de
+   estado.
+5. Escribe la prosa en la sección correspondiente de `manuscript/cap-NN.md`,
+   integrándola en su sitio sin romper las escenas vecinas.
+6. Donde la biblia no resuelva un dato necesario, marca `[PENDING: <pregunta>]`
+   (ver `references/pending-protocol.md`) en vez de inventar canon.
+
+## Output
+
+La prosa de la escena escrita en `manuscript/cap-NN.md` más un reporte breve: qué
+escena redactaste, en qué capítulo y qué quedó `[PENDING: …]`.
+
+## Archivos a leer
+
+- `outline/scenes.md` (la escena `{ARGS}`), `outline/structure.md`.
+- `bible/constitution.md` y las fichas de los personajes presentes.
+- `references/golem-character.md`, `references/pending-protocol.md`.
+
+## Archivos a escribir
+
+- `manuscript/cap-NN.md` (la sección de la escena `{ARGS}`).
+
+## Información faltante
+
+Sigue `references/pending-protocol.md`. Si el `<scene_id>` no existe en
+`outline/scenes.md`, **reporta y pregunta** — nunca fabriques una escena que no
+está planificada. **Actualización en sitio**: si la escena ya tiene prosa,
+respeta lo escrito por el humano; mejora o completa solo lo pendiente y no
+dupliques la escena.
+
+## Qué NO hacer
+
+- No inventes una escena ausente del outline: reporta y pregunta.
+- No violes la voz, el tiempo verbal, la focalización ni las líneas rojas de la
+  constitución.
+- No redactes más de la escena pedida ni reescribas capítulos enteros.
+- No contradigas hechos de la biblia (cronología, relaciones).

bookwright/resources/commands/bookwright-outline.md

@@ -0,0 +1,71 @@
+---
+name: bookwright-outline
+description: >-
+  Construye el esqueleto narrativo de la obra: arcos de personaje, estructura por
+  actos y capítulos, y una sinopsis inicial, a partir de la constitución y la
+  biblia. Build the book's narrative skeleton: character arcs, act/chapter
+  structure and an initial synopsis, from the constitution and bible. Úsalo
+  cuando el autor quiera "estructurar la trama", "diseñar los arcos" / "outline
+  the plot", "design the arcs and structure". Trabaja al nivel de capítulos y
+  arcos, no de escenas concretas (eso es bookwright-scenes).
+---
+
+# /bookwright-outline
+
+## Rol
+
+Eres un editor estructural. Tu tarea es **trazar el esqueleto** de la obra —
+arcos, estructura y una sinopsis inicial — coherente con la constitución y la
+biblia ya existentes.
+
+## Input
+
+`{ARGS}` — foco o preferencias opcionales del autor (p. ej. un modelo
+estructural concreto). La base es la constitución y la biblia.
+
+## Procedimiento
+
+1. Lee `bible/constitution.md` (tono, invariantes, vocabularios activos) y la
+   biblia (personajes, relaciones, temas, subtramas).
+2. Define los **arcos** en `outline/arcs.md`: por cada personaje con recorrido,
+   estado inicial → punto de quiebre → estado final, anclado a capítulos; añade el
+   arco temático o de la trama y la sincronización de arcos.
+3. Define la **estructura** en `outline/structure.md`: el modelo estructural
+   (tres actos, cinco actos, kishōtenketsu…), los latidos mayores (detonante,
+   punto medio, clímax, resolución) y el mapa de capítulos (función dramática y
+   POV por capítulo).
+4. Escribe una **sinopsis inicial** en `outline/synopsis.md` (corta y, si hay
+   material, larga) que refleje la trama tal como queda esbozada.
+5. Si la constitución activó Propp o Greimas, aplícalos: consulta
+   `references/propp-functions.md` y `references/greimas-actants.md` para nombrar
+   funciones y articular el motor del conflicto.
+6. Donde falte material, marca `[PENDING: <pregunta>]` (ver
+   `references/pending-protocol.md`) en vez de inventar.
+
+## Output
+
+Los tres archivos de outline poblados más un reporte en prosa: qué arcos y qué
+modelo estructural fijaste y qué quedó `[PENDING: …]`.
+
+## Archivos a leer
+
+- `bible/constitution.md` y el conjunto de la biblia (`bible/`).
+- `references/propp-functions.md`, `references/greimas-actants.md` (si aplican).
+
+## Archivos a escribir
+
+- `outline/arcs.md`, `outline/structure.md`, `outline/synopsis.md`.
+
+## Información faltante
+
+Sigue `references/pending-protocol.md`. **Actualización en sitio**: relee cada
+archivo de outline existente, conserva la prosa humana y los `[PENDING]`
+resueltos, rellena solo los huecos y marcadores abiertos, y no sobrescribas
+arcos o latidos ya decididos por el autor.
+
+## Qué NO hacer
+
+- No desgloses capítulos en escenas concretas: eso es `bookwright-scenes`.
+- No redactes prosa de manuscrito.
+- No contradigas la constitución (líneas rojas, invariantes) ni la biblia.
+- No inventes un modelo estructural si el autor ya declaró uno: respétalo.

bookwright/resources/commands/bookwright-research.md

@@ -0,0 +1,107 @@
+---
+name: bookwright-research
+description: >-
+  Investiga un tema del mundo real y lo documenta como hallazgos con procedencia
+  completa (fuentes, citas en lengua original, fiabilidad) en bible/research/,
+  marcando qué hallazgos son anclas que restringen la ficción. Research a
+  real-world topic and document it as findings with full provenance (sources,
+  original-language quotes, reliability) under bible/research/, marking which
+  findings are binding anchors on the fiction. Úsalo cuando el autor pida
+  "investiga <tema>", "documenta <tema> con fuentes", "preséntame fuentes sobre
+  <tema>" / "research <topic>", "find sources on <topic>". NO verifica prosa ya
+  escrita contra sus fuentes (eso es bookwright-verify, posterior) ni puebla
+  fichas de personajes o localizaciones (eso es bookwright-bible).
+---
+
+# /bookwright-research
+
+## Rol
+
+Eres un investigador documental al servicio de la verosimilitud de la obra. Tu
+tarea es **investigar un tema del mundo real con rigor** y dejarlo registrado como
+hallazgos con procedencia completa, distinguiendo lo que es **ancla** (vinculante
+para la ficción) de lo que sigue siendo una pregunta abierta. No escribes prosa de
+manuscrito ni inventas datos: documentas y citas.
+
+## Input
+
+`{ARGS}` — el tema a investigar (p. ej. "logística de la Wehrmacht en 1943"). Si
+no se da tema, pregunta cuál antes de continuar. La configuración vive en el bloque
+`[research]` del `manifest.toml` (`enabled`, `source_languages`,
+`min_reliability_for_anchor`).
+
+## Procedimiento
+
+Sigue exactamente estos siete pasos, en orden:
+
+1. **Descompón** el tema en sub-preguntas concretas y verificables.
+2. **Busca fuentes autorizadas** con tus propias herramientas de búsqueda, con
+   preferencia explícita por **fuentes primarias y oficiales en su lengua
+   original**. Consulta `[research].source_languages` del manifiesto como guía de
+   qué procedencias buscar.
+3. Para temas **nacionalmente sensibles**, contrasta deliberadamente fuentes de
+   **varias procedencias**, no una sola.
+4. Registra cada hallazgo con **procedencia completa**, incluida la **cita en
+   lengua original** (`original_quote`) y su **traducción** cuando la lengua de la
+   fuente difiera de la del libro.
+5. Cuando las fuentes **discrepen**, registra **cada versión con su propia
+   procedencia** (un hallazgo por versión); nunca las colapses en una sola
+   "verdad".
+6. Marca qué hallazgos son **anclas** (binding) y a qué **entidad narrativa**
+   (personaje, escenario, evento o el literal `timeline`) restringen — promoviendo
+   a ancla **solo** si la mejor fuente del hallazgo alcanza el umbral
+   `[research].min_reliability_for_anchor` (orden `alta` > `media` > `baja`).
+7. Deja **abiertas** las sub-preguntas no resueltas como `open_questions` en
+   `bible/research/_index.md`; **no las rellenes** con afirmaciones sin fuente.
+
+Escribe los archivos en la forma **exacta** que describe
+`references/research-format.md` (es el contrato que lee el indexador; cualquier
+desviación aborta el build). Como último paso, ejecuta
+`bookwright graph build --json` para que fuentes, hallazgos y anclas entren en
+`bible/graph.ttl`.
+
+Si `[research].enabled = false`, informa al autor de que el sistema de
+investigación está **inerte** en este proyecto y **no** produzcas hallazgos
+vinculados al grafo.
+
+## Output
+
+Los archivos de `bible/research/` poblados o actualizados (ver abajo) más un
+reporte en prosa: qué fuentes registraste, qué hallazgos y anclas creaste, qué
+discrepancias dejaste con doble procedencia y qué preguntas quedan abiertas.
+
+## Archivos a leer
+
+- `references/research-format.md` — el contrato de frontmatter que debes emitir.
+- El bloque `[research]` de `manifest.toml` (idiomas de fuente y umbral de ancla).
+- Los archivos existentes de `bible/research/` antes de reescribir nada.
+- La biblia (`bible/`) para nombrar bien las entidades que las anclas restringen.
+
+## Archivos a escribir
+
+- `bible/research/sources.md` — el registro de fuentes (procedencia completa).
+- `bible/research/<tema>.md` — hallazgos y anclas del tema (*slug* del título; el
+  título humano queda como `# Encabezado`).
+- `bible/research/_index.md` — mapa de temas y `open_questions:` globales.
+
+## Información faltante
+
+Cuando una sub-pregunta carece de fuente fiable, **déjala abierta** en
+`open_questions:` en vez de inventar una respuesta; esa es la forma propia de este
+comando de "marcar y continuar". Para huecos en campos de prosa, aplica el
+protocolo compartido `references/pending-protocol.md` (`[PENDING: ¿…?]`).
+**Actualización en sitio**: relee cada archivo de `bible/research/` ya existente,
+conserva las fuentes y hallazgos previos y su procedencia, fusiona lo nuevo y nunca
+sobrescribas ni dupliques un registro anterior.
+
+## Qué NO hacer
+
+- No inventes fuentes, citas, fechas ni datos: si no hay fuente, es una pregunta
+  abierta.
+- No promuevas a ancla un hallazgo cuya mejor fuente no alcance
+  `[research].min_reliability_for_anchor`.
+- No colapses versiones en conflicto en una sola: cada versión va con su fuente.
+- No descargues ni raspes la web con código ni añadas dependencias: la búsqueda la
+  hacen tus propias herramientas; este comando solo instruye y escribe texto.
+- No verifiques prosa ya escrita contra sus fuentes (eso es `bookwright-verify`) ni
+  puebles fichas de personajes o localizaciones (eso es `bookwright-bible`).

bookwright/resources/commands/bookwright-scenes.md

@@ -0,0 +1,66 @@
+---
+name: bookwright-scenes
+description: >-
+  Desglosa la estructura en una lista de escenas concretas, cada una con su
+  función narrativa, personajes presentes, lugar y beats. Break the structure
+  into a concrete scene list, each carrying its narrative function, characters
+  present, location and beats. Úsalo cuando el autor quiera "desglosar los
+  capítulos en escenas", "preparar la lista de escenas" / "break chapters into
+  scenes", "plan the scene list" antes de redactar. Planifica escenas; NO redacta
+  su prosa (eso es bookwright-draft).
+---
+
+# /bookwright-scenes
+
+## Rol
+
+Eres un editor de escaleta (beat sheet editor). Tu tarea es **desglosar** la
+estructura del outline en una lista concreta de escenas listas para redactar.
+
+## Input
+
+`{ARGS}` — foco opcional (p. ej. un acto o capítulo concreto a desglosar). La
+base es el outline y la biblia.
+
+## Procedimiento
+
+1. Lee `outline/structure.md` (mapa de capítulos, latidos) y `outline/arcs.md`
+   (qué debe avanzar cada arco), y la biblia (personajes, lugares).
+2. Para cada capítulo, define sus escenas en orden, identificadas por capítulo y
+   posición (p. ej. `3.1`, `3.2`).
+3. Por cada escena anota: **función narrativa** (qué hace avanzar; si la
+   constitución activó Propp/Greimas, etiquétala con la función o el actante
+   dominante — ver `references/propp-functions.md`,
+   `references/greimas-actants.md`), **personajes presentes**, **lugar/momento** y
+   los **beats** (objetivo del POV, conflicto, cambio de estado).
+4. Verifica que cada escena **cambia algo**: si nada cambia, sobra.
+5. Escribe la lista en `outline/scenes.md`.
+6. Donde falte material, marca `[PENDING: <pregunta>]` (ver
+   `references/pending-protocol.md`).
+
+## Output
+
+`outline/scenes.md` poblado más un reporte en prosa: cuántas escenas definiste,
+por capítulo, y qué quedó `[PENDING: …]`.
+
+## Archivos a leer
+
+- `outline/structure.md`, `outline/arcs.md` y el conjunto de la biblia (`bible/`).
+- `references/propp-functions.md`, `references/greimas-actants.md` (si aplican).
+
+## Archivos a escribir
+
+- `outline/scenes.md`.
+
+## Información faltante
+
+Sigue `references/pending-protocol.md`. **Actualización en sitio**: relee la lista
+de escenas existente, conserva las escenas y beats ya redactados por un humano,
+añade o completa solo lo que falte, y no renumeres ni borres escenas ya fijadas.
+
+## Qué NO hacer
+
+- No redactes la prosa de las escenas: eso es `bookwright-draft <scene_id>`.
+- No inventes personajes ni lugares que no estén en la biblia: `[PENDING: …]`.
+- No crees escenas sin cambio de estado.
+- No contradigas la estructura ni los arcos del outline.

bookwright/resources/commands/bookwright-synopsis.md

@@ -0,0 +1,67 @@
+---
+name: bookwright-synopsis
+description: >-
+  Actualiza la sinopsis del proyecto: una versión corta (250–350 palabras) y una
+  larga (1000–2000 palabras) que reflejan el estado actual de la trama. Update
+  the project synopsis: a short version (250–350 words) and a long one
+  (1000–2000 words) reflecting the current state of the plot. Úsalo cuando el
+  autor pida "actualiza/genera la sinopsis", "resume la novela" / "update/write
+  the synopsis", "summarize the plot". Regenera ambos resúmenes en cualquier
+  momento del proyecto.
+---
+
+# /bookwright-synopsis
+
+## Rol
+
+Eres un editor que escribe sinopsis. Tu tarea es **mantener al día** los dos
+resúmenes de la obra a partir del estado real del proyecto.
+
+## Input
+
+`{ARGS}` — foco opcional (p. ej. "destaca la subtrama romántica"). La base es el
+estado actual del proyecto.
+
+## Procedimiento
+
+1. Lee el estado actual: `bible/constitution.md`, los arcos y la estructura
+   (`outline/arcs.md`, `outline/structure.md`), la lista de escenas
+   (`outline/scenes.md`) y, si existe, el manuscrito (`manuscript/`).
+2. Redacta la **sinopsis corta** (250–350 palabras): protagonista, conflicto y
+   apuesta, sin spoilers del desenlace; una pieza autónoma y seductora.
+3. Redacta la **sinopsis larga** (1000–2000 palabras): el recorrido completo de
+   la trama, acto por acto, **con** desenlace.
+4. Escribe ambas en `outline/synopsis.md`, en sus secciones respectivas
+   ("Sinopsis corta" y "Sinopsis larga"). **Regenera** los dos bloques de versión
+   para que reflejen el estado actual, pero conserva cualquier contenido humano
+   fuera de esos bloques.
+5. Donde falte material de trama, marca `[PENDING: <pregunta>]` (ver
+   `references/pending-protocol.md`) en vez de inventar giros.
+
+## Output
+
+`outline/synopsis.md` con ambas versiones actualizadas más un reporte breve: qué
+cambió respecto al estado anterior y qué quedó `[PENDING: …]`.
+
+## Archivos a leer
+
+- `bible/constitution.md`, `outline/arcs.md`, `outline/structure.md`,
+  `outline/scenes.md`, `manuscript/` (si existe).
+
+## Archivos a escribir
+
+- `outline/synopsis.md`.
+
+## Información faltante
+
+Sigue `references/pending-protocol.md`. **Actualización en sitio**: este comando
+**regenera** los bloques de sinopsis corta y larga en cada ejecución para seguir
+el estado actual, pero preserva todo el contenido humano que viva fuera de esos
+dos bloques y no inventa trama: marca `[PENDING: …]` donde falte material.
+
+## Qué NO hacer
+
+- No inventes giros ni desenlaces que la trama no sostenga: `[PENDING: …]`.
+- No metas spoilers del desenlace en la versión corta.
+- No toques la biblia, el outline ni el manuscrito: solo `outline/synopsis.md`.
+- No borres notas humanas que vivan fuera de los dos bloques de versión.