quill: add evidence quick reference draft
This commit is contained in:
1 parent
06884eff61
commit
997d23bfed
2 files changed
+63
No files matched your search
@@ -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.*
|
||||
Reference in new issue
Block a user