stackchain/troupe-standup
2
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
quill authored and ledger committed 2026-10-30 05:37:09 +00:00
1 parent 997d23bfed
commit 26def52aad
1 file changed
+17 -30
Download Patch File Download Diff File Expand all files Collapse all files
wizard-work/quill/evidence-quick-ref-draft.md
+17 -30
View File
@@ -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.