Введение в работу от спецификации

Работа от спецификации — приём, в котором первым артефактом в решении задачи становится короткий документ: цель, контекст, что делаем, чего не делаем, критерии приёмки, открытые вопросы. Агент работает от него, а команды в чате носят вспомогательный характер.

Зачем приём нужен

Агент отвечает не на ваш вопрос, а на всё, что оказалось в его контекстном окне к моменту генерации ответа. Переписка на сорок реплик — плохой носитель постановки задачи: намерение в ней размазано, ограничения потерялись где-то в середине окна, а критерий приёмки не назван вовсе. Отсюда знакомый результат: код формально собирается, но делает не то, что надо, и спорить не о чем — договорённости нет ни в одном месте.

Спецификация переносит намерение из переписки в документ. Она короткая — страница, а не техническое задание, — и её ценность в трёх вещах, которых в диалоге не бывает. Первая: явный отрицательный список. «Чего не делаем» ограничивает агента сильнее, чем десять уточнений после факта. Вторая: критерий приёмки, названный до работы. Пока его нет, «готово» значит «агент перестал печатать». Третья: общий предмет задачи при расхождении. Когда результат не совпал с ожиданием, вы правите спецификацию и запускаете заново, а не объясняете заново каждый раз.

Что приём даёт Академии

Приём стоит в центре первых двух курсов, и они делят работу между собой. Первый ставит контур: намерение → спецификация → агент → результат → приёмка результата человеком, и возврат к спецификации при расхождении. Второй отвечает на вопрос, который первый только ставит: чем наполнено контекстное окно агента в момент генерации ответа и кто за это наполнение отвечает — потому что спецификация попадает в окно не одна, а вместе с четырьмя другими слоями контекста и конкурирует с ними за место в ограниченном объёме.

Обе ступени не привязаны ни к платформе, ни к предметной области: приёмы переносятся на любой проект, где вы работаете с агентами.

Курс 1 · Цикл разработки продуктов на основе ИИ

3 главы · 19 уроков · 1 практическое задание · 57 тестовых заданий

Зачем вам этот курс. Вы уже пишете код с агентом, но результат зависит от удачи: где-то вышло с первого раза, где-то пришлось переписывать многое или даже всё. Курс переводит эту работу в регулярно повторяемый результат.

Что вы освоите. Постановку задачи и сборку контекста, спецификацию как первый артефакт, базовую проверку результата, разбор рисков и защитных рамок. Дальше — концепцию цикла: от Waterfall к подходу от намерения, роли ИИ-команды, агентные паттерны. Третья глава — практикум на двух инструментах, Claude Code и Cursor: субагенты, скиллы, MCP, звенья и границы контура агента.

В чём польза. Вы перестаёте относиться к агенту как к умному автокомплиту и начинаете видеть, как именно выстроить работу с ним.

Устройство. Три главы, 19 уроков, 1 практическое задание и 57 тестовых заданий. Предпосылки — опыт разработки, Git и командная строка.

Открыть в кабинете

Схема курса: от намерения к поставкеНамерение задаёт спецификацию, по ней работает агент; в него же входят контекст задачи и защитные рамки. Результат — код и тесты — уходит на приёмку человеком: при расхождении возврат к спецификации, при принятии — поставка.Намерениечто и зачем?СпецификацияАгентисполнениеКонтекст задачиЗащитные рамкичто не делаем?Результаткод и тестыПриёмка человекомпринятоПоставкарасхождение

Курс 2 · Управление контекстом ИИ-агентов в командной разработке

3 главы · 25 уроков · 25 практических заданий · 75 тестовых заданий

Зачем вам этот курс. Агент отвечает не на ваш вопрос, а на всё содержимое окна контекста. Курс — о том, чем это окно наполнено и кто за наполнение отвечает.

Что вы освоите. Пять слоёв контекста — постоянный, проектный, задачный, сессионный, инструментальный: у каждого своё время жизни, свой владелец и свой способ попасть в окно. Почему постоянный слой не помнится вечно, а слабеет по ходу сессии, и почему окно — ёмкость, за которую конкурируют слои. Дальше — контекстная система команды разработки: правила, README и журнал решений, стандарт артефакта и его владелец, нормативный слой, неявные источники, метрики качества и симптомы деградации. Третья глава — работа над задачей: режим планирования, работа от спецификации и сворачивание, ревью контекстного пакета, тест-дизайн, исследования и одиннадцать стадий работы координатора.

В чём польза. Вы перестаёте чинить ответы агента и начинаете чинить его вход.

Устройство. Три главы, 25 уроков, 25 практических заданий и 75 тестовых заданий. Предпосылка — первый курс.

Открыть в кабинете

Схема курса: слои контекста и контекстное окноПять слоёв — постоянный, проектный, задачный, сессионный и инструментальный — сходятся в контекстное окно и конкурируют за его ёмкость. Из окна выходит ответ агента, за ним — метрики и симптомы деградации контекста, затем сворачивание и обновление контекста, возвращающее окно в рабочее состояние.Постоянный слойправила, README, решенияПроектный слойподсистемы и схемыЗадачный слойспецификация и критерииСессионный слойистория обменаИнструментальный слойинструменты, MCP, субагентыКонтекстное окноёмкость, за которую конкурируют слоиОтвет агентаМетрики и симптомыдеградации контекстаСворачивание и обновлениеконтекста

Курс 5 · опциональный · Сравнительный анализ методологий агентной разработки

4 главы · 17 уроков · 0 практических заданий · 51 тестовое задание

Зачем вам этот курс. Сразу несколько методов называют себя агентной разработкой и пользуются одними и теми же словами — «спецификация», «намерение», «инженерия», — вкладывая в них разный смысл. Если объединять методы по общему слову, экономия окажется ложной: смену самого предмета разработки легко принять за ещё один уровень зрелости. Курс сравнивает семь подходов и не сливает их.

Что вы освоите. Рамку сравнения и словарь таких омонимов. Пирамиду зрелости агентной инженерии Веры Вишняковой и методологии пути кода: Software Engineering 3.0, Vibe и Deep Coding, индустриальный вайб-кодинг, цикл разработки, ведомый ИИ. Место инженерии исполняемого знания рядом с пирамидой и закрытого контура исполнения на общей карте. Инженерию доверия и операционную систему деятельности на примерах отделения реанимации — вместе с регуляторной рамкой для медицинского программного обеспечения и регламентом ЕС об ИИ.

В чём польза. Вы умеете задать любому подходу один диагностический вопрос — где записано, почему здесь именно такое значение: в исходном коде или в выделенном, авторизованном знании — и по ответу понимаете, что метод действительно меняет, а что лишь называет по-новому.

Устройство. Четыре главы, 17 уроков, 0 практических заданий и 51 тестовое задание. Предпосылка — курс «Цикл разработки продуктов на основе ИИ». Курс ориентирован на продвинутую часть аудитории: это карта поля, а не учебник программирования.

Открыть в кабинете

Схема курса: карта методологий агентной разработкиОдни и те же слова — спецификация, намерение, инженерия — в разных методах значат разное, поэтому подходы разводятся по двум путям. Путь кода: пирамида зрелости Вишняковой из четырёх ярусов (запросы, контекст, намерение, спецификации) и режимы Software Engineering 3.0, Vibe и Deep Coding, цикл разработки, ведомый ИИ. ОСД HealthOS: инженерия исполняемого знания рядом с пирамидой и закрытый контур исполнения. Оба пути проверяются одним диагностическим вопросом — почему здесь именно такое значение: ответ ищут в коде или в авторизованном знании. Итог — инженерия доверия и операционная система деятельности.Одно слово — разные смыслыспецификация · намерение · инженерияПирамида ВишняковойОСД HealthOSСпецификацииНамерениеКонтекстЗапросыSE 3.0 · Vibe / Deep · AI-DLCИсполняемое знаниерядом с пирамидой, не ярусЗакрытый контурисполнение в периметреответ в кодеответ в знанииПочему здесь такое значение?читаем код — или авторизованное знаниеДоверие и операционная система деятельностибарьеры ИИ · цепочки ценности · регуляторика

Тем, кто прошёл второй курс, дальше рекомендуется курс о памяти агентов: что из контекста переживает сессию, кто вправе туда писать и как проверить, что память работает.

Курс 6 · опциональный · Управление памятью агентов

3 главы · 13 уроков · 16 практических заданий · 39 тестовых заданий

Зачем вам этот курс. Контекст окна живёт один вызов модели. Память агента — всё, что переживает сессию и снова попадает в окно: правила, журналы, сводки, справочники, — или вшито в веса модели. Курс разбирает, какой бывает такая память, кто имеет право в неё писать, как она отказывает и как проверить, что она действительно работает, а не только объявлена.

Что вы освоите. Первая глава вводит язык: четыре класса использования памяти, три формы её хранения и их пересечение. Вторая применяет его к работе: кто пишет в долговременную память, как ведёт себя окно, как память отказывает, чем различаются разработка и эксплуатация, как мерить память и для кого её вообще строить. Третья собирает всё это в два полных сценария — агентную разработку и конвейер ЭКГ.

В чём польза. Вы отличаете память, которая работает, от памяти, которая только объявлена, и знаете, кто вправе в неё писать.

Устройство. Три главы, 13 уроков, 16 практических заданий и 39 тестовых заданий. Курс опциональный; уровни глав — 4.0, 5.0 и 6.0. Его рекомендуется проходить после курса «Управление контекстом ИИ-агентов в командной разработке» — понятия контекста и контекстного окна берутся оттуда; это рекомендация, а не условие доступа.

Открыть в кабинете

Схема курса: долговременная память агентаПамять агента переживает сессию и снова попадает в окно. Часть I, уроки 1–4, вводит язык: четыре класса использования памяти — рабочая, эпизодическая, семантическая, процедурная — и три формы её хранения — токеновая, латентная, параметрическая — с матрицей «класс × форма». Часть II, уроки 5–11, применяет его к работе: запись в носитель памяти идёт по цепочке предложение, гейт, публикатор; дальше — проекция журнала, окно в работе, отказы и угрозы, разработка и эксплуатация, замер и потребитель памяти. Часть III, уроки 12–13, собирает оба сквозных примера: агентную разработку и конвейер ЭКГ. Итог — память агентов HealthOS работает, и это проверено замером.Память агентапереживает сессию и снова идёт в окноI · Таксономииуроки 1–44 класса использованиярабочая · эпизодическаясемантическая · процедурная3 формы хранениятокеновая · латентнаяпараметрическая×матрица «класс × форма» и границы применимостиII · Сценарии и паттерныуроки 5–11ПредложениеГейтПубликаторНоситель памятипроекция журнала · окно в работе · отказы и угрозыразработка и эксплуатация · замер · потребительIII · Сквозные примерыуроки 12–13Агентная разработкаурок 12Конвейер ЭКГурок 13Память агентов HealthOSработает — проверено замером

Следующая ступень — введение в Agentic Ops: та же дисциплина в регулируемой экосистеме и в закрытом периметре.

Материалы Академии HealthOS носят консультационный характер. Прогресс по умолчанию хранится в браузере; если выбрать хранение на сервере или рейтинг, он отправляется на платформу.