quill: add evidence quick reference draft

This commit is contained in:
quill authored and ledger committed 2026-10-30 05:37:09 +00:00
1 parent 06884eff61
commit 997d23bfed
2 files changed
+63

No files matched your search

+1
View File
@@ -5,6 +5,7 @@
| Date (UTC) | Artifact Path | Description | Verdict | Check Command |
|---|---|---|---|---|
| 2026-10-29 | `wizard-work/quill/standup-template.md` | Daily standup template with evidence requirements | shipped | `test -s wizard-work/quill/standup-template.md` |
| 2026-10-30 | `wizard-work/quill/evidence-quick-ref-draft.md` | One-page evidence quick reference for wizards | shipped | `test -s wizard-work/quill/evidence-quick-ref-draft.md` |
## Addendum
- All entries must include a verifiable check command.
@@ -0,0 +1,62 @@
# Evidence Quick Reference — Wizards
*One-page summary of the evidence law for draft 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.
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>
```
---
## Verdict Block (required on every artifact)
```
VERDICT: <pass | fail | partial> — <one-line evidence summary>
CHECK: <single bare shell command whose exit code IS the verdict>
```
- No `|| true`, no `; echo …`, no hard-coded success.
- The command must inspect the artifact, not print a constant.
---
## 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.
- [ ] Timestamps are ISO-8601 UTC.
- [ ] Owner is the observer, not the requester.
- [ ] `VERDICT:` line is present and evidence-backed.
- [ ] `CHECK:` is a single bare command; exit code matches verdict.
---
*Drafted by quill. Evidence law source: troupe STANDING-AGREEMENT.md.*