Best Learning Framework

Best Learning Framework

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

1. What we optimize for

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.

2. What we take from research

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.

3. Core loop

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”.

4. Lesson card schema

1. objective — One verb phrase; what they can do after.
2. why — Cost of skipping (time, money, eligibility, lost bid).
3. steps — Default 3–6 concrete actions; unique first step; name the surface.
4. mistakes — Default 1–3 traps people actually hit.
5. practice — Same-day / same-week finish line.
6. tool — Link out. Never bury the lesson in the tool.

Forbidden: generic “Open the surface where…” steps · feature soup without a problem · win/loss fiction · voice scripts in subscriber UI.

5. Keep people interested

Attention

• One job per lesson; open with a problem they already feel.
• Academy first screen = school promise + lessons — not a stats dashboard.

Relevance

• Free / Basic / Pro Schools = readiness stages, not vanity catalogs.
• Path: eligibility → market → find/qualify → capture → propose → compete/renew.
• Pick by current problem, not feature alphabet.

Confidence

• Small wins first; Bid Coach Level 1 → 2 → 3 (depth optional).
• Progress = real checkmarks, not page views.

Satisfaction

• Practice ends in an artifact (saved search, vault block, matrix row).
• Celebrate actions, not binge reading. Be honest about Notify-me / Free.

Mechanics that earn their keep

• Micro-units (~5–12 min) · one obvious next action · one-click tool handoff
• Mistake lists instead of quiz engines · spaced return via digest / Coach
• Avoid shame streaks, leaderboards, dark “complete 100%,” chat that replaces doing

6. Keep people learning

Reading ≠ learning. Learning = changed performance on the next notice.

1. Retrieval by doing — practice forces recall.
2. Spacing — schools + weekly digest + Coach beats one binge Saturday.
3. Interleaving — mix find → qualify → capture across the week.
4. Feedback from reality — amendments, fit factors, Win patterns, empty states.
5. Prior experience — NAICS, certs, vault facts they already have.
6. Self-direction — filter by school/phase; skip what they know.
7. Transfer check — opened the tool and finished practice = only completion that counts.

Habit recipe: one lesson → one practice → one pipeline update → stop. Come back tomorrow or after the next alert.

7. School design

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.

8. Writing checklist

• Objective starts with a verb and names a real outcome
• Why names a failure mode the learner recognizes
• Steps are unique and mention the real UI
• Practice is finishable in one sitting
• Mistakes are specific, not moralizing
• Tool link works
• No teaching text inside tool screens
• No secrets, Stripe fantasy, or win/loss fiction

9. Lightweight measurement

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.

10. One-line for agents

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 scan.fedm8.com/learn.html

Change log

Who changed this framework, when, and why. Rows before 2026-11-08 predate the log, so no reason was recorded.

When (UTC)	Who	Version	What	Why
2026-11-08 16:15	1099:claude-chat-c1d3	v2	Added north star + hard gates header; Added a default-with-exception on the DO rule, a writer-only note tying learner wording to Textbook Teacher, and one short example lesson card.; Replaced 'vault-grounded Assist' with 'Assist that cites vault facts' in the Pro school row.; loosened to defaults: 3-6 steps and 1-3 mistakes per card; DO must be in a real tool; Teaching never lives inside tool UIs	Owner-requested north-star review (2026-11-08): Readers got stuck when no tool action fit; core says to apply Textbook Teacher; no example existed.; Textbook Teacher bans 'grounded' as UI wording; the school row feeds lesson copy.; rules loosened so agents can try better ideas where no safety, money, legal or data gate applies
2026-08-01 09:18	1099:cowork-fable	v1	Best Learning Framework	not recorded (before change log)