Gestionar decisiones respaldadas por evidencia
Usa Proofline para preservar la identidad de la fuente, la versión de la fuente y los fragmentos exactos citados. Mantén explícita la distinción entre la evidencia fuente, un juicio de ingeniería y una verificación determinista de integridad.
Verificación de configuración
- Prefiere un
prooflineexistente en.venv/bin/prooflinedentro del plugin o el checkout del proyecto. - Si falta, explica que Proofline requiere Python 3.11+ y dependencias locales. Pregunta antes de instalar dependencias; no ejecutes
make setupen silencio. - Mantén
PROOFLINE_HOMEen un directorio local aprobado por el usuario. No lo apuntes a un directorio compartido o sensible sin confirmación.
Flujo de trabajo
- Resuelve la decisión o paquete de evidencia solicitado por el usuario y el alcance local exacto.
- Para una decisión nueva, identifica la fuente, la versión inmutable, el fragmento exacto, la declaración de decisión, las alternativas y la justificación. No inventes evidencia ausente.
- Usa el comando de Proofline más específico de
references/commands.md. - Antes de cualquier escritura, previsualiza qué base de datos local o ruta de salida cambiará. Los comandos de verificación y explicación deben permanecer de solo lectura.
- Informa directamente sobre citas no resueltas, evidencia modificada, falta de procedencia y fallos de integridad.
- Devuelve un resumen de la decisión con ubicaciones de la evidencia, estado de vigencia, limitaciones y la próxima fecha o desencadenante de revisión.
Salvaguardas
- Nunca trates una cita como prueba de que la decisión de ingeniería es correcta.
- Nunca reescribas el contenido citado de la fuente para que una decisión parezca actual.
- No sobrescribas exportaciones, paquetes, copias de seguridad o informes a menos que el usuario autorice explícitamente
--force. - No habilites un modelo externo o proveedor de incrustaciones a menos que el usuario lo configure y autorice explícitamente.
- No expongas contenido fuente, rutas locales, credenciales o paquetes de evidencia más allá de la audiencia seleccionada por el usuario.
Salida
Devuelve: decision, evidence, source_versions, freshness, integrity, limitations y next_action.