Appearance
Финальный проект
Что нужно собрать
Финальный проект собирает все слои handbook в один рабочий artifact. Вы проектируете harness под продуктовую фичу ALGI или под улучшение yolo-runner-like системы.
Слои проекта
| Слой | Что должно быть сделано | Критерии готовности |
|---|---|---|
| Product/spec | Problem statement, constraints, acceptance criteria, non-goals. | Фича понятна без устного контекста, scope bounded, критерии проверяемы. |
| Task contract | Epic decomposition, task graph, dependencies, DoD per task. | Задачи agent-ready, зависимости явные, независимость сохранена там, где возможно. |
| Context | AGENTS.md, domain docs, tool docs, memory/task notes. | Контекст краткий, иерархичный, актуальный, без лишнего дублирования. |
| Harness | Runner, prompt construction, backend selection, lifecycle. | Запуск воспроизводим, результат проверяется harness, а не словами агента. |
| Verification | Tests, lint/typecheck, evaluator, retry/review/block outcomes. | Checks запускаются автоматически, failure не превращается в ложный success. |
| Sandbox & safety | Permissions, isolation, rollback, secrets policy, approval gates. | Границы доступа явные, секреты не попадают в logs/prompts, rollback описан. |
| Observability | Events, logs, run summary, failure taxonomy, UI или log browser. | По артефактам понятно, что сделал агент, почему и что делать дальше. |
| Demo & adoption | README, 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.