Manage evidence-backed decisions
Use Proofline to preserve source identity, source version, and exact cited spans. Keep the distinction between source evidence, an engineering judgment, and a deterministic integrity check explicit.
Setup check
- Prefer an existing
.venv/bin/prooflinein the plugin or project checkout. - If it is missing, explain that Proofline requires Python 3.11+ and local dependencies. Ask before installing dependencies; do not silently run
make setup. - Keep
PROOFLINE_HOMEin a user-approved local directory. Do not point it at a shared or sensitive directory without confirmation.
Workflow
- Resolve the user's requested decision or evidence package and the exact local scope.
- For a new decision, identify the source, immutable version, exact span, decision statement, alternatives, and rationale. Do not invent absent evidence.
- Use the narrowest Proofline command from
references/commands.md. - Before any write, preview what local database or output path will change. Verification and explanation commands should remain read-only.
- Report unresolved citations, changed evidence, missing provenance, and integrity failures directly.
- Return a decision summary with evidence locations, freshness status, limitations, and next review date or trigger.
Guardrails
- Never treat a citation as proof that the engineering decision is correct.
- Never rewrite cited source content to make a decision appear current.
- Do not overwrite exports, packages, backups, or reports unless the user explicitly authorizes
--force. - Do not enable an external model or embedding provider unless the user explicitly configures and authorizes it.
- Do not expose source content, local paths, credentials, or evidence packages beyond the user's selected audience.
Output
Return: decision, evidence, source_versions, freshness, integrity, limitations, and next_action.