Reference — Source Documents & Figures
The knowledge tree is a synthesis. This is the map back to the primary material, all stored in ../../source-docs/.
Documents
| File | What it is | Status |
|---|---|---|
ALP_Workflow_Recommendations_v3.md |
The v3 strategic + tactical recommendations across 5 roles. Authoritative. | Current (May 11, 2026) |
enhanced_dashboard_user_stories_v2.md |
Dashboard user stories for IS / PM / LA. Predates v3. | Partially stale — see note |
Staleness note: the user-stories doc uses the 7-stage cycle (Activate/Reinforce/Repeat) and only 3 dashboards. v3 supersedes it: 6 stages, 5 roles. The acceptance criteria in the user-stories doc remain useful and are mapped in user-story-map; the stage names are stale. See cycle naming.
Recommendations doc — section index
| § | Title | Synthesized into |
|---|---|---|
| 1 | Executive summary | overview |
| 2 | Strategic diagnosis (6 gaps) | overview |
| 3 | The unifying frame — 6-stage cycle | applied-learning-cycle |
| 4 | Integrated cross-role view | applied-learning-cycle, roles |
| 5a–5e | Revised role flows | roles-and-goals |
| 6.1 | Intervention layer | intervention-layer |
| 6.2 | Time-to-apply metrics | time-to-apply-metrics |
| 6.3 | Timed content release | content-visibility-states |
| 6.4 | Patterns, not individuals | pulse-check |
| 6.5 | Next-engagement (client-first) | business-loop |
| 6.6 | Briefing Report in-platform | open-questions |
| 7 | Client perspective (before/after) | overview |
| 8 | Company perspective (before/after) | business-loop |
| 9 | Implementation roadmap | implementation-roadmap |
| App. A | How to read the flowcharts | below (legend) |
| App. B | Editing the flowcharts (Mermaid) | below |
| App. C | v3 user-story → flow mapping | user-story-map |
Figures (flowchart images, in ../../source-docs/media/)
| Image | Flow | Notes |
|---|---|---|
image1.png |
Integrated cross-role view (Figure 1) | 5 roles × 6 phases + intervention band. The spine. |
image2.png–image4.png |
Participant flow Parts 1–3 | onboarding → Prepare → … → Adjust; the 48h gate |
image5.png–image8.png |
Instructional Strategist flow Parts 1–4 | intro video gate, Context Brief, mark-complete, interventions |
image9.png–image12.png |
Learning Administrator flow Parts 1–4 | School Context Profile gate, Cohort Snapshot, outcomes |
image13.png–image16.png |
Platform Manager flow Parts 1–4 | engagement setup, video approval, publishing, analytics |
(Content Creator has no flow image — flow TBD, see content-creator-role.)
Flowchart legend (Appendix A)
| Element | Meaning |
|---|---|
| Green ovals | Start / end terminator |
| Light-blue rounded box, bold | Applied Learning Cycle phase header |
| Light-green rounded box | Standard action / system step |
| Light-purple rounded box | New in v3 — added or substantially changed |
| Yellow diamond | Decision gate (branches) |
| Orange rounded box | Automated nudge / intervention (fires on absence) |
| Solid arrow | Mandatory next step |
| Dashed arrow | Cross-role read or loop-back |
Editing the flowcharts (Appendix B)
The recommendations doc references Mermaid source files in a mermaid_sources/ folder (01_participant_flow.mermaid … 05_integrated_cross_role_view.mermaid). These were not included in the converted package — only the rendered PNGs are present. If iteration on the diagrams is needed, request the .mermaid sources. They paste into mermaid.live, Lucidchart (Import → Mermaid), Miro (Mermaid plugin), or a ```mermaid block.