repo-audit
Auditoria multifase multiagente de un repo (dead code, legacy, seguridad, proceso) con bucle adversarial de verificacion antes de proponer limpieza. Usar cuando el repo ha crecido y hace falta un cens
SKILL.mdskills/repo-audit/SKILL.md
GitHubrepo-audit
Skill minima que apunta al nucleo de auditoria multiagente de repos. Esta skill SOLO apunta: no re-declara criterios del nucleo ("skill apunta, prompt gobierna" — X-09).
Fuente canonica
- Nucleo:
prompts/repo_audit_multiagent.md - Todo el contenido normativo (las 7 fases, el gate de sostenibilidad, la composicion del bucle adversarial, el formato de salida, las restricciones y los riesgos) vive SOLO ahi. Leelo entero antes de ejecutar esta skill.
Cuando usarla
- El repo (motor o destino) ha crecido y hace falta un censo de codigo obsoleto, archivos legacy, vulnerabilidades de seguridad o malas practicas, antes de decidir que limpiar.
- Se quiere repetir la auditoria periodicamente con el mismo criterio (misma composicion de lanes, mismo gate de sostenibilidad, mismo presupuesto de bucle adversarial).
Cuando NO usarla
- Ya se identifico UN archivo concreto a refactorizar: usa
skills/refactor-managerdirectamente, sin pasar por las 7 fases. - El objetivo es auditar especificamente la taxonomia
legacy-stub-declared del propio motor (alias de frontmatter, stubs
declarados): usa
prompts/audit_portability_legacy_surface.md. Si el ambito de esta auditoria esmotor, Fase 0 y Fase 3 del nucleo ya declaran como dedupicar con ese prompt si ambos aplican a la vez. - Se quiere optimizar la VELOCIDAD de la suite de tests (no su valor ni el
codigo de produccion): usa
skills/suite-optimization.
Workflow (apunta al nucleo, no lo repite)
- Leer
prompts/repo_audit_multiagent.mdentero. - Ejecutar sus Fases 0-6 en orden, segun las define el nucleo (Secciones 1-7 del nucleo), sin excepcion ni abreviacion.
- Entregar el informe segun el formato que define la Seccion 8 del nucleo.
Distincion con skills hermanas
code-audit/test-audit: recolectores de UNA sola fase, sin fan-out multiagente ni bucle adversarial.repo-auditlos invoca en su Fase 1 (dead-code), no los duplica.refactor-manager: ejecuta el cambio sobre UN archivo ya identificado. Es el consumidor de los follow-ups derepo-auditen Fase 6, no decide que auditar.audit_portability_legacy_surface.md: auditoria legacy ACOTADA al propio motor (naming/alias/stubs). Complementaria, no sustituible.
Constraints
- NUNCA re-declarar aqui ningun criterio normativo del nucleo (gate de
sostenibilidad, composicion del bucle, presupuesto, condicion de
ejecucion de Fase 6, formato de salida) — todos viven SOLO en
prompts/repo_audit_multiagent.md, esta skill solo remite a sus secciones. - Si el nucleo diverge de esta skill, prevalece el nucleo — corregir esta skill, no el nucleo.
References
references/lane-examples.md— ejemplos de declaracion de lanes para repos Python puros vs multi-lenguaje.
Version: 2.3.0 (coincide con prompt v2.3) Autor: agent-system Ultima actualizacion: 2026-10-20 (actualizado a contract_id v2, sync con prompt v2.3)