Skip to content

Финальный проект

Что нужно собрать

Финальный проект собирает все слои handbook в один рабочий artifact. Вы проектируете harness под продуктовую фичу ALGI или под улучшение yolo-runner-like системы.

Слои проекта

СлойЧто должно быть сделаноКритерии готовности
Product/specProblem statement, constraints, acceptance criteria, non-goals.Фича понятна без устного контекста, scope bounded, критерии проверяемы.
Task contractEpic decomposition, task graph, dependencies, DoD per task.Задачи agent-ready, зависимости явные, независимость сохранена там, где возможно.
ContextAGENTS.md, domain docs, tool docs, memory/task notes.Контекст краткий, иерархичный, актуальный, без лишнего дублирования.
HarnessRunner, prompt construction, backend selection, lifecycle.Запуск воспроизводим, результат проверяется harness, а не словами агента.
VerificationTests, lint/typecheck, evaluator, retry/review/block outcomes.Checks запускаются автоматически, failure не превращается в ложный success.
Sandbox & safetyPermissions, isolation, rollback, secrets policy, approval gates.Границы доступа явные, секреты не попадают в logs/prompts, rollback описан.
ObservabilityEvents, logs, run summary, failure taxonomy, UI или log browser.По артефактам понятно, что сделал агент, почему и что делать дальше.
Demo & adoptionREADME, demo script, limitations, cost estimate, roadmap.Demo воспроизводится, риски и next steps явно описаны.

Что сдать

  • Feature spec или harness improvement spec.
  • Task graph.
  • Context pack.
  • Минимальный или расширенный runner.
  • Verification commands.
  • Run logs и summary.
  • Demo script.
  • Adoption note: риски, стоимость, maturity next step.

Как понять, что получилось

Проект готов, если:

  • один новый человек может понять scope из документов;
  • agent run воспроизводим;
  • success определяется checks;
  • failed и blocked outcomes честно различаются;
  • logs показывают ход работы;
  • есть human gates для рискованных действий;
  • limitations не скрыты.

Хороший scope для первого проекта

Для первого проекта лучше выбрать bounded фичу:

  • onboarding slice для ALGI;
  • флоу записи в pain diary;
  • черновик clinician report;
  • суммаризатор логов runner;
  • линтер task contracts;
  • генератор context packs;
  • оркестрация checks для одного repo.

Agentic Engineering: Context Engineering + Harness Engineering