repo-proof

---

name: repo-proof description: Usa esta habilidad cuando un usuario necesite demostrar que el README de un repositorio o las instrucciones de lanzamiento funcionan desde un clon fresco: auditar pasos de instalación/ejecución/prueba/demo, crear evidencia en entorno limpio, clasificar fallos en README/script/config/paquete, generar correcciones mínimas o añadir una GitHub Action para la verificación de veracidad del README. No usar para escritura ordinaria de README, revisión genérica de código, listas de verificación amplias de QA o tareas que no requieran evidencia basada en un clon fresco del repositorio.

RepoProof

Prueba el repositorio desde el punto de vista de un nuevo usuario. Trata el README como un contrato, no como una sugerencia.

Flujo de trabajo predeterminado

1. Ejecuta node scripts/repoproof.mjs audit . --output repoproof-output.
2. Lee repoproof-output/repoproof-report.json antes de sacar conclusiones.
3. Si el usuario permite explícitamente la ejecución, ejecuta node scripts/repoproof.mjs prove . --allow-exec --output repoproof-output.
4. Si se solicitan correcciones, ejecuta node scripts/repoproof.mjs fix . --dry-run --output repoproof-output e inspecciona repoproof-fixes.patch.
5. Reporta solo lo que la evidencia respalda. Marca las afirmaciones no probadas como no probadas.

Reglas de seguridad

• El modo de auditoría es el predeterminado y no debe ejecutar código del repositorio.
• El modo de prueba requiere la aprobación explícita del usuario con --allow-exec o un ejecutor de CI.
• Nunca publiques, despliegues, hagas push, fusiones ni leas secretos del usuario.
• Nunca afirmes un sandboxing fuerte sin un contenedor, VM o sandbox de SO real.
• Usa scripts deterministas para la recolección y redacción de evidencia.

Referencias

• Lee references/workflow.md para el flujo completo de auditoría/prueba/corrección.
• Lee references/safety-model.md antes de ejecutar código del repositorio.
• Lee references/extraction-rules.md cuando la extracción de pasos del README sea ambigua.
• Lee references/fix-policy.md antes de proponer ediciones.
• Lee references/evidence-schema.md al interpretar informes.
• Lee references/github-action.md antes de añadir CI.
• Lee references/platform-notes.md para diferencias entre Windows, macOS y Linux.