mrgnhnt96/impa-review

Revisión Impa

Inicia una revisión de documentación técnica en su propia sesión bloqueada y devuelve el informe. Funciona con cualquier documentación, sin necesidad de un escritor involucrado. Solo hallazgos: nunca edita la documentación ni el código, incluso si se le pide "revisar y corregir".

No leas method.md, checklist.md ni nada en reference/. El revisor los carga por sí mismo, y mantenerlos fuera de esta sesión es el objetivo.

Si escribiste o cambiaste esta documentación en esta sesión, sigue round.md en su lugar.

Pasos

1. Escribe el brief en "${TMPDIR:-/tmp}"/impa/<project>/direct-<n>/brief-1.md, con <n> uno por encima de la última carpeta allí. Contiene hechos y nunca tu opinión, así que no leas la documentación primero:

   Revisar documentación técnica mediante el método de revisión impa. No editar ningún archivo.
   
   Proyecto: <ruta absoluta>
   Documentación: <rutas absolutas que el usuario nombró, o "encontrarlas">
   Otras fuentes: <rutas absolutas de dependencias o repositorios hermanos que el usuario nombró, o "ninguna">
   Plan de documentación: <ruta absoluta a .impa/plan.md si el proyecto tiene uno, o "ninguno">
   Solicitud de esta ronda, en palabras del usuario: "<prompt>"
   Alcance: <lo que el usuario nombró, o "todo el conjunto de documentación">
   Aún abierto de la última ronda: ninguno
   Entregado a una persona: ninguno
   
   Devuelve el informe del método. Nombra cualquier problema fuera del alcance que veas, pero no vayas buscándolo.
   

2. Inícialo en segundo plano. Agrega --add-dir por cada ruta bajo Otras fuentes:

   impa review --brief <brief> --add-dir <project>
   

   Un conjunto grande de documentación puede necesitar --timeout <minutos>, que por defecto es 20.

3. Si el comando sale con 1, la revisión no terminó, y cualquier review-1.md está parcial. Sin review-1.json, o con un error que comience con Error: spawn, no pudo iniciar: lee lo que el comando imprimió, luego usa el plan de respaldo. De lo contrario, ejecútalo una vez más con un --timeout mayor. Si eso también falla, dile al usuario que no se completó ninguna revisión, con el error de review-1.json.

4. De lo contrario, lee solo review-1.md, junto al brief. Devuélvelo tal como está escrito, con el costo de la línea que el comando imprimió, y detente. No actúes sobre los hallazgos a menos que el usuario lo pida: corregir es un paso separado, después de este. Si verdict está vacío en review-1.json, no hay línea de veredicto, así que di que el informe no es fiable.

Si impa no está en el PATH o no puede iniciar, usa el plan de respaldo en la sección 3 de round.md. Si eso tampoco puede iniciar, dile al usuario que no se ejecutó ninguna revisión. Nunca revises en esta sesión.