Agentic Community College (ACC)
Coding lessons that run inside Claude Code. Chapters defined by tests. The agent builds, you learn.
ACC v0.3.0 is a Claude Code plugin that turns a session into a coding tutor. A lesson starts from a topic and its documentation. It is split into chapters, and each chapter is defined by the tests it makes pass. At runtime the agent implements every chapter in your workspace, explains what it wrote with a self-contained HTML artifact, and closes the lesson with an end-to-end test and a summary page. You read, ask, and confirm.
👉 Read the 2-minute overview
How it works
- Docs. The lesson author gives ACC the official docs, or ACC retrieves them. A curated snapshot lives inside the lesson (
docs/). Every chapter is grounded in it.
- Plan. The author defines the ordered steps the lesson teaches. Each step becomes a chapter.
- Tests first. Each chapter ships the tests that prove its step works, plus one end-to-end test for the whole feature. A reference solution proves the tests are satisfiable. Your workspace gets the scaffold and the tests, never the solution.
- Runtime. For each chapter the conductor tells you what it will build, implements it until the chapter's tests pass, and writes one HTML artifact: what was built, a diagram of how it works, the key snippets, and the tests that prove it. Then it pauses so you can read and ask.
- Close. After the last chapter the conductor runs the e2e test and writes a summary artifact with the most important learnings.
There are no output modes. ACC recommends the Concise Claude Code output style and offers to set it. All learning content goes into the artifacts, not the chat.
Install
/plugin marketplace add contract-hero/plugin-marketplace
/plugin install agentic-community-college@contract-hero
/plugin install acc-claude-sdk@contract-hero # a course (see below)
/acc-claude-sdk:start # start a lesson
The course: build agents with the Claude Agent SDK
acc-claude-sdk is the first course on the v0.3 model. Lesson 1, Your first agent, builds the smallest useful agent in TypeScript in three chapters, each defined by its tests:
- Run a query and read the result.
query() returns an async iterable of typed messages; the result message is the contract.
- Give the agent a custom in-process tool. A Zod shape plus an async handler, served by
createSdkMcpServer() and addressed as mcp__notes__add_note.
- Wrap it in a tiny CLI. Inject
query() and the output streams so the CLI is testable offline; the result message drives the summary line.
Unit tests run offline against a fake message stream. The end-to-end test runs the real agent and needs ANTHROPIC_API_KEY. Every chapter ends with an HTML artifact; the lesson ends with a summary page of the most important learnings. Later lessons add sessions, hooks and subagents.
/plugin install acc-claude-sdk@contract-hero
/acc-claude-sdk:start
Previous work
Two courses were written for the v0.2 section model before the chapter model existed. They stay published as prior work and do not run on ACC v0.3 until they are migrated to chapters.json:
acc-deepbook-course: 4 Sui DeepBook lessons (orders on a BalanceManager, swaps over the CLOB, flash-loan arbitrage, a market-maker bot).acc-evm-wal: 6 Walrus x EVM lessons (blob anchoring, Walrus Sites, an ENS-gated resolver, DAO proposals, a verifiable manifest client, a quilt-backed ERC-721).
Write your own course
/agentic-community-college:create-course # scaffold a course plugin
/agentic-community-college:create-lesson # docs -> chapters -> tests -> validation
create-lesson curates the docs, plans the chapters, writes the tests and the reference solution, writes the chapter briefs, and validates the lesson with a learner sub-agent before you commit.
Links
For contributors
If you are editing ACC itself, see CLAUDE.md for the architectural invariants, build/test commands, and component map.
pnpm install
cd mcp/server && pnpm install && pnpm build
pnpm test # from the repo root
The plugin manifest spawns node mcp/server/dist/index.js over stdio, so pnpm build is required after any change in mcp/server/src/.
