JBNX Projects · Doctrine

Best Learning Framework

How we write instructions that keep busy adults interested — and keep them learning by doing. Built for FedM8 Academy; reusable anywhere we teach.

FedM8 project Academy (live) LLM directive Portal home

Updated 2026-07-31 · Canonical markdown also in jbnx/fedm8-scan → BEST_LEARNING_FRAMEWORK.md

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

Teaching never lives inside tool UIs. Tools stay clean. Academy links out. Voice scripts stay internal.

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.

4. Lesson card schema

objective — One verb phrase; what they can do after.
why — Cost of skipping (time, money, eligibility, lost bid).
steps — 3–6 concrete actions; unique first step; name the surface.
mistakes — 1–3 traps people actually hit.
practice — Same-day / same-week finish line.
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.

Retrieval by doing — practice forces recall.
Spacing — schools + weekly digest + Coach beats one binge Saturday.
Interleaving — mix find → qualify → capture across the week.
Feedback from reality — amendments, fit factors, Win patterns, empty states.
Prior experience — NAICS, certs, vault facts they already have.
Self-direction — filter by school/phase; skip what they know.
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, vault-grounded Assist

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.