UI Layout Mockups

What the teacher actually sees

Visual mockups of the three-zone workspace (locked in 08-milestone-architecture.md §3), the restructured left sidebar (D42), and the chat dock with context band (D34/D43).

Mockup 1 · Three-zone workspace (D41)

Left rail · Content area · Right rail

Left rail

Agents

Pedagogy

Practices

Skills

Memories

Curriculum

Course Outline

↳ Unit 1

↳ Module 1

↳ Module 2

↳ Unit 2

Knowledge Base

S-tier (primary)

A-tier (high-quality)

B-tier (supplementary)

Content area

units/unit-1/structure.md · finalized · v2

Unit 1 — Fractions Foundations

Big Idea: Ratios describe how quantities scale together. Students develop fluency with fraction notation, equivalent forms, and the formal operations of addition...

## Module 1 — Equivalent Forms

## Module 2 — Operations

## Module 3 — Real-world Applications

Right rail

Progress

Review

Milestones

M1 ✓→M2 3/5→M3 ⋯→M4 ⋯

Active work

agent:m2-unit-generator

Generating unit-2.md ⋯ 12s

queued

unit-3.md (waits on unit-2 APPROVED)

Mockup 2 · Left sidebar — three stacked sections (D42)

Agents · Curriculum · Knowledge Base

Agents

Prompt files (system + workspace overrides)

generators/

m1-pedagogy.md

system

m2-unit-generator.md

system

m3-module-generator.md

override

gates/

between-modules.md

system

unit-closure-m3.md

system

orchestrator/

chat/

kb/

review/

Workspace-first lookup. Ifprompts/<path>.mdexists in this course's workspace, it wins. Otherwise fall back to system.

Curriculum

finalized ∪ published

course-outline.md

published

pedagogy.md

finalized

Unit 1 — Fractions

published

Module 1 — Equivalent Forms

published

Lesson 1

published

Lesson 2

finalized

Module 2 — Operations

finalized

Unit 2 — Fraction Ops

draft

Filter rule (08-milestone-arch §3): onlyfinalized ∪ publishedartifacts appear. Drafts live in the Review tab until approved.

Knowledge Base

Per-teacher · LLM Wiki

S-tier — Primary sources

bc-curriculum-doc.md

ministry-standards.md

A-tier — High-quality

inquiry-pedagogy.md

kdu-framework.md

fppl-handbook.md

B-tier — Supplementary

math-blog-1.md

math-blog-2.md

Karpathy's LLM Wiki. Per-teacher git repo. Compounds across courses. Course sub-agents Task-invokekb/context-researcher.mdto query.

Mockup 3 · Chat dock — 3 fields (D33/D43)

Header · Chat input · Footer

Header — context band (D34)

Discussing: lesson-3.md

Judge's concern about example clarity · ported from review panel

Chat input — conversation with frontmatter per turn

teacher@p.degroot.ca

2026-05-27T15:00:12Z

The worked example on long division uses 4-digit numbers. Can we step down to 3-digit so it scaffolds from Module 1?

orchestrator

2026-05-27T15:00:18Z · tool_calls: [kb-lookup, lesson-read]

Good catch. Module 1 ended with 3-digit examples, so stepping back to 3-digit here preserves the scaffold. I'll propose two updated examples — preview them below.

Footer — action affordances

Resolve writes a chat-resolution comment to the artifact (LLM drafts, teacher confirms — D35). File as KB page converts the chat segment into a new kb/pages/<slug>.md via kb/librarian.md (D40 — Karpathy file-back).

Mockup 4 · Review panel state machine

ReviewCardState (existing universal review surface, D21)

State 1

NEW_DRAFT

Pipeline emission, never inspected

State 2

HAS_COMMENTS

Doc has ≥1 entry (teacher or evaluator)

State 3

REPLANNING

Submit-all dispatched; v(n+1) in flight

State 4

REVISED

Evaluator published v(n+1); awaiting teacher

State 5

APPROVED

Terminal; drops out of queue → finalized

V2 reuses this surface entirely. Only the projection layer changes — Review cards project from workspace files + git log + sidecar comment files (D21), not from learning_content+ teacher_comments rows.

Mockup 5 · Per-course workspace tree

What lives in each per-course git repo

<teacher>/<course-slug>/                  # per-course workspace
├── intake.md                             # teacher source context
├── course-outline.md                     # Strategy presentation artifact
├── pedagogy.md                           # Strategy pedagogical stance
├── preferences-voice.md
├── preferences-visual.md
├── preferences-presentation.md
├── non-negotiables-universal.md          # loaded from framework
├── non-negotiables-bc.md
├── units/
│   ├── unit-1.md                         # Structure unit description
│   └── unit-1/
│       └── modules/
│           ├── module-1.md               # Structure module plan
│           └── module-1/
│               ├── lessons/
│               │   ├── lesson-1.md       # Substance lesson artifact
│               │   └── lesson-2.md
│               └── assignments/
│                   └── assignment-1.md   # Substance assignment artifact
├── chat/                                 # teacher/context conversation
├── comments/                             # one file per comment (D23)
│   └── units/unit-1/structure.md/
│       ├── 2026-05-27T14-05-00Z-judge.md
│       └── 2026-05-27T14-08-00Z-teacher.md
├── quality-reports/                      # report-only evidence
│   ├── strategy/
│   ├── structure/
│   └── substance/
├── prompts/                              # workspace overrides for system prompts (D18)
│   └── ...
└── CLAUDE.md                             # workspace schema file

Decision Journey

The 18-round grilling session that produced this design.

Companion

Flow & Dependency Maps

State machine, dispatch flow, gate topology, KB structure.

Reference

Glossary

21 domain terms with precise definitions.

Back to design index

Left rail · Content area · Right rail

Left rail

Agents

Pedagogy

Practices

Skills

Memories

Curriculum

Course Outline

↳ Unit 1

↳ Module 1

↳ Module 2

↳ Unit 2

Knowledge Base

S-tier (primary)

A-tier (high-quality)

B-tier (supplementary)

Content area

units/unit-1/structure.md · finalized · v2

Unit 1 — Fractions Foundations

Big Idea: Ratios describe how quantities scale together. Students develop fluency with fraction notation, equivalent forms, and the formal operations of addition...

## Module 1 — Equivalent Forms

## Module 2 — Operations

## Module 3 — Real-world Applications

Right rail

Progress

Review

Milestones

M1 ✓→M2 3/5→M3 ⋯→M4 ⋯

Active work

agent:m2-unit-generator

Generating unit-2.md ⋯ 12s

queued

unit-3.md (waits on unit-2 APPROVED)

Agents · Curriculum · Knowledge Base

Agents

Prompt files (system + workspace overrides)

generators/

m1-pedagogy.md

system

m2-unit-generator.md

system

m3-module-generator.md

override

gates/

between-modules.md

system

unit-closure-m3.md

system

orchestrator/

chat/

kb/

review/

Workspace-first lookup. Ifprompts/<path>.mdexists in this course's workspace, it wins. Otherwise fall back to system.

Curriculum

finalized ∪ published

course-outline.md

published

pedagogy.md

finalized

Unit 1 — Fractions

published

Module 1 — Equivalent Forms

published

Lesson 1

published

Lesson 2

finalized

Module 2 — Operations

finalized

Unit 2 — Fraction Ops

draft

Filter rule (08-milestone-arch §3): onlyfinalized ∪ publishedartifacts appear. Drafts live in the Review tab until approved.

Knowledge Base

Per-teacher · LLM Wiki

S-tier — Primary sources

bc-curriculum-doc.md

ministry-standards.md

A-tier — High-quality

inquiry-pedagogy.md

kdu-framework.md

fppl-handbook.md

B-tier — Supplementary

math-blog-1.md

math-blog-2.md

Karpathy's LLM Wiki. Per-teacher git repo. Compounds across courses. Course sub-agents Task-invokekb/context-researcher.mdto query.

Header · Chat input · Footer

Header — context band (D34)

Discussing: lesson-3.md

Judge's concern about example clarity · ported from review panel

Chat input — conversation with frontmatter per turn

teacher@p.degroot.ca

2026-05-27T15:00:12Z

The worked example on long division uses 4-digit numbers. Can we step down to 3-digit so it scaffolds from Module 1?

orchestrator

2026-05-27T15:00:18Z · tool_calls: [kb-lookup, lesson-read]

Good catch. Module 1 ended with 3-digit examples, so stepping back to 3-digit here preserves the scaffold. I'll propose two updated examples — preview them below.

Footer — action affordances

ReviewCardState (existing universal review surface, D21)

State 1

NEW_DRAFT

Pipeline emission, never inspected

State 2

HAS_COMMENTS

Doc has ≥1 entry (teacher or evaluator)

State 3

REPLANNING

Submit-all dispatched; v(n+1) in flight

State 4

REVISED

Evaluator published v(n+1); awaiting teacher

State 5

APPROVED

Terminal; drops out of queue → finalized

What lives in each per-course git repo

<teacher>/<course-slug>/                  # per-course workspace
├── intake.md                             # teacher source context
├── course-outline.md                     # Strategy presentation artifact
├── pedagogy.md                           # Strategy pedagogical stance
├── preferences-voice.md
├── preferences-visual.md
├── preferences-presentation.md
├── non-negotiables-universal.md          # loaded from framework
├── non-negotiables-bc.md
├── units/
│   ├── unit-1.md                         # Structure unit description
│   └── unit-1/
│       └── modules/
│           ├── module-1.md               # Structure module plan
│           └── module-1/
│               ├── lessons/
│               │   ├── lesson-1.md       # Substance lesson artifact
│               │   └── lesson-2.md
│               └── assignments/
│                   └── assignment-1.md   # Substance assignment artifact
├── chat/                                 # teacher/context conversation
├── comments/                             # one file per comment (D23)
│   └── units/unit-1/structure.md/
│       ├── 2026-05-27T14-05-00Z-judge.md
│       └── 2026-05-27T14-08-00Z-teacher.md
├── quality-reports/                      # report-only evidence
│   ├── strategy/
│   ├── structure/
│   └── substance/
├── prompts/                              # workspace overrides for system prompts (D18)
│   └── ...
└── CLAUDE.md                             # workspace schema file