quill: add evidence-quick-ref-draft.md

wizard-work/quill/evidence-quick-ref-draft.md

@@ -1,31 +1,32 @@
-# Evidence Quick Reference — Wizards
+# Hermes Agent Evidence Quick-Ref (Draft)
-*One-page summary of the evidence law for draft artifacts.*
+*Concrete commands and rules for producing evidence-backed artifacts.*
 
 ---
 
-## The Law (3 rules)
+## The Law
-
+1. **Prepared ≠ Observed.** A plan, stub, or "will do" is not a build, test, or result.
-1. **Prepared ≠ Observed.** A plan, a stub, or a "will do" is not a build, a test, or a 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
+## Command Reference
-
+| Goal | Tool | Example |
-```
+|------|------|---------|
-[CLAIM] <one sentence, no vague language>
+| Read file | `read_file` | `read_file(path="/root/.hermes/wizard-outputs/quill/evidence-quick-ref-draft.md")` |
-[SOURCE] <file path | URL | tool call | person + timestamp>
+| Search files | `search_files` | `search_files(pattern="VERDICT", path="/root/.hermes/wizard-outputs/quill")` |
-[MEASURED] <command / observation> | [CLAIMED] <label + falsifier>
+| Edit file | `patch` | `patch(path="...", old_string="...", new_string="...")` |
-[OWNER] <who observed, not who requested>
+| 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.