builder-self-audit
Auditoria obligatoria del Builder antes de reportar una tarea como completada, que cubre tipo de archivo, completitud multi-archivo, regresion y gates globales. Usar cuando el Builder va a declarar te
SKILL.mdskills/builder-self-audit/SKILL.md
GitHubbuilder-self-audit
Cuándo usar
Obligatorio antes de escribir en execution_log.md que una tarea está completada.
NO usar para tareas de solo lectura o exploración.
Cuándo NO usar
Tareas de investigación o análisis sin modificación de archivos
Lectura de documentación o contexto
Pasos
Paso 1 — Verificación tipo-específica
Para cada archivo modificado en esta tarea:
Python:
python -m py_compile src/archivo.py
✅ Sin output → OK
❌ Hay output → Error de sintaxis. PARA. Corrige antes de continuar.
YAML:
python -c "import yaml; yaml.safe_load(open('data/archivo.yaml', encoding='utf-8')); print('OK')"
✅ Imprime
OK→ válido❌ Excepción → YAML inválido. PARA. Corrige antes de continuar.
JSON:
python -c "import json; json.load(open('data/archivo.json', encoding='utf-8')); print('OK')"
✅ Imprime
OK→ válido❌ Excepción → JSON inválido. PARA. Corrige antes de continuar.
Si un archivo falla: no pases al siguiente paso. Corrige y re-verifica ese archivo.
Paso 2 — Protocolo "Ya Existía / Ya Estaba Hecho"
Si la tarea del plan ya estaba implementada antes de que tocaras el código:
Cita la línea exacta y contenido literal en el log:
EXISTE en `src/foo.py` L133: ` self._settings = globals().get("settings")` El plan pedía exactamente esto. Sin cambios aplicados.Verifica que lo que existe cumple el criterio del plan, no solo que "algo con ese nombre existe".
Si lo que existe es diferente al plan → implementa el plan y documenta la discrepancia.
"Ya existía" sin cita de línea = información incompleta. El Manager pedirá evidencia.
Paso 3 — Verificación de completitud multi-archivo
Si la tarea modificaba N archivos del mismo tipo:
Verifica cada uno individualmente. No asumas que si el primero está bien, los demás también.
# Ejemplo para N archivos YAML
python -c "
import yaml
from pathlib import Path
archivos = list(Path('data/sectors').glob('*.yaml'))
for f in archivos:
data = yaml.safe_load(f.read_text(encoding='utf-8'))
if 'seccion_requerida' not in data:
print(f'FALTA en {f.name}')
else:
print(f'OK: {f.name}')
"
Si hay FALTAs → la tarea no está completa. Completa los archivos que faltan.
Paso 4 — Checklist anti-regresión (solo para ISS / code smell / refactor)
Si esta tarea es un fix de code smell, limpieza o refactor menor, responde estas preguntas antes de continuar:
ÿEl código original manejaba algún caso de error que esta versión ignora?
ÿLa construcción "fea" existía por una razón defensiva? (ej:
globals().get("x")devuelveNonedonde una referencia directa lanzaríaNameError)ÿLeí el código circundante (20 líneas arriba/abajo) para entender el contexto completo?
ÿSi el módulo falla al importar, mi versión explota donde la original no?
Si alguna respuesta es "sí" o "no sé": documenta la pregunta en execution_log.md y resuélvela antes de marcar completo.
Para tareas de nueva funcionalidad o creación de archivos: omitir este paso.
Paso 4b — Reglas de contract para review estructurado
Si la tarea pasó por un review, o si el fix nació de una observación de review, endurece el cierre con estas reglas:
Rechaza edge cases irreales, riesgos especulativos y rewrites amplios.
Si un fix disparado por review cambia código, rerun de tests focalizados y rerun de la revisión estructurada.
Para en cuanto la revisión devuelve 0 findings accionables; no hagas una pasada extra solo para pulir el wording.
Estas reglas refuerzan los pasos 1-4. No sustituyen la verificación tipo-específica ni la frescura documental.
Paso 5 — Verificación de frescura documental
Antes de ejecutar gates de calidad, verifica que la documentación operativa está fresca y sincronizada:
PROJECT.mdrefleja el estado real del proyecto y contratos operativosQUICKSTART.mddocumenta flujos operativos actuales sin driftSkills afectados reflejan reglas canónicas sin contradicciones
TURN.md,STATE.md,execution_log.mdestán alineados y sin ambigüedadNo hay drift entre documentación e implementación del runtime
Si hay drift → corrige la documentación antes de continuar. Frescura documental es obligatoria para reducir drift post-review.
Paso 6 — Gate completo del proyecto
Este paso es el gate de CIERRE FINAL sobre todo el proyecto. No es el gate FOCAL de
builder-run-quality-gates (que corre tras cada cambio sustancial, por deliverable_type); la
prohibicion de esa skill de "NO saltar el dispatcher invocando ruff/pytest manualmente" aplica al
gate focal, no a este cierre final. Usa el MISMO dispatcher para evitar que los dos mecanismos
diverjan (el dispatcher ejecuta ruff check -> ruff format --check ->
run_pytest_safe.py --level all -> pip_audit_project.py condicional; ver
builder-run-quality-gates/SKILL.md):
python scripts/run_gates_dispatch.py
✅ Pasa → puedes reportar
❌ Falla → corrige y vuelve al inicio del gate
Paso 7 — Reportar en execution_log.md con evidencia real
Solo si los pasos 1-6 pasaron sin errores, escribe en execution_log.md el output real:
### Tarea X.Y — [Descripción] — VERIFICADO
#### Implementación
- Archivo modificado: `src/foo.py` L45-48
- Cambio: [descripción breve]
#### Evidencia de verificación
| Verificación | Comando | Resultado |
|-------------|---------|-----------|
| Sintaxis Python | `py_compile src/foo.py` | ✅ OK |
| YAML válido | `yaml.safe_load('data/x.yaml')` | ✅ OK |
| Frescura documental | Verificación manual de PROJECT.md, QUICKSTART.md, TURN.md | ✅ Sincronizado |
| Ruff | `ruff check src/` | ✅ All checks passed |
| Tests | `python scripts/run_pytest_safe.py` | ✅ 12 passed, 0 failed |
#### Estado
- [x] Implementado por Builder
- [ ] Verificado por Manager
Sin output real de comandos = el Manager pedirá evidencia antes de revisar.