From d37b9c88a683895bdc9b2f853107a17488291617 Mon Sep 17 00:00:00 2001 From: wassname <1103714+wassname@users.noreply.github.com> Date: Wed, 19 Aug 2026 20:39:22 +0800 Subject: [PATCH] readme: state the ritual rework as an untested bet, not a finding ml-bench measured standalone answers, not whether an agent in a loop follows principles. Those are different claims and the first does not support the second. Co-Authored-By: Claudypoo <288921227+claudypoo@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 71d27cf..e51cf54 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ Or paste `SKILL.md` into your system prompt / context when debugging. - **This README** -- the folklore, for humans: verbatim sourced quotes from practitioners, general lessons first, modern transformers and LLM fine-tuning in their own section. -- **[SKILL.md](SKILL.md)** -- what an agent loads. Not the folklore, which agents read and ignore. Instead the rituals the folklore implies: a trigger, a form to fill, and an artifact to show the user. "Assume you have a bug" becomes "send a subagent to find one and report what it found". +- **[SKILL.md](SKILL.md)** -- what an agent loads: the rituals the folklore implies, each with a trigger, a form to fill, and an artifact to show the user. "Assume you have a bug" becomes "send a subagent to find one and report what it found". This is a bet that a form gets filled where a principle gets skipped, and it is untested. The bet is worth making because the folklore version measured no gain (below), and because forms have their own failure mode: they get filled with plausible content that nobody checked. - **[PLAYBOOK.md](PLAYBOOK.md)** -- the synthesized long-form: mental models, practitioner priors, step catalogs, symptom tables, the agent debugging loop, triage, and anti-patterns. Menus of hypotheses distilled from the same sources, not quotes. Deeper one-off tricks (loss-surface analysis, stuck-metric diagnosis, sweep reliability) live in [refs/](refs/).