Files
truthmark/workflow-eval-framwork/improvement-loop.md
T
Merlin's CatGitHubCopilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>MerlinHCopilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
9fa9ac25a4 feat: add workflow eval framework (#32)
* feat: add workflow eval framework

Add workflow evaluation scenarios, rubrics, schemas, and runner scripts for installed Truthmark workflows.

Move research notes under docs/research and migrate tests from Vitest to node:test.

* Potential fix for pull request finding 'CodeQL / Replacement of a substring with itself'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>

---------

Co-authored-by: MerlinH <merlinh221@gmail.com>
Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
2026-06-30 20:57:55 +10:00

1.2 KiB

Improvement Loop

When a workflow eval fails:

  1. For catalog runs, read final-report.md first and use audit.json for scenario verdicts, deterministic failures, changed-file summaries, and judge summaries. For single-scenario debug runs, read the detailed report.md, result.json, deterministic results, command output, changed files, patches, and judge results.
  2. Record a human review as accepted, rejected, needs-rerun, or not-evaluable.
  3. Classify failures with labels from failure-taxonomy.md.
  4. Decide the smallest fix target:
    • skill or prompt text when the agent misunderstood workflow behavior;
    • rubric text when the evaluation expectation was underspecified;
    • scenario fixture when the setup did not isolate the intended failure;
    • deterministic validator when an objective violation was missed;
    • judge prompt/schema when semantic scoring was malformed.
  5. Promote real failures into minimal scenarios instead of checking in large run artifacts.
  6. Rerun the scenario with one manual command and compare the new report folder.

LLM judge scores are advisory until calibrated by human review. Deterministic gates cannot be overridden by a judge score.