Appearance
Карта на реальные инструменты
Хендбук сознательно описывает концепции tool-agnostic: task contract, context pack, policy gate и evidence chain переживут любой конкретный продукт. Эта страница нужна как мост в практику: как слои хендбука выглядят в популярных инструментах.
Дата снимка
Инструменты в этой области меняются каждые несколько месяцев. Снимок актуален на середину 2026 года — проверяйте документацию конкретного инструмента.
Слои хендбука в инструментах
| Концепция handbook | Claude Code | Codex CLI | Cursor | Универсально / CI |
|---|---|---|---|---|
| Project rules (Instruction Architecture) | CLAUDE.md (+ поддержка AGENTS.md) | AGENTS.md | Project Rules / .cursor/rules | AGENTS.md — открытая конвенция |
| Policy gate (Tool Gateway) | hooks (PreToolUse), permission modes, allowlists | sandbox modes, approval policy | allow/deny списки команд | собственный gate до side effects |
| Tool catalog / integrations | MCP servers в конфиге | MCP servers | MCP servers | MCP — общий integration contract |
| Sandbox (Agent Security) | контейнер/VM вокруг CLI, ограничение сети снаружи | встроенные sandbox-режимы | — | Docker/VM + запрет egress |
| Headless runner (Minimal Harness) | claude -p "..." в скрипте/CI | codex exec | — | agent CLI как шаг pipeline |
| Run logs / evidence (Observability) | session transcripts, JSON output mode | session logs | — | собственный JSONL event stream |
| Concurrency (Orchestration) | git worktrees + параллельные сессии | параллельные exec-запуски | — | отдельная ветка/workspace на задачу |
| Continuous reviewer (Team Workflow) | review-агенты в GitHub Actions | CI job с review prompt | Bugbot | agent CLI в PR pipeline |
| Reusable skills | skills / slash commands | custom prompts | rules | версионируемые prompt-файлы в repo |
Что важно понять из этой таблицы
Конвергенция уже случилась. Все основные инструменты сошлись на одном наборе механизмов: файл правил в repo, MCP для tools, режимы разрешений, headless-запуск для CI. Это ровно те слои, которые handbook называет instruction architecture, tool gateway и minimal harness — учите слой, а не кнопку.
Ни один инструмент не закрывает harness целиком. Из коробки вы получаете agent backend с правилами и permissions. Task contracts, context packs, evidence chain, eval suite и adoption policy остаются вашей инженерной работой. Поэтому harness из Labs строится вокруг agent CLI, а не вместо него.
Policy gate инструмента — это удобство, а не граница. Allowlists и approval-режимы защищают от ошибок агента, но живут в том же процессе, что и агент. Границу от злонамеренного input (см. Agent Security) держит внешний слой: sandbox, сеть, credentials.
Минимальный практический стек
Если собирать управляемый workflow сегодня с нуля:
AGENTS.md/CLAUDE.mdс правилами repo и командами проверки — глава Context Engineering.- Task contracts в issue-трекере по шаблону.
- Agent CLI в headless-режиме внутри контейнера без egress — главы Minimal Harness и Agent Security.
- Checks (tests, lint, typecheck) запускает harness, а не агент «на доверии» — глава Verification.
- JSONL run log + run summary на каждый запуск.
- Review-агент в CI с PR risk summary — глава Team Workflow.