/caso — contar cómo se hizo un proyecto
Convierte las conversaciones de Claude de un proyecto en una historia paso a paso que alguien
que está aprendiendo pueda seguir, y después en un PDF, un carrusel y un reel sin voz. Todo
queda en <proyecto>/caso/ (ignorada por git). Nunca publica ni toca el calendario.
Todos los comandos se llaman así (la ruta del proyecto siempre absoluta):
npm --prefix ~/Documents/Claude/Carrusel run -s caso -- <sub> "<proyecto>" …
Si las conversaciones están en otra carpeta (por ejemplo la carpeta madre), agrega
--sesiones-de "<carpeta>" a sesiones, trozar y numeros.
Reglas de privacidad (no se negocian)
- Clientes, empresas y personas reales se cambian por roles («una clienta», «la empresa de logística», «una colega»). Nunca nombres reales, ni de pila ni apodos.
- Nunca copies salidas de herramientas (resultados de comandos, archivos leídos) a la historia ni a los resúmenes. Los prompts sí, sin nombres, rutas ni datos.
- Sin rutas, correos, teléfonos, RUT, claves ni enlaces privados.
- La pieza firma como @ia.punto.es con «Te ayudo a partir…»; nunca con el nombre Felipe.
- Nada de esto se commitea en el repo Carrusel.
Flujo
Qué logro contar. Pregúntale a Felipe qué logro quiere contar si no lo dijo. Corre
sesionesy propón cuáles pertenecen a ese logro (por tema de los mensajes, fechas y carpetas tocadas). Si es una carpeta con varios proyectos mezclados, di cuáles sesiones dejas fuera y por qué. Espera a que Felipe confirme.Números y trozos. Con los ids confirmados corre
numerosytrozar. Lanza un subagente por trozo: pásale la ruta de su archivo (<proyecto>/caso/trabajo/<id>-NN.md) y esta instrucción:Lee solo este archivo: . No abras ningún otro archivo ni carpeta. Resume en español este trozo de una conversación: qué quería la persona, qué referencias usó, qué se probó, qué falló y cómo se arregló, y los prompts clave. Reemplaza clientes, empresas y personas por roles. No copies salidas de herramientas, rutas, enlaces ni datos. Devuelve solo el resumen.
Nunca pegues trozos crudos en la historia; trabaja con los resúmenes.
Archivos e imágenes. Lee los archivos del proyecto que sean versiones o análisis (
_v2, notas, guiones) para entender cómo avanzó. Mira las imágenes candidatas y descarta las que muestren datos (nombres, correos, pantallas con información de clientes). Copia las elegidas conimagen "<proyecto>" "<ruta>"y úsalas como.Historia. Escribe
caso/historia.mdconhistoria-plantilla.md(en esta carpeta), en lenguaje de aprendiz: frases cortas, una idea por párrafo, ejemplos simples, sin jerga sin explicar. Luego:- corre
tapar "<proyecto>/caso/historia.md"; - haz tu propia pasada buscando clientes, empresas y personas (nombres, apodos, iniciales) y cámbialos por roles;
- en
## Para Felipe: qué se tapócopia solo el resumen por tipo y cantidad que imprimiótapar(por ejemplo «ruta: 3, correo: 1») y los reemplazos por rol, nunca el valor original.
Las secciones
## Para Felipe: …no salen en el PDF.- corre
Parar. Muéstrale la historia completa a Felipe y detente. Solo si responde en el chat escribiendo «apruebo» o «aprobada» corre
aprobar. Cualquier otra respuesta («dale», «ok», «se ve bien») no es aprobación: pregúntale si la aprueba. Si pide cambios, edita, vuelve a corrertapary vuelve a mostrarla. Si la historia cambia después de aprobarla, hay que aprobarla de nuevo (la puerta lo exige).Pieza. Escribe
caso/borrador.json:- Formato
Borradorde~/Documents/Claude/Carrusel/src/calendario/draft.ts; plantillas y sus props ensrc/remix/templates-catalog.ts(Hook, Step, Prompt, Screen, Stat, Clip, Cta…). Ejemplo válido:borrador-ejemplo.jsonen esta carpeta. - Fondos: solo
color,gradientoimagecon un archivo deimagenes/. Nunca fondosainihookVideo(la puerta los rechaza). Lo normal es no poner fondo: las plantillas escriben en tinta oscura sobre papel claro, y un color, degradado o imagen oscuros dejan el texto ilegible (soloClipva sobre negro con texto claro). Para mostrar el proyecto usa una escenaClip. - Si el reel muestra video del proyecto:
clip "<proyecto>" "<video>" <desde> <hasta> <nombre>y una escenaClipcon"archivo": "<nombre>.mp4". - Cierre con
Cta:"handle": "@ia.punto.es"y"reason": "Te ayudo a partir con la IA en tu trabajo". Ningún texto dice «Felipe». - El reel es sin voz (no pongas
narracion). - Proyectos de video: el reel es casi todo video. Si el proyecto es un video (con su
canción), arma el reel con escenas
Clipque llevan el texto de cada paso encima (titleylabel; sinhighlight: el subrayado lima sobre el video molesta) y cierra conCta. Si el video es horizontal, recórtalo con--ancho: sale completo a lo ancho bajo los títulos, con el mismo video desenfocado detrás (sin--anchoel reel lo recorta al centro y se pierden los lados). Recorta los clips con--con-sonidoy pon"audio": "clips": cada clip suena con su propio audio, así la música siempre coincide con lo que se ve. Cada clip suena desde su inicio hasta que entra el siguiente (el último cubre elCtay baja con fade-out), y nunca más allá de lo que recortaste.- Para que un tramo de la canción siga sin saltos en varias escenas, corta los clips
seguidos: el siguiente empieza donde terminó de sonar el anterior. Cuánto suena cada
escena depende de su texto; calcúlalo con
specTimingyrangosClipsantes de recortar. - Elige solo tramos que no digan ni muestren nada confidencial (nombres de personas, clientes, empresas, la IA con nombre propio): revisa la letra con sus tiempos (transcripción o timeline del proyecto) y mira los cuadros (hoja de contacto a 1 cuadro/s). Deja ~1 s de margen antes de cada palabra o pantalla prohibida. Instrumentales y coros suelen servir.
- Así, el carrusel se queda con una sola lámina (el carrusel no lleva video). Escribe su
versión en
caso/carrusel.json(mismo formato; pasa por la misma puerta).
- Para que un tramo de la canción siga sin saltos en varias escenas, corta los clips
seguidos: el siguiente empieza donde terminó de sonar el anterior. Cuánto suena cada
escena depende de su texto; calcúlalo con
- Música de fondo sin clips: si el reel es de láminas y el proyecto tiene canción propia,
arma la pista con
musica "<proyecto>" "<canción>" musica <desde-hasta>…y pon"audio": "musica.m4a". - Con música o clips con sonido, dile a Felipe qué tramos usaste y qué quedó fuera, y pídele que lo escuche antes de usarlo: tú no puedes oírlo.
Corre
generar "<proyecto>"(o--solo-pdfpara revisar primero la guía). Si la puerta da motivos, corrígelos enborrador.jsony repite. Arreglar el borrador nunca tocahistoria.md. Si el motivo es que la historia no está aprobada o cambió, vuelve al paso 5: muéstrasela a Felipe; nunca corrasaprobarsin su aprobación explícita en el chat. Muéstrale a Felipe las rutas del PDF, el carrusel y el reel, y los avisos (puntaje y revisión visual) tal cual. No publiques ni toques el calendario. Felipe mira cada slide del carrusel y el reel completo antes de usarlos: la aprobación de la historia no cubre lo que dicen o muestran las piezas generadas. Si pide cambios, editaborrador.jsony vuelve a corrergenerar; nada se da por listo hasta que él lo diga.- Formato
Comandos
| Comando | Qué hace |
|---|---|
sesiones <proyecto> |
Lista conversaciones: id, fechas, tamaño, carpetas y primeros 3 mensajes (tapados) |
trozar <proyecto> <id…> |
Escribe caso/trabajo/<id>-NN.md (ya tapados) |
numeros <proyecto> <id…> |
Escribe caso/numeros.json |
tapar <archivo> |
Tapa datos sensibles en un archivo de caso/ e imprime tipo y cantidad |
imagen <proyecto> <ruta> |
Copia la imagen a caso/imagenes/ |
clip <proyecto> <video> <desde> <hasta> <nombre> [--con-sonido] [--ancho] |
Recorta un clip a caso/clips/ (sin audio, salvo --con-sonido; --ancho: video horizontal completo bajo los títulos) |
musica <proyecto> <audio> <nombre> <desde-hasta…> |
Une tramos de una canción en caso/clips/<nombre>.m4a, con fundidos cortos |
aprobar <proyecto> |
Aprueba caso/historia.md (solo tras el «apruebo» o «aprobada» de Felipe) |
generar <proyecto> [--solo-pdf] |
Genera caso/caso.pdf, el carrusel y el reel en caso/salida/ |