Desarrollar tema
Convierte un tema candidato en un contrato de contenido aprobado. El trabajo está listo para escribir solo cuando el argumento, la evidencia y los límites ya no necesiten ser inventados en etapas posteriores.
Alcance
Empieza con un tema candidato o un conjunto pequeño y naturalmente acotado. Cuando queden varias direcciones cercanas, compáralas ligeramente por valor para la audiencia, novedad, verificabilidad, demostrabilidad, adecuación del autor y riesgo de exageración; pide al usuario que elija antes de una investigación profunda. El escaneo abierto de tendencias y el mantenimiento de un backlog de ideas quedan fuera de esta habilidad.
Espacio de trabajo de evidencia
Crea un directorio content/ en el proyecto de video:
content/
|-- RESEARCH.md
|-- TOPIC.md
`-- experiments/
Usa RESEARCH.md para hechos con fuente, interpretaciones, desacuerdos, incógnitas, direcciones rechazadas y enlaces a material primario. Mantén la recopilación separada de la selección editorial.
Trata una afirmación como material cuando afecte si el tema funciona, importa a la audiencia, difiere de una alternativa, puede demostrarse o sigue siendo válida dentro del alcance declarado. Apóyala con una fuente o experimento lo suficientemente sólido para esa afirmación exacta; etiqueta la evidencia más débil como provisional en lugar de estirarla en silencio.
Cuando una afirmación necesite evidencia ejecutable, realiza el experimento más pequeño que pueda resolverla y escribe content/experiments/<nombre>.md con la pregunta, método, muestras, entorno, comando, resultados, limitaciones y conclusiones que el resultado respalde. Mantén el código y los datos sin procesar en el proyecto al que pertenecen; registra sus rutas y revisión de Git en lugar de copiarlos en el proyecto de video.
Contrato de contenido
Escribe content/TOPIC.md:
---
status: draft
audience: ...
core_question: ...
thesis: ...
scope: ...
voice:
language: ...
skills: []
documents: []
unavailable: []
status: resolved | assumed
---
# Título de trabajo
## Promesa al lector
## Argumento
### A01 - Afirmación
- role: Por qué existe esta afirmación en el argumento
- claim: La proposición exacta
- evidence: Enlaces a encabezados de RESEARCH.md o informes de experimentos
- confidence: established | provisional
- boundary: Lo que la evidencia no establece
## Fuera del alcance
## Preguntas abiertas
## Títulos alternativos
Resuelve las fuentes de voz en este orden: dirección explícita del usuario, guía del proyecto o marca, una habilidad de estilo de escritura disponible que coincida con el idioma y tipo de contenido, preferencias visibles del usuario, ejemplos de escritura, luego un valor predeterminado explicativo claro. Registra las fuentes realmente utilizadas y persiste las fuentes solicitadas pero no disponibles bajo voice.unavailable; no asumas memoria no disponible o un perfil oculto.
Puerta de aprobación
Presenta el título de trabajo, la tesis, el alcance, el argumento, la evidencia clave, los límites y las preguntas abiertas materiales para revisión. Un título puede seguir cambiando, pero la audiencia, la tesis, el alcance, el argumento, la evidencia y los límites de la conclusión son decisiones bloqueadas.
Solo la aprobación explícita del usuario cambia el frontmatter a:
status: approved
approved_at: YYYY-MM-DD
approved_digest: sha256:<digest>
El digest es SHA-256 del archivo completo después de eliminar solo la línea approved_digest:. Vuelve a calcularlo antes de confiar en la aprobación. Una discrepancia hace que la aprobación quede desactualizada y devuelve el archivo a draft. Después de una edición no material verificada del título o copia, el digest puede actualizarse sin renovar la aprobación; propaga el nuevo digest a cada artefacto dependiente.
Hasta entonces, mantén toda la escritura dentro de RESEARCH.md, los informes de experimentos y el borrador de TOPIC.md. No crees ARTICLE.md ni BEATS.md; una solicitud para avanzar rápido o permiso para elegir una tesis no sustituye la aprobación del contrato resultante.
Un cambio material posterior a una decisión bloqueada devuelve TOPIC.md a draft y hace que la aprobación del artículo posterior quede desactualizada. Las correcciones de copia, ejemplos y cambios de título que preserven el significado no revocan la aprobación.
Antes de presentar content/TOPIC.md o cualquier revisión posterior, sigue ../boring-video/references/markdown-review.md. Mantén la ruta canónica de Markdown como la versión actual y aplica los comentarios de revisión allí.
El tema está completo cuando TOPIC.md está aprobado, cada afirmación material apunta a evidencia suficiente, las preguntas abiertas restantes no son bloqueantes y son visibles, un redactor de artículos puede redactar sin inventar hechos, experimentos, posición del autor, argumento o alcance, y se cumple el criterio de finalización de la revisión de Markdown.