duo-rules-and-heuristics
Decide whether to explain something at all, when the explanation should land, and how to compress a rule into something a user can actually execute under pressure. Use when you are writing docs, tooltips, onboarding copy, error messages, a runbook or a training guide and are not sure anyone will absorb it. Triggers on phrases like should we document this or let people figure it out, nobody reads our docs, users keep making the same mistake, how do I explain this simply, our error messages do not help, turn this table into something usable, ship a rule of thumb, is it OK that the shortcut is only 90 percent right, how do I know if they actually learned it, our expert cannot explain what they do, write the spec from how the team actually works.
- Version
- 2.0.0
- License
- MIT
Pinned to revision 78072c9528fb, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/duo-rules-and-heuristics/SKILL.md
- skills/duo-rules-and-heuristics/references/a-second-representation-does-what-more-practice-cannot.md
- skills/duo-rules-and-heuristics/references/explanation-lands-at-the-moment-of-the-error.md
- skills/duo-rules-and-heuristics/references/fix-the-model-instead-of-memorising-the-exception.md
- skills/duo-rules-and-heuristics/references/give-them-a-handle-they-can-hold-under-pressure.md
- skills/duo-rules-and-heuristics/references/let-them-induce-it-from-volume-then-confirm.md
- skills/duo-rules-and-heuristics/references/make-the-invisible-error-observable.md
- skills/duo-rules-and-heuristics/references/mistakes-are-the-signal-not-the-defect.md
- skills/duo-rules-and-heuristics/references/name-the-arbitrary-and-kill-the-folk-theory.md
- skills/duo-rules-and-heuristics/references/ship-the-shortcut-with-its-coverage-rate.md
- skills/duo-rules-and-heuristics/references/the-practitioner-cannot-state-their-own-rule.md
- skills/duo-rules-and-heuristics/references/turn-the-table-into-a-procedure.md
- skills/duo-rules-and-heuristics/references/two-memory-systems-explanation-loads-the-wrong-one.md
- skills/duo-rules-and-heuristics/references/where-explicit-instruction-earns-its-place.md
Every link opens the file at its source, pinned to the revision this page describes.