ACADEMY · FOUNDATIONS

From a 40-line loop to
an observable tool-using agent.

13 long-form tutorials share one dependency-free Python reference harness. Each moves from the problem and mental model through implementation, failure paths, exercises, and production boundaries.

13 lessons13 Golden Traces26 acceptance checks0 API keys2 languages
S01
FOUNDATIONS · 01IMPLEMENTED

The Minimal Agent Loop

Turn one model call into a loop with an explicit stop condition.

22 MINbeginnerLONG-FORM · FULL SOURCE
agent-loop
python3 -m curriculum.lessons.s01_agent_loop.demoOpen lesson
S02
FOUNDATIONS · 02IMPLEMENTED

Streaming and Events

Convert streaming deltas into observable, replayable events.

24 MINbeginnerLONG-FORM · FULL SOURCE
agent-loopevent-stream
python3 -m curriculum.lessons.s02_events_streaming.demoOpen lesson
S03
FOUNDATIONS · 03IMPLEMENTED

Tool Registry and Dispatch

Validate, execute, and record model-requested tool calls.

30 MINintermediateLONG-FORM · FULL SOURCE
agent-looptool-dispatch
python3 -m curriculum.lessons.s03_tool_dispatch.demoOpen lesson
S04
FOUNDATIONS · 04IMPLEMENTED

File, Shell, and Edit Tools

Put workspace boundaries and explicit allowlists around side-effecting tools.

34 MINintermediateLONG-FORM · FULL SOURCE
workspace-toolspath-boundary
python3 -m curriculum.lessons.s04_workspace_tools.demoOpen lesson
S05
FOUNDATIONS · 05IMPLEMENTED

Instructions and Project Discovery

Compose hierarchical instructions from the workspace root to the current directory.

26 MINintermediateLONG-FORM · FULL SOURCE
instruction-discovery
python3 -m curriculum.lessons.s05_instructions.demoOpen lesson
S06
FOUNDATIONS · 06IMPLEMENTED

Context Budgets and Truncation

Make input pruning and tool-output truncation explicit policies.

36 MINintermediateLONG-FORM · FULL SOURCE
context-budgettool-output-truncation
python3 -m curriculum.lessons.s06_context_budget.demoOpen lesson
S07
FOUNDATIONS · 07IMPLEMENTED

Session Event Logs, Replay, and Branching

Rebuild derived state from append-only events and create lineage-preserving branches.

38 MINintermediateLONG-FORM · FULL SOURCE
event-streamsession-replay
python3 -m curriculum.lessons.s07_session_replay.demoOpen lesson
S08
FOUNDATIONS · 08IMPLEMENTED

Context Compaction and Checkpoints

Replace long visible history with a provenance-bearing semantic checkpoint while retaining the factual log.

42 MINadvancedLONG-FORM · FULL SOURCE
context-budgetcontext-compaction
python3 -m curriculum.lessons.s08_context_compaction.demoOpen lesson
S09
FOUNDATIONS · 09IMPLEMENTED

Memory and On-Demand Skills

Move durable facts and full capability instructions out of resident context, retrieving them only when relevant.

40 MINadvancedLONG-FORM · FULL SOURCE
memory-retrievalextension-runtime
python3 -m curriculum.lessons.s09_memory_skills.demoOpen lesson
S10
FOUNDATIONS · 10IMPLEMENTED

Approval Policy and Exact Authorization

Insert fail-closed allow, ask, and deny decisions between model requests and real effects.

42 MINadvancedLONG-FORM · FULL SOURCE
execution-policy
python3 -m curriculum.lessons.s10_approval_policy.demoOpen lesson
S11
FOUNDATIONS · 11IMPLEMENTED

OS Sandboxes and Network Boundaries

Compile semantic authorization into a minimal capability envelope enforceable by an isolation backend.

46 MINadvancedLONG-FORM · FULL SOURCE
execution-policyos-sandboxnetwork-boundary
python3 -m curriculum.lessons.s11_sandbox_network.demoOpen lesson
S12
FOUNDATIONS · 12IMPLEMENTED

Project Trust and Prompt Injection

Separate workspace identity, explicit trust, and instruction-versus-data authority.

45 MINadvancedLONG-FORM · FULL SOURCE
project-trustinstruction-discovery
python3 -m curriculum.lessons.s12_project_trust.demoOpen lesson
S13
FOUNDATIONS · 13IMPLEMENTED

Git Checkpoints, Diffs, and Rollback

Create a clean baseline before effects, review the exact diff, and roll back only explicit paths.

48 MINadvancedLONG-FORM · FULL SOURCE
checkpoint-rollbackevent-stream
python3 -m curriculum.lessons.s13_checkpoint_rollback.demoOpen lesson