Lucian1u/material-to-deliverable

Material a Entregable

Convierte los materiales reales de 00_input/ en documentos de texto verificables, rastreables y entregables.

Condiciones de inicio

Ejecutar solo cuando se cumplan todas las condiciones siguientes:

• El usuario proporciona o especifica un directorio de proyecto local.
• 00_input/ contiene al menos un material real.
• El usuario desea uno de los siguientes: informe, propuesta, revisión, investigación o presentación.

Si el directorio no está claro, pregunta solo por el directorio del proyecto. Si el tipo de entrega no está claro, pregunta solo por el tipo de entrega. Si no hay materiales reales, detente; no generes ejemplos ni materiales de reemplazo.

Lectura obligatoria en cada ejecución

Antes de comenzar el procesamiento, lee completamente:

• Reglas de evidencia y seguridad
• Contrato de archivos

Después de confirmar el tipo de entrega, lee la sección correspondiente de Reglas de tipos de entrega.

Flujo de trabajo

1. Confirmar proyecto e inicialización

Si el proyecto aún no está inicializado, llama al script desde el directorio de instalación del Skill y pásale la ruta absoluta del proyecto:

python3 <directorio-skill>/scripts/init_project.py /ruta/absoluta/al/proyecto

No asumas que scripts/ existe en el directorio actual del proyecto del usuario. Primero resuelve <directorio-skill> basándote en la ubicación de este archivo, luego ejecuta el script.

Si 01_working/ ya existe, lee el estado existente y continúa; no reinicies ni sobrescribas archivos.

2. Revisar entrada e información sensible

Enumera todos los archivos en 00_input/. Registra aquellos que no se pueden leer o cuya fuente es desconocida. No modifiques, muevas ni renombres los materiales originales.

Primero, realiza la verificación de información sensible. Si se detectan nombres personales, datos de contacto, cuentas, datos de clientes, contratos, información financiera, de salud, registros educativos, credenciales, rutas internas u otra información potencialmente restringida:

1. Registra solo el tipo de riesgo y la ubicación del archivo en 02_material-index.md; no copies valores sensibles.
2. Detente inmediatamente.
3. Pide al usuario que confirme que tiene permiso para procesar estos materiales, o que proporcione una copia anonimizada.

Sin confirmación del usuario, no continúes con el esquema, la redacción ni la entrega.

3. Aclarar la tarea

Haz solo una pregunta a la vez que pueda cambiar el producto final, máximo siete. Prioriza: destinatario, contexto de uso, decisión que se desea impulsar, fecha límite, tipo de entrega, contenido obligatorio y contenido prohibido.

Si el usuario responde "no sé", anótalo como punto pendiente de confirmación; no reemplaces la respuesta del usuario. Escribe los resultados en 01_task-brief.md, muestra un resumen y espera la confirmación del usuario.

4. Crear índice de materiales y brechas

Completa 02_material-index.md por cada material, distinguiendo:

• Hechos directamente respaldados por la fuente
• Declaraciones de la persona u organización involucrada
• Entrevistas, comentarios u observaciones parciales
• Juicio del propio usuario
• Información pendiente de confirmación

Escribe en 03_gaps-and-conflicts.md los conflictos, ausencias, archivos ilegibles, necesidad de anonimización e información sin suficiente evidencia. No extrapoles conclusiones generales a partir de pocos materiales.

Si existen brechas bloqueantes, sigue preguntando o detente; no generes el producto principal.

5. Crear esquema respaldado por fuentes

Crea 04_source-backed-outline.md según el tipo de entrega. Cada sección debe especificar: la pregunta a responder, los materiales utilizados, las conclusiones permitidas, el juicio del usuario, los puntos pendientes y el método de validación.

Muestra un resumen del esquema y la cobertura de fuentes, y espera la confirmación del usuario. Sin confirmación, no escribas el producto principal.

6. Generar producto principal e índice de fuentes

Según el esquema confirmado, genera:

• 05_main-deliverable.md
• 06_one-page-summary.md
• 07_source-index.md

Cada hecho clave debe corresponder en el índice de fuentes a un archivo y ubicación específicos. No inventes números, personas, casos, citas o resultados que no estén en los materiales. Los juicios personales deben separarse de los hechos de las fuentes.

7. Revisión contra materiales originales

Vuelve a leer 00_input/; no te bases solo en el producto recién generado para la autoverificación. Anota en 08_audit-report.md los problemas de hechos, alcance, lógica, privacidad, coherencia de la tarea y expresión.

Solo corrige problemas que puedan resolverse claramente con los materiales existentes. Los elementos que requieran juicio del usuario deben quedar como pendientes.

8. Preparar paquete de entrega

Solo si no hay problemas bloqueantes en la auditoría, escribe el contenido aprobado en:

02_delivery/
  main-deliverable.md
  one-page-summary.md
  source-index.md
  readme.md

02_delivery/ no debe contener materiales originales, indicaciones, registros de chat, borradores internos ni valores sensibles. Finalmente, ejecuta desde el directorio de instalación del Skill:

python3 <directorio-skill>/scripts/validate_project.py /ruta/absoluta/al/proyecto --stage delivery

Después de que pase el script de validación, recuerda al usuario que realice la liberación manual final. El script solo verifica la estructura de archivos y residuos evidentes; no puede verificar la corrección de los hechos.

Condiciones de parada

Detente ante cualquiera de las siguientes situaciones e indica qué falta:

• 00_input/ está vacío o los materiales no se pueden leer.
• El usuario no ha confirmado que se puedan procesar los materiales sensibles.
• El destinatario, el tipo de entrega o el objetivo principal aún no están claros.
• Los materiales actuales no pueden respaldar la conclusión principal.
• El usuario aún no ha confirmado el resumen de la tarea o el esquema.

No uses materiales ficticios, búsqueda en internet ni inferencias de sentido común para eludir las condiciones de parada, a menos que el usuario autorice explícitamente nuevas fuentes de datos.

Idioma de salida

Por defecto, sigue el idioma que el usuario esté utilizando actualmente. Los nombres de archivo se mantienen en inglés para facilitar su uso en múltiples entornos; el contenido de los archivos usa el idioma del usuario.