From 26def52aad4409dc47b556de5eb1bd422f601ec8 Mon Sep 17 00:00:00 2001
From: quill <quill@agents.invalid>
Date: Fri, 30 Oct 2026 00:05:25 +0000
Subject: [PATCH] quill: add evidence-quick-ref-draft.md

---
 wizard-work/quill/evidence-quick-ref-draft.md | 47 +++++++------------
 1 file changed, 17 insertions(+), 30 deletions(-)

diff --git a/wizard-work/quill/evidence-quick-ref-draft.md b/wizard-work/quill/evidence-quick-ref-draft.md
index 4bf2077..fe0ddfc 100644
--- a/wizard-work/quill/evidence-quick-ref-draft.md
+++ b/wizard-work/quill/evidence-quick-ref-draft.md
@@ -1,31 +1,32 @@
-# Evidence Quick Reference — Wizards
-*One-page summary of the evidence law for draft artifacts.*
+# Hermes Agent Evidence Quick-Ref (Draft)
+*Concrete commands and rules for producing evidence-backed artifacts.*
 
 ---
 
-## The Law (3 rules)
-
-1. **Prepared ≠ Observed.** A plan, a stub, or a "will do" is not a build, a test, or a result.
+## The Law
+1. **Prepared ≠ Observed.** A plan, stub, or "will do" is not a build, test, or result.
 2. **Executor ≠ Witness.** "The executor said done" is not "a test passed."
 3. **Evidence on every claim.** Every claim must attach a source, a timestamp, and an owner.
 
 ---
 
-## Claim Anatomy
-
-```
-[CLAIM] <one sentence, no vague language>
-[SOURCE] <file path | URL | tool call | person + timestamp>
-[MEASURED] <command / observation> | [CLAIMED] <label + falsifier>
-[OWNER] <who observed, not who requested>
-```
+## Command Reference
+| Goal | Tool | Example |
+|------|------|---------|
+| Read file | `read_file` | `read_file(path="/root/.hermes/wizard-outputs/quill/evidence-quick-ref-draft.md")` |
+| Search files | `search_files` | `search_files(pattern="VERDICT", path="/root/.hermes/wizard-outputs/quill")` |
+| Edit file | `patch` | `patch(path="...", old_string="...", new_string="...")` |
+| Write file | `write_file` | `write_file(path="...", content="...")` |
+| Run shell | `terminal` | `terminal(command="git status")` |
+| Run Python | `execute_code` | `execute_code(code="print('ok')")` |
+| Web search | `web_search` | `web_search(query="Hermes Agent evidence law")` |
+| Web extract | `web_extract` | `web_extract(urls=["https://hermes-agent.nousresearch.com/docs"])` |
 
 ---
 
-## Verdict Block (required on every artifact)
-
+## Verdict Block
 ```
-VERDICT: <pass | fail | partial> — <one-line evidence summary>
+VERDICT: pass | fail | partial — <one-line evidence summary>
 CHECK: <single bare shell command whose exit code IS the verdict>
 ```
 
@@ -34,21 +35,7 @@ CHECK: <single bare shell command whose exit code IS the verdict>
 
 ---
 
-## Common Failures
-
-| Failure | Fix |
-|---|---|
-| "Seems likely" | Replace with measured value or label `CLAIMED` + falsifier |
-| No source | Add `[SOURCE]` with exact path, URL, or tool call |
-| No timestamp | Add ISO-8601 UTC observation time |
-| Owner is the requester | Owner must be the witness who observed the evidence |
-| Tautological CHECK | Make the command inspect the artifact (e.g. `grep -c 'VERDICT:' file`) |
-| Stale claim (>24 h) | Flag and re-measure, or note the staleness |
-
----
-
 ## Minimal Checklist
-
 - [ ] Every claim has `[SOURCE]`.
 - [ ] Every measured result has the reproduction command.
 - [ ] Every claimed-only item is labeled `CLAIMED` with a falsifier.