g14wxz/entrega-trazable
Entrega trazable para proyectos hechos con agentes de código: una rama por entregable integrada con pull request y merge commit, commits en español con Conventional Commits, bitácora de IA (qué hizo el agente, qué se corrigió, qué se descartó) y README de entrega con los 12 puntos de una prueba técnica AI-native.
77
97%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Passed
No findings from the security scan
SKILL.mdskills/bitacora-ia/
- name:
- bitacora-ia
- description:
- Registra en docs/bitacora-ia.md cada tarea hecha con un agente de código (Claude Code, Codex u otro), con lo que se le pidió, lo que hizo, lo que revisó o corrigió la persona, las propuestas descartadas y su motivo, y el tiempo que tomó. Úsala al terminar una tarea hecha por el agente, cuando la persona corrige o descarta una propuesta del agente, al cerrar un entregable, o para reconstruir la bitácora desde el historial de git antes de escribir el README.
Bitácora de IA
La bitácora cuenta cómo se usó el agente, tarea por tarea. De ella salen los puntos 8 a 11 del README: tiempo, herramientas de IA, cómo se usó el agente y qué propuestas se cambiaron o descartaron. Esos datos no se pueden reconstruir después, así que se anotan en el momento.
Formato: references/plantilla-bitacora.md. Si docs/bitacora-ia.md no existe, créalo con esa plantilla.
Cuándo escribir
- Al terminar cada tarea hecha por el agente, antes del commit, para que la entrada entre en el mismo commit que el cambio. Si la tarea ocupa varios commits, va en el último y nombra los anteriores.
- Cuando la persona corrige al agente o descarta una de sus propuestas. Es lo más valioso de la bitácora: muestra el criterio de la persona.
- Al cerrar un entregable: actualiza la tabla de resumen con el tiempo total.
Cómo escribir una entrada
- Tarea: lo que pidió la persona, con sus palabras.
- Agente: herramienta y modelo, por ejemplo "Claude Code (Opus 5.5)".
- Qué hizo el agente: archivos y cambios concretos. Nada de "se mejoró el código".
- Revisión de la persona: solo lo que de verdad pasó en la conversación: qué revisó, qué probó y qué pidió cambiar. Si no lo sabes, escribe "por confirmar" y pregúntale.
- Propuestas cambiadas o descartadas: qué propuso el agente → qué se decidió → por qué. Ejemplo: "Proponía
FLOATpara el precio → se usóDECIMAL(10,2)→FLOATredondea mal el dinero." - Tiempo: hora de inicio y de fin, tomadas de la conversación o de los commits. Si la persona da un estimado, se usa el suyo.
- Commits: el número del PR en GitHub (#N), o "este commit" si la entrada va en el commit que se está preparando. No cites hashes de una rama que se integra con rebase: al integrarla, GitHub crea commits nuevos y esos hashes dejan de existir.
Reglas
- Solo hechos. No escribas "se revisó con cuidado" ni "se probó todo" si no consta.
- Cada entrada ocupa de 5 a 10 líneas, con las palabras del glosario.
- Las entradas van en orden de fecha, con la más nueva al final.
- Nunca borres una entrada. Si algo estaba mal, agrega una corrección con fecha.
Reconstruir desde git
Si faltan entradas, ármalas desde el historial y después confírmalas con la persona:
git log --reverse --date=iso --format='%h %ad %an%n %s%n%b' | grep -v '^$'La línea Co-Authored-By de cada commit dice qué agente participó. Marca todo lo reconstruido como "reconstruido desde git, por confirmar".