gestionar-decisiones-con-evidencia

Crear, revisar, explicar, exportar, verificar o comprobar la actualidad de decisiones de ingeniería respaldadas por evidencia con Proofline. Ideal para ADRs, decisiones arquitectónicas, citas exactas de fuentes, revisión de procedencia, comprobaciones de decisiones obsoletas, Paquetes de Evidencia de Decisiones portátiles y solicitudes de explicación sobre qué evidencia inmutable justificó una decisión.

¿Qué es gestionar-decisiones-con-evidencia?

Esta habilidad permite a un agente de IA gestionar decisiones de ingeniería respaldadas por evidencia utilizando la herramienta Proofline. Su propósito es garantizar que cada decisión esté vinculada a fuentes inmutables, versiones específicas y fragmentos exactos citados, manteniendo una distinción clara entre la evidencia fuente, el juicio de ingeniería y una verificación determinista de integridad. Es especialmente útil para Arquitectura de Registro de Decisiones (ADR), revisiones de procedencia, comprobaciones de actualidad de decisiones, y exportación de Paquetes de Evidencia de Decisiones (DEPs) portátiles. Soporta plataformas como Claude Code, Cursor y Codex, y su flujo de trabajo incluye la identificación del alcance local, el uso de comandos específicos de Proofline, la previsualización de cambios antes de escrituras, y la generación de un resumen de decisión con estado de vigencia, limitaciones y próxima revisión. La habilidad impone salvaguardas estrictas: no tratar una cita como prueba de corrección de la decisión, no sobrescribir archivos sin autorización explícita (--force), y no exponer contenido fuente, rutas locales, credenciales o paquetes de evidencia más allá de la audiencia seleccionada por el usuario.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thangldw/proofline/tree/main/skills/manage-evidence-decisions

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

  1. Prefiere un proofline existente en .venv/bin/proofline dentro del plugin o el checkout del proyecto.
  2. Si falta, explica que Proofline requiere Python 3.11+ y dependencias locales. Pregunta antes de instalar dependencias; no ejecutes make setup en silencio.
  3. Mantén PROOFLINE_HOME en un directorio local aprobado por el usuario. No lo apuntes a un directorio compartido o sensible sin confirmación.

Flujo de trabajo

  1. Resuelve la decisión o paquete de evidencia solicitado por el usuario y el alcance local exacto.
  2. 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.
  3. Usa el comando de Proofline más específico de references/commands.md.
  4. 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.
  5. Informa directamente sobre citas no resueltas, evidencia modificada, falta de procedencia y fallos de integridad.
  6. 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.

Skills relacionados