How to Build an AI Agent
How to Build an AI Agent

Parcours d'apprentissage

s01 à s12 : Conception d'agent progressive

Légende des couches

Tools & Execution
Planning & Coordination
Memory Management
Concurrency
Collaboration
01
s01Single-tool agent loop

The Agent LoopBash is All You Need

84 lignes de code1 outils

The minimal agent kernel is a while loop + one tool

En savoir plus
02
s02Tool dispatch map

ToolsOne Handler Per Tool

120 lignes de code4 outils

The loop stays the same; new tools register into the dispatch map

En savoir plus
03
s03TodoManager + nag reminder

TodoWritePlan Before You Act

176 lignes de code5 outils

An agent without a plan drifts; list the steps first, then execute

En savoir plus
04
s04Subagent spawn with isolated messages[]

SubagentsClean Context Per Subtask

151 lignes de code5 outils

Subagents use independent messages[], keeping the main conversation clean

En savoir plus
05
s05SkillLoader + two-layer injection

SkillsLoad on Demand

187 lignes de code5 outils

Inject knowledge via tool_result when needed, not upfront in the system prompt

En savoir plus
06
s06micro-compact + auto-compact + archival

CompactThree-Layer Compression

205 lignes de code5 outils

Context will fill up; three-layer compression strategy enables infinite sessions

En savoir plus
07
s07TaskManager with file-based state + dependency graph

TasksTask Graph + Dependencies

207 lignes de code8 outils

A file-based task graph with ordering, parallelism, and dependencies -- the coordination backbone for multi-agent work

En savoir plus
08
s08BackgroundManager + notification queue

Background TasksBackground Threads + Notifications

198 lignes de code6 outils

Run slow operations in the background; the agent keeps thinking ahead

En savoir plus
09
s09TeammateManager + file-based mailbox

Agent TeamsTeammates + Mailboxes

348 lignes de code10 outils

When one agent can't finish, delegate to persistent teammates via async mailboxes

En savoir plus
10
s10request_id correlation for two protocols

Team ProtocolsShared Communication Rules

419 lignes de code12 outils

One request-response pattern drives all team negotiation

En savoir plus
11
s11Task board polling + timeout-based self-governance

Autonomous AgentsScan Board, Claim Tasks

499 lignes de code14 outils

Teammates scan the board and claim tasks themselves; no need for the lead to assign each one

En savoir plus
12
s12Composable worktree lifecycle + event stream over a shared task board

Worktree + Task IsolationIsolate by Directory

694 lignes de code16 outils

Each works in its own directory; tasks manage goals, worktrees manage directories, bound by ID

En savoir plus

Croissance LOC

s01
84
s02
120
s03
176
s04
151
s05
187
s06
205
s07
207
s08
198
s09
348
s10
419
s11
499
s12
694