North star: Busy owners finish one real tool action per lesson, return for the next, and gain skill that shows up in a live bid. Hard gates (never bend): no fake pWin or invented past performance; no win/loss fiction; no secrets in lessons; plan gates (Free readiness never requires Pro); owner-approved copy and learner-facing wording per Textbook Teacher Everything else is a default. Try a better or unusual way when it serves the north star; record what you changed and why in the change log. Change log: bottom of this page (who, when, why).
How we write instructions that keep busy adults interested — and keep them learning by doing. Built for FedM8 Academy; reusable anywhere we teach.
Updated 2026-07-31 · Canonical markdown also in jbnx/fedm8-scan → BEST_LEARNING_FRAMEWORK.md
Links: FedM8 project · Academy (live) · LLM directive · Portal home
Busy owners will not finish a course. They will finish one useful action that moves a real bid forward.
| Outcome | Meaning |
|---|---|
| Start | Open a lesson without a 45-minute lecture tax |
| Finish | Objective → practice the same day |
| Transfer | Work happens in the tool, not only in Academy |
| Return | Come back for the next small win |
| Honest skill | No fake pWin, no invented past performance |
Default: teaching does not live inside tool UIs. Tools stay clean. Academy links out. Voice scripts stay internal. Glossary taps on hard words (Textbook Teacher) are the one in-tool exception.
| Source | Keep |
|---|---|
| Knowles (andragogy) | Why first, experience, problem-centered, self-direction |
| Merrill (First Principles) | Problem → activate → show → do → integrate |
| Gagné | Attention, objective, guidance, practice, feedback, transfer |
| Keller ARCS | Attention, Relevance, Confidence, Satisfaction |
| Cognitive load / microlearning | One objective, short units, strip fluff |
| Spaced + retrieval practice | Revisit later; recall by doing, not re-reading |
| Deliberate practice | Specific goal, immediate attempt, visible mistakes |
We reject LMS theater: long modules, fake quizzes, and completion % without transfer.
HOOK → WHY → SHOW → DO → CHECK → RETURN
| Step | Job | FedM8 form |
|---|---|---|
| HOOK | Attention in <10s | Title + objective tied to a buyer problem |
| WHY | Relevance | What fails if you skip this |
| SHOW | Guidance | Ordered steps naming real screens |
| DO | Application | practice — one concrete tool action |
| CHECK | Feedback | mistakes — self-correct traps |
| RETURN | Spacing | Weekly practice · school path · Coach next step |
If a lesson cannot name a DO in a real tool (or official government site), it is not ready. Default; if a better practice form serves the north star (a saved decision, a checked eligibility fact), use it and log why.
The loop labels are for writers. Learners never see HOOK / WHY. Learner-facing words follow Textbook Teacher: no “grounded”, no “Honest” as a brand, no “theater” as chrome.
Example card: objective “Save a search for your NAICS code” · why “you scroll the whole firehose every day” · practice “a saved search exists before you close the tab”.
Forbidden: generic “Open the surface where…” steps · feature soup without a problem · win/loss fiction · voice scripts in subscriber UI.
Reading ≠ learning. Learning = changed performance on the next notice.
Habit recipe: one lesson → one practice → one pipeline update → stop. Come back tomorrow or after the next alert.
| School | Promise | Success |
|---|---|---|
| Free — Get ready | Legal + market literate before paying | SAM path, NAICS story, prime/sub clarity |
| Basic — Find & bid | Cut firehose; first compliant submit | Saved searches, bid/no-bid, Coach progress |
| Pro — Compete & streamline | Stop losing blind | Incumbents, matrices, Assist that cites vault facts |
Do not require Pro lessons to finish Free readiness. Improve copy from user friction — never regenerate generic templates.
| Signal | Healthy |
|---|---|
| Lesson → tool click | Happens often |
| Coach checks / practice done | Rising with usage |
| Saved searches after Basic lessons | Non-zero |
| Vault blocks before Assist package | Non-zero for Pro |
| “Where do I start?” support | Decreasing |
Vanity: time-on-page, lessons opened without practice.
HOOK → WHY → SHOW → DO → CHECK → RETURN
Adult problem first. Micro lesson. Real tool practice. Mistakes as feedback. Space the return. Teaching out of the tools. Voice scripts internal. Improve from friction — never from templates.
Posted for CEO / agents on projects.jbnx.io · FedM8 handover #/p/fedm8 · Product Academy remains separate at fedm8.com/learn
Every change to this framework: who, when, why. Source: agent_ops.catalog_changelog.
| When (UTC) | Who | Version | What | Why |
|---|---|---|---|---|
| 2026-11-15 10:35 | 1099:claude-chat-c1d3 | v3 | Academy links point to https://fedm8.com/learn. | Stale link: scan.fedm8.com/learn.html now 301s to fedm8.com/learn (checked live 2026-11-15); agents/learners should land on the live Academy in one hop. |
| 2026-11-09 10:36 | 1099:claude-chat-c1d3 | v2 | no change needed | Re-checked 2026-11-09: north star, hard gates and Textbook Teacher link hold; Academy and Textbook Teacher links resolve; no contradiction with core found. |
| 2026-11-08 16:15 | 1099:claude-chat-c1d3 | v2 | Best Learning Framework | Owner-requested north-star review 2026-11-08: north star + hard gates header, top fixes, non-safety rules loosened to defaults (details in the page change log) |
| 2026-08-01 09:18 | 1099:cowork-fable | v1 | Best Learning Framework | not recorded (before change log started 2026-11-08) |