Skip to content

v2.6.0 — Evidence-tracking for /work

Choose a tag to compare

@alexherrero alexherrero released this 23 May 19:28
· 354 commits to main since this release

Minor — second non-doc-only paired pair in the recent run (after v2.5.0). Harness ships the /work §5b spec amendment documenting the contract for the new evidence-tracker base hook in agent-toolkit v0.12.0.

What changes for operators

With agent-toolkit installed + evidence-tracker hook in place:

  • /work task closeouts gain a deterministic verification gate.
  • Hook fires PreToolUse on Read|Write|Edit.
  • Records reads (to .harness/.evidence-reads — gitignored, per-session ephemeral).
  • Blocks unmet-evidence [ ][x] flips with a helpful stderr message + 3 recovery paths.

Without those prerequisites: zero behavior change. Hook absent → no enforcement → /work runs as it always has.

Task-body conventions

Annotation Behavior
(omit) HEURISTIC — files under tests/ or spec/ with code extension, OR paths in **Verification:** text
**Evidence:** <glob-or-paths> Per-task override
**Evidence:** none — <rationale> Explicit opt-out (rationale mandatory)

What's new on this side

  • harness/phases/03-work.md §5b — new section between §5 Run-gates + §6 Iterate-on-failures. Documents hook trigger table + 3 task-body conventions + 3 recovery paths + 5 graceful-skip conditions. ~75 lines.
  • templates/PLAN.md — task-block template gains optional **Evidence:** field hint.
  • Sub-letter pattern (§5b) preserves integer §-numbering established in plan #8 — no cascading wiki line-anchor breakage. The single incoming ref to §10 stays valid.

Locked design calls

Q Decision
Q1 Evidence resolution HYBRID (heuristic + per-task override + explicit opt-out)
Q2 Granularity Per-task PLAN.md [ ][x] flips ONLY
Q3 Bypass EXPLICIT OPT-OUT only

Full rationale + 4 load-bearing assumptions in toolkit-side ADR 0009. Operator-facing how-to at Use The Evidence-Tracker Hook.

Coordinated-release ordering

Paired with toolkit v0.12.0 (tagged first; this release notes URL-link back to it). 6th consecutive paired-release pair.

Full changelog

v2.5.0..v2.6.0. See CHANGELOG.md.