Эпилог · Что дальше
Куда дальше
Вы видели все детали harness — цикл, инструменты, контекст, память, сессии, subagents, permissions, hooks, streaming, стоимость. Дальше — практика и чужой код: пара pet-проектов, чтобы пощупать руками, и карта чтения, чтобы было куда возвращаться.
Что прочитать в первую очередь
Если хочется один-единственный текст, с которого начать всё с нуля, — берите Anthropic «Building Effective Agents». Это короткая инженерная статья, в которой Эрик Шлантц и Барри Чжан проводят водораздел между workflow и agent, дают пять базовых паттернов и формулируют три принципа, которым стоит следовать в продакшене: simplicity, transparency и тщательно спроектированный agent-computer interface. Половина того, что вы прочитали в этом курсе, выросла из неё.
Следом — OpenAI «A Practical Guide to Building Agents». Это PDF на ~30 страниц, и он полезен ровно тем, что написан с другой стороны: тот же цикл, те же инструменты, но другая терминология и другой акцент. Прочитав обе статьи подряд, вы получите хороший «триангулированный» взгляд на предметную область — увидите, что общего между двумя крупнейшими лабораториями, а что — следствие их конкретных моделей и API.
Третий обязательный текст — наш конспект по внутренностям claude-cli: INDEX, distill и 13 concept docs (от orchestrator loop до permissions и subagent dispatch). Это уже не общая теория, а конкретный продакшен-агент, разобранный по концепциям. Если статьи Anthropic и OpenAI отвечают на вопрос «как это должно работать», то этот разбор отвечает на «как это на самом деле работает в одном из самых популярных кодинг-агентов 2025–2026 годов».
И четвёртое — что-нибудь из Олега Беловы про память. Memory Architecture, Two-Process Model и Shared State — это три коротких поста, которые меняют картинку: после них вы перестанете думать про «контекст» как про одну линейную ленту и начнёте видеть, что у агента есть как минимум два процесса и общий filesystem-state, через который они переговариваются.
Что попробовать в коде
Минимальный agent на Anthropic API. Один Python-файл, один инструмент (например, чтение файла или вызов bash), один while со switch на stop_reason. Цель — не сделать что-то полезное, а собственными руками собрать тот «десяток строк», о котором пишет Anthropic. После этого все остальные harness в мире становятся читаемы — вы знаете, где у них сердце, и где наросло.
Свой harness с file-based памятью. Возьмите минимального агента и добавьте к нему директорию ./memory/ с двумя инструментами: memory_read и memory_write. Положите туда MEMORY.md как индекс. Запустите его на серии задач и посмотрите, что модель туда пишет сама. Это пет-проект в духе Олега Беловы и заодно — самый дешёвый способ понять, зачем нужна shared-state-модель из главы про память.
Subagent dispatch — manager + 2 worker. Тот же минимальный agent, но один из его инструментов — spawn_subagent(prompt, tools), который запускает ещё одну копию agent loop с урезанным набором tools и возвращает только финальный текст. Сделайте на этом тривиальный manager-worker: главный агент разбивает задачу на две, два subagent работают параллельно (через asyncio.gather), результаты возвращаются в основную ленту. Сразу видно, что описано в Anthropic «Built a Multi-Agent Research System».
Hook-based logger и простой policy-гейт. Добавьте в минимального агента две точки расширения: before_tool и after_tool. В первой — проверяйте имя инструмента и аргументы по простому allow-list (например, bash запрещён, read_file разрешён только в пределах текущей директории). Во второй — пишите JSONL-лог: какой tool вызывался, с какими аргументами, что вернул, сколько токенов стоил. Это даст вам понимание глав про permissions и hooks на уровне, недостижимом из чтения.
Карта статей по темам
Anthropic
- [ant] Building Effective Agents — определение agent vs workflow, пять базовых паттернов, three core principles.
- [ant] Built a Multi-Agent Research System — про lead agent, subagents, parallel tool calls и где это окупается.
- [ant] Effective Context Engineering for AI Agents — context as a finite resource, что класть в окно и что не класть.
- [ant] Messages API — каноническая семантика
messages,stop_reason,content-блоков. - [ant] Tool Use — как объявлять инструменты, цикл
tool_use → tool_result, parallel tool calls. - [ant] Prompt Caching — cache breakpoints, экономия на длинных контекстах, эффективные стратегии.
- [ant] Context Windows — что считается, что вытесняется, как работают лимиты.
- [ant] Streaming — SSE-события Messages API, как собирать ответ на лету.
- [ant] Memory Tool — встроенный memory-tool: операции, ограничения, паттерны использования.
- [ant] Agent SDK — официальный фреймворк поверх Claude API, ровно то, чего «хватит, чтобы начать».
- [ant] Permissions (Claude Code) — модель permissions в реальном продакшен-агенте.
- [ant] Context Editing / Compaction — как Anthropic описывает автоматическое сжатие истории.
OpenAI
- [oai] A Practical Guide to Building Agents (PDF) — foundations, orchestration, single- и multi-agent паттерны, guardrails, handoffs.
- [oai] Function Calling — основная страница doc'ов OpenAI про tool use; часть материалов на момент чтения была за paywall, поэтому в курсе мы цитируем её осторожно. Ищите «OpenAI function calling guide» в их актуальных docs.
Олег Беловы
- [oleg] Two-Process Model — почему агент — это не один процесс, а как минимум два, и зачем им разный контекст.
- [oleg] Shared State and Files — filesystem как канал коммуникации между процессами агента.
- [oleg] Memory Architecture — durable-память, MEMORY.md как индекс, четыре типа воспоминаний.
Manus
- [manus] Context Engineering Lessons (Peak Ji) — KV-cache как метрика, mask don't remove, файловая система как контекст, recitation через
todo.md, «keep the wrong stuff in». - [manus] Wide Research: Beyond the Context Window — параллельные subagents для исследовательских задач, выход за пределы одного окна.
Cursor
- [cursor] How Cursor AI IDE Works (sshh.io) — обратная инженерия архитектуры Cursor: tools, context, retrieval, prompts.
- [cursor] Shipping Coding Agent to Production (ByteByteGo) — что меняется, когда coding agent выходит из demo в живую IDE.
- [cursor] Building Cursor (The Pragmatic Engineer) — длинное интервью с командой Cursor: продуктовые решения, инфраструктура, модели.
claude-cli — конспект курса по внутренностям
- [cli] INDEX — карта всех 13 концептов и где они живут в коде агента.
- [cli] Anthropic Docs Distill — выжимка из публичных docs.claude.com, к которой подвязаны все концепты.
- [cli] 01 · Orchestrator Loop —
QueryEngine,queryLoop, recovery-итерации. - [cli] 02 · Session Lifecycle — bootstrap, memoized init, resume, mode dispatch.
- [cli] 03 · IDE Bridge — двунаправленный канал между CLI и веб/IDE-клиентом.
- [cli] 04 · Context Management — каскад snip → microcompact → context-collapse → autocompact.
- [cli] 05 · Memory and Recall — durable file-based memdir, четыре типа памяти, recall по релевантности.
- [cli] 06 · Hooks & Extensibility — где именно вклиниваются hooks и какие сигналы они получают.
- [cli] 07 · Tool Surface — таксономия инструментов, как они описываются модели.
- [cli] 08 · Plugin System — устройство marketplace плагинов и их загрузки.
- [cli] 09 · Output Formatting — как сырые SSE-события превращаются в то, что видит пользователь.
- [cli] 10 · Streaming and SSE — поток событий из API наружу через CLI.
- [cli] 11 · Cost Tracking — учёт токенов, кэша и денежной цены по сессии.
- [cli] 12 · Subagent Dispatch — как основной агент порождает дочерних и собирает результаты.
- [cli] 13 · Permission and Policy — четыре слоя гейта: rules, modes, tool-check, hooks.
Если хотите глубже — кодовые базы и репозитории
Чтение статей даёт картинку, чтение кода даёт интуицию. Несколько репозиториев, которые имеет смысл хотя бы пролистать.
- [repo] anthropics/claude-agent-sdk-python — официальный Python-SDK поверх Messages API. TypeScript-версия — там же в организации
anthropics, поиск «claude-agent-sdk-typescript». - [repo] anthropics/claude-code — официальный CLI-агент Anthropic. Исходный код закрытый, но репозиторий содержит docs, issue tracker и release notes — это сама по себе ценная база знаний.
- [repo] SWE-bench / SWE-bench Verified — стандартный бенчмарк для coding-агентов, на котором меряются Claude, GPT и open-source модели. Полезен и как датасет, и как набор задач для собственного агента. Также ищите «swe-bench verified leaderboard».
- [repo] OpenAI Agents SDK — у OpenAI есть собственный agents-фреймворк (поиск «openai agents sdk python»); полезно сравнить с Anthropic Agent SDK, чтобы увидеть, что общего, а что — артефакт конкретного API.
- [repo] Cursor / Manus — обе системы closed-source, но обе много пишут в инженерные блоги (см. разделы выше). Если хочется живой open-source coding-agent для разбора — поищите
aider,continue.dev,opencodeна GitHub.
Агенты — молодая область. Через год многое из того, что написано в этом курсе и в этом списке, устареет: появятся новые API, новые паттерны, новые ошибки. Но цикл, инструменты, контекст, память, permissions и hooks — это база. Она никуда не денется, потому что выросла не из конкретной модели, а из того, как вообще устроена связь LLM с внешним миром. Спасибо, что прочитали до конца.
— ascorblack