CtrlK
BlogDocsLog inGet started
Tessl Logo

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

Quality

97%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Entrega trazable

Todo el trabajo tiene que poder seguirse en el historial de git y en la bitácora de IA (docs/bitacora-ia.md).

  • Nunca hagas commit directo en main ni en la rama de integración (el glosario dice cuál es; en AIPOS es ProductionEnv). Todo entra por una rama y un pull request (PR, la solicitud para unir una rama con otra). Solo si el proyecto todavía no tiene remoto, entra por una rama y un merge local --no-ff.
  • Cada entregable tiene su propia rama, y esa rama no se borra al integrarla.
  • Un entregable se integra con un PR y un merge commit, que es un commit que une las dos ramas y deja ver que existieron. Nunca con squash ni con rebase. Sigue la skill flujo-entregable.
  • Los mensajes de commit siguen Conventional Commits: prefijo en inglés (feat, fix, docs, chore, refactor, test) y descripción en español con las palabras del glosario. Ejemplo: feat(ventas): registrar venta con procedimiento almacenado. Un cambio lógico por commit.
  • Si el agente escribió o cambió el código, el commit lleva la línea Co-Authored-By del agente.
  • No pongas en commits ni PR enlaces a sesiones privadas del agente, como la línea Claude-Session: el repositorio es público y quien revise puede no tener acceso a ellos.
  • Al terminar cada tarea hecha por el agente, agrega una entrada en la bitácora con la skill bitacora-ia, en el mismo commit que el cambio. Si la tarea ocupa varios commits, la entrada va en el último y nombra los anteriores.
  • No inventes lo que la persona revisó, corrigió o decidió. Si no lo sabes, pregúntale o márcalo "por confirmar".
Workspace
g14wxz
Visibility
Public
Created
Last updated
Publish Source
CLI
Badge
g14wxz/entrega-trazable badge