Appearance
Что вы должны уметь после хендбука
Цель хендбука — не выучить термины. К концу чтения и практики вы должны уметь выпускать рабочие инженерные artifacts: specs, task contracts, context packs, policies, logs, evals и review summaries.
| Группа | Что вы умеете | Как это проверить |
|---|---|---|
| Ментальная модель | Объясняет, почему agent без harness не является production engineering workflow. | Failure analysis наивного agent run. |
| Spec-driven development | Пишет и ревьюит behavior specs до генерации кода. | BDD spec + чеклист ревью spec. |
| Task contracts | Превращает vague request в исполняемый task contract с acceptance criteria, testing plan и DoD. | Отревьюированные task specs. |
| Instruction architecture | Разделяет chat prompt, specs, AGENTS.md, policies, skills и global profile. | Карта инструкций для одной задачи. |
| Context engineering | Проектирует AGENTS.md, docs, memory, task notes и актуальные tool docs. | Context pack для ALGI или учебного repo. |
| Memory и knowledge base | Разделяет trajectory, stable project memory и retrievable knowledge; обновляет memory через reviewable diff. | Project-memory patch + eval case. |
| Harness engineering | Собирает цикл task -> prompt -> agent/backend -> diff -> checks -> result. | Воспроизводимый run с честной классификацией результата. |
| Tool governance | Определяет tool catalog, policy gates, approval и audit fields. | Policy блокирует небезопасную команду или write path. |
| Agent security | Строит threat model: prompt injection, lethal trifecta, supply chain, слои защиты. | Threat model для одного harness с убранным компонентом trifecta. |
| Verification | Добавляет TDD, tests, evaluator, lint/typecheck и review/retry gates. | Agent run проходит checks или блокируется с понятной причиной. |
| Observability | Читает structured logs/events и диагностирует failure modes. | Run diagnostic report. |
| Harness evaluation | Оценивает harness шире, чем один успешный запуск. | Eval suite с happy path, blocked, failed и replay cases. |
| Orchestration | Строит task graph, dependencies, ready queue и safe concurrency. | Epic decomposition с dependency graph. |
| Team workflow | Встраивает agent-generated changes в review и ownership процесс команды. | PR risk summary и conditional LGTM policy. |
| Domain adaptation | Проектирует отдельные harness loop для frontend/backend/mobile/DevOps. | Domain blueprint с checks и rollback. |
| Guarded autonomy | Выбирает уровень автономии, permissions, approval gates и audit trail. | Team adoption policy. |
| Economics | Оценивает cost, latency, human review и price of error. | Матрица решений и cost dashboard. |
| Agent lifecycle | Регистрирует agent/backend с owner, capability, policy, evals и incident response. | Agent registry entry. |
| Self-hosting | Проектирует roadmap от script-runner к yolo-runner-like системе. | Maturity roadmap со stop/go criteria. |