Astra gpt-6-astra · effort ultra срез: 2026-09-21 источников: 60 слов: 15980 complete
Лучшие практики написания спецификаций: от PRD и RFC до заданий для LLM и людей
Предложен стандарт из общего ядра требований, проверок и приёмки с представлениями для людей и LLM. Шаблоны, четыре сценария, JSON Schema и демонстрация дополнены разбором доказательств; универсальное исполнение без уточнений не подтверждено.
Вердикт
Для продукта управления компанией предлагается общее ядро спецификации с представлениями для разных исполнителей: потребность, границы, требования, проверки, доказательства и решение о приёмке гипотеза. PR-FAQ помогает выбрать продуктовый результат, RFC — обсудить решение, ADR — сохранить его причины, а описание внешней работы — определить поставку и способ оценки; эти функции различаются факт [S1, S2, S3, S4]. JSON Schema задаёт проверяемые ограничения данных, а DoD описывает общие меры качества факт [S5, S6]; критерий, успешную проверку и приёмку уполномоченным лицом предлагается хранить раздельно гипотеза. Детализацию целесообразно увеличивать с ценой ошибки, внешней передачей и дефицитом общего контекста, сохраняя короткую карточку для малого обратимого изменения гипотеза.
- LLM полезна как интервьюер, составитель черновика и помощник проверки, но не как источник неподтверждённых обязательств. Эксперименты показывают как полезные возможности, так и смысловые ошибки, а исследования AGENTS.md не устанавливают универсального улучшения корректности от дополнительного контекста эмпирика [S7, S8]. Поэтому рекомендуются происхождение каждого must, версионная baseline, доступный пакет контекста и проверка по независимому ожидаемому результату гипотеза.
- Самая сильная альтернатива полному профилю — краткий task brief или story с примерами, проверкой и одним принимающим; отдельные PRD/RFC оправданы дополнительным вопросом, который они решают гипотеза.
- Уверенность высокая в различии функций и границ автоматической проверки, умеренная в предложенной архитектуре внутреннего стандарта и низкая в обещаниях исполнения любых работ без уточнений: сравнительная и продольная эмпирика ограничена гипотеза.
Что это и как работает
Рабочее определение и механизм
Спецификация — согласуемое описание ожидаемого результата и условий, по которым различаются допустимое и недопустимое исполнения. Для внутреннего стандарта предлагается считать её не обязательно файлом, а версионируемым набором требований, решений, примеров, проверок и полномочий; Markdown, карточка и JSON являются представлениями этого набора гипотеза.
Инженерия требований шире написания текста. Публичные материалы ISO/IEC/IEEE 29148:2018 охватывают процессы и информационные результаты жизненного цикла, а определения различают проверку качества формулировки, подтверждение нужности требований и проверку результата; полный платный нормативный текст в этом исследовании не прочитан факт [S9, S10].
| Уровень | Главный вопрос | Минимальное содержание предлагаемого профиля | Что считается завершением |
|---|---|---|---|
| Продуктовый | Зачем, для кого, какое изменение нужно? | Проблема и свидетельства, сценарий, outcome, границы, ограничения, гипотезы, критерий успеха | Владелец выбрал направление и предел вложений; эффект после выпуска измеряется отдельно |
| Технический | Как обеспечить нужное поведение и ограничения? | Контракты, состояния, данные, существенные решения и альтернативы, отказы, проверка, миграция и откат при необходимости | Ответственный за технический выбор принял решение; реализация ещё может отсутствовать |
| Исполнительский | Что сделать сейчас, чем проверить, кому сдать? | Входы с версиями, результат, исполнитель, разрешённые действия, требования/критерии, evidence, принимающий и возврат | Конкретная версия результата проверена и принята уполномоченным лицом |
Три уровня — логические, а не три обязательных документа. Для небольшой задачи они помещаются в одной карточке; отдельный design doc нужен там, где есть существенный выбор, а не потому, что появилась новая задача. Содержание таблицы и такое правило упаковки — авторское предложение для рассматриваемого продукта гипотеза.
Общая анатомия: ядро и расширения
| Поле ядра | Что записывается | Как ломается при отсутствии |
|---|---|---|
| Идентичность | ID, revision, состояние, дата, владелец, исполнитель, принимающий | Нельзя установить, что именно было выдано и кто вправе менять смысл |
| Потребность | Кто столкнулся с чем, источник потребности, ожидаемое изменение | LLM оптимизирует красивый документ вместо нужного результата |
| Результат | Поставляемый объект, формат, место сдачи, граница работы | Исполнитель сдаёт деятельность вместо результата |
| Область и ограничения | Входит/не входит, предпосылки, доступные ресурсы, запреты, условия остановки | Расширение объёма или действие без полномочий |
| Требования | Атомарные ID, обязательность, условия, наблюдаемая реакция, источник | Разные исполнители достраивают разные правила |
| Проверки | Критерий, вход/среда, метод, ожидаемое наблюдение, проверяющий | «Готово» нельзя воспроизвести |
| Приёмка | Версии, комплект доказательств, срок review, принимающий, основания возврата/исключения | Зелёные тесты автоматически превращаются в бизнес-одобрение |
| Изменения | Автор и причина изменения, затронутые ID, новая baseline, последствия для работ и evidence | Требования меняются после сдачи без видимого решения |
Ядро таблицы — проект стандарта, не пересказ ISO. Поля расширяются только при появлении дополнительного риска или адресата; пустая обязательная глава не полезнее отсутствующей главы гипотеза.
Продуктовые формы: где они заканчиваются
| Форма / источник практики | Родная анатомия и функция | Что добавить для проверки и приёмки в данном продукте | Типичная поломка |
|---|---|---|---|
| One-pager / краткий PRD | Проблема, аудитория, evidence, успех, границы, предложение. Термин не задаёт единого стандарта мнение [S11] | Решение владельца о запуске и критерий проверки гипотезы; перед исполнением — конкретные обязательства гипотеза | Одностраничность достигается удалением исключений |
| Intercom Intermission | Problem-first brief; опубликованная ранняя форма содержит проблему, измерение успеха и scope без решения; более позднее описание сохраняет совместную работу над проблемой факт [S12, S13] | Привязать выявленную потребность к сценариям и приёмочным критериям следующего этапа гипотеза | Исторический формат компании выдаётся за вечное правило «PRD всегда без решения» |
| PRD Lenny Rachitsky | Открытый авторский шаблон: что, проблема, почему она реальна, успех, аудитория, продуктовый объём факт [S11] | Источники предположений, исключения, методы проверки, принимающий гипотеза | Поля заполнены убедительными догадками LLM |
| «Google PRD» | Единый действующий публичный канонический шаблон Google в поиске не установлен; доступны разные авторские и учебные версии | Использовать описанное ядро PRD без атрибуции Google гипотеза | Авторитет бренда заменяет проверяемый источник |
| Amazon PR-FAQ | Будущий клиентский опыт в press release и вопросы/ответы до кодирования; narrative memo до шести страниц основного текста — более широкий формат обсуждения факт [S1] | Проверяемое основание обещаний, решение инвестировать, список ещё не подтверждённых гипотез; затем контракт реализации гипотеза | Воображаемый релиз принимается за доказанный спрос; six-pager считают синонимом PR-FAQ |
| Shape Up pitch | Problem, appetite, solution, rabbit holes, no-gos; форма подготовки ставки и рамок решения факт [S14] | Зафиксировать непереговорные результаты и критерии завершения; детали внутри рамки оставить команде гипотеза | Appetite превращается в оценку гарантированного полного объёма |
| Развёрнутый PRD | Цель, метрики, роли, assumptions, требования и user stories, поддерживающие материалы, вопросы, out of scope в открытом шаблоне Atlassian факт [S15] | Матрица requirement → criterion → evidence и процедура приёмки гипотеза | Документ смешивает discovery, решение и поручение без статусов |
Добавленная приёмка не приписывается оригинальным методам. Принять PR-FAQ означает принять основание для следующего шага, принять продуктовую поставку — подтвердить критерии конкретного результата, а подтвердить продуктовый эффект — получить данные после использования гипотеза.
Технические формы и инженерия требований
| Форма | Родной состав и назначение | Проверка / приёмка в предлагаемом профиле | Точка поломки |
|---|---|---|---|
| Design doc | Контекст, goals/non-goals, дизайн, альтернативы и компромиссы; описанная практика Google от Malte Ubl мнение [S16] | Review значимых решений, прототип опасной гипотезы, план проверки/внедрения/отката гипотеза | Описание каждого класса без причины выбора |
| RFC — Request for Comments | Предложение решения с обсуждением; HashiCorp отделяет PRD, у них Problem Requirements Document, от RFC факт [S2] | Решающий владелец, адресаты review, срок, закрытые возражения, итог; проверки реализации отдельно гипотеза | Бесконечный консенсус или обсуждение без решения |
| ADR — Architecture Decision Record | Title, status, context, decision, consequences; одна значимая развилка и её последствия факт [S3] | Проверить ясность решения/компромиссов и ссылку на заменённый ADR; не принимать код только по наличию ADR гипотеза | Историю переписывают вслед за кодом |
| SRS — Software Requirements Specification | Требования к системе/ПО и их связи в процессах требований; ISO 29148 не предписывает здесь произвольно изобретённый «один шаблон на всё» факт [S9, S10] | Проверка каждого обязательства и набора, валидация смысла с владельцами, матрица подтверждения гипотеза | Полноту объявляют по наличию оглавления |
| User story + INVEST | История ценности и основание разговора; INVEST: Independent, Negotiable, Valuable, Estimable, Small, Testable. Автор акронима — Bill Wake факт [S17] | Критерии истории плюс общая Definition of Done; конкретные тесты детальнее критериев факт [S18] | Фраза «как пользователь хочу» выдаётся за достаточную спецификацию |
| Use case | Цель, акторы, scope, предусловия, trigger, основной поток, расширения, итог успеха/неудачи в авторском шаблоне Cockburn факт [S19] | Проверять основные и существенные альтернативные ветви; отдельно качество и ограничения гипотеза | Только счастливый путь, нет отмены или отказа |
| BDD / Gherkin | Feature/Rule, Scenario, Given/When/Then; исполняемость требует step definitions факт [S20] | Согласовать примеры с бизнес-владельцем, запускать проверки наблюдаемого результата гипотеза | Сценарии описывают клики или код вместо правила |
| Specification by example | Уточнение правила ключевыми примерами; Adzic предупреждает, что множество примеров может скрыть само правило мнение [S21] | Правило плюс репрезентативный позитивный, негативный и граничный пример гипотеза | Каталог примеров принимают за исчерпывающую семантику |
| OpenAPI / JSON Schema / AsyncAPI | Описание HTTP API, ограничений JSON и событийного API соответственно факт [S22, S5, S23] | Schema validation, совместимость producer/consumer, поведенческие проверки ошибок, прав и повторов гипотеза | Валидная форма сообщения объявляется верным поведением сервиса |
Тексты и контракты дополняют друг друга. OpenAPI на срезе имеет опубликованную версию 3.2.1 от 2026-09-10, AsyncAPI — 3.1.0 с релизом 2026-01-31; поддержка этих версий конкретным Swagger-редактором, генератором или валидатором требует отдельной проверки факт [S22, S24]. JSON Schema Draft 2020-12 различает assertions и annotations: наличие format, default или examples само по себе не означает проверку реального значения, подстановку значения или исполнение примера факт [S5].
Однозначность: грамматика, словарь, границы
EARS ограничивает синтаксис, а не угадывает смысл. Автор описывает постоянное требование и паттерны While, When, Where, If…then, а также их композиции; общий порядок — предусловие, событие, система, реакция. В EARS допустимы несколько реакций, поэтому правило внутреннего стандарта «одно самостоятельно проверяемое обязательство на ID» является дополнительным ограничением факт [S25]; гипотеза.
| Паттерн | Структура | Собственный пример применения |
|---|---|---|
| Постоянный | Система должна… | Сервис хранит время создания в UTC |
| Состояние | While… system shall… | Пока заявка закрыта, редактирование её суммы отклоняется |
| Событие | When… system shall… | При подтверждении уполномоченным владельцем фиксируется событие подтверждения |
| Опциональная возможность | Where… system shall… | В конфигурации с экспортом доступна выгрузка в согласованный формат |
| Нежелательное поведение | If… then system shall… | При неизвестном ID возвращается указанная ошибка без создания объекта |
Примеры таблицы показывают паттерны, но ещё не полноценные критерии. Для исполнения нужны точные определения «закрыта», «уполномочен», формат ошибки, идентификатор события и границы транзакции; таблица — иллюстрация авторской адаптации гипотеза.
| Неоднозначность | Недостаточная формулировка | Исправление в предлагаемом стандарте |
|---|---|---|
| Неизвестный субъект | «После согласования отправляется уведомление» | Кто согласует, кому, каким каналом, что считается доставкой и что делать при отказе |
| Размытый порог | «Быстро обрабатывает большие файлы» | Метрика, единица, объём входа, среда, нагрузка, окно/перцентиль и порог, подтверждённый владельцем |
| Скрытый квантор | «Проверить записи» | Все записи либо определённая выборка, способ её получения, трактовка исключений |
| Открытый перечень | «Поддержка браузеров и т. п.» | Закрытый перечень версий либо правило поддержки со сроком пересмотра |
| Отрицание без результата | «Не терять данные» | Сохраняемые инварианты, отказоустойчивый сценарий, восстановление и наблюдаемая проверка |
| Смешение решения и причины | «Нужен Kafka» | Требуемое поведение отдельно, технология как явно принятый constraint/ADR |
| Выдуманная точность | «LLM уточнила: 10 000 пользователей» | Число остаётся assumption со ссылкой на автора/решение; без подтверждения не становится must |
| Календарная двусмысленность | «До пятницы», «за день» | Дата, время, часовой пояс, рабочий/календарный период и событие начала отсчёта |
Правила таблицы — авторский checklist. Показательный риск зафиксирован и в эксперименте с LLM: при «исправлении» требования модель меняла допустимое время ответа с 300 до 500 мс; это изменение обязательства, а не только редактура эмпирика [S7].
Анатомия по аудиториям
| Исполнитель / читатель | Представление и детализация | Обязательная проверка и сдача | Что не стоит помещать в основное представление |
|---|---|---|---|
| LLM-агент | Self-contained task packet: цель, scope, pinned inputs, локальные правила, доступные инструменты, stop conditions, точные outputs | Команды/fixtures или иной проверяемый метод, evidence с версиями, отдельное решение приёмки | Весь архив обсуждений, конфликтующие инструкции, секреты, неразмеченные предположения |
| Разработчик | История/задача + ссылки на контракты и решения, свобода реализации в заданных границах | Примеры, регрессии, review, способ демонстрации результата | Дублирование очевидных соглашений репозитория и псевдокод без значимого выбора |
| Сотрудник подразделения | Короткий task brief: объект/место, входы, действие, результат, время, допустимые пределы, остановка и связь | Осмотр/измерение/фото/журнал, чёткий проверяющий и способ сдачи без сети при необходимости | Внутренняя техническая архитектура продукта и непонятные исполнителю коды |
| Партнёр / подрядчик | Scope/SOW: deliverables, входы обеих сторон, зависимости, критерии на каждый результат, порядок изменений | Комплект сдачи, среда/выборка проверки, срок review, возврат, повторная сдача, протокол | Неявные внутренние ожидания и обязанность угадать отсутствующий стандарт |
| Клиент | Бриф/описание услуги: результат на языке клиента, его вклад, границы, пример, кто утверждает | Понятная демонстрация, рубрика оценки, период обратной связи, протокол решения | Инструкции агенту, внутренние CI-команды и технические ограничения без влияния на выбор клиента |
Таблица аудиторий — предлагаемые представления общей модели. HSE рекомендует подбирать детализацию инструкций по пользователю, задаче и последствиям ошибки, проверять их прохождением задачи и не заменять компетентность процедурой; перенос в продукт компании требует проверки на реальных сотрудниках факт [S26, S27]; гипотеза.
Проверки, критерии и процедура приёмки
| Понятие | Какой вопрос закрывает | Пример различия |
|---|---|---|
| Requirements verification | Хорошо ли сформулированы требования? | Есть ID, субъект, непротиворечивые условия |
| Requirements validation | Нужное ли поведение запрошено? | Владелец подтверждает, что импорт должен быть атомарным |
| Verification результата | Сделано ли указанное? | При одной ошибке не создаётся ни одной задачи |
| Validation результата | Пригодно ли для реального применения? | Менеджер способен подготовить вход и понять отчёт ошибок |
| Acceptance | Кто принял какую версию и на каком основании? | Принимающий фиксирует принятие с evidence и оговорёнными отклонениями |
Первые четыре различия опираются на публичные определения ISO, последнее — операционная модель отчёта. Проверки могут быть автоматическими, осмотром, измерением, анализом или демонстрацией; необязательно превращать каждую человеческую задачу в программный тест факт [S10]; гипотеза.
Критерий, Definition of Done и акт приёмки — разные объекты. В Scrum DoD описывает состояние Increment по требуемым мерам качества, а Sprint Review не является обязательным шлюзом выпуска; индивидуальные criteria описывают конкретную историю. Запись решения о приёмке предлагается хранить отдельно от обоих объектов факт [S6, S18]; гипотеза.
| Элемент критерия | Пример: импорт CSV, иллюстрация |
|---|---|
| Связь | C-A3 проверяет R-A5 и R-A6 |
| Условия и метод | Файл содержит два одинаковых нормализованных ID; вызывается чистая функция |
| Ожидаемый результат | invalid, пустой create, ошибка duplicate_id на второй записи |
| Доказательство | Лог проверки, версия функции, revision спецификации, входной fixture |
| Принимающий | Назначенный владелец задачи; агент может представить evidence, но не подделать его решение |
Для внешних работ полезен разрыв между контролем качества и приёмкой. FAR как структурный референс различает измеримые стандарты результата, способы оценки, ответственное лицо и документирование acceptance; юридические последствия и применимость к компании здесь не рассматриваются факт [S4, S28].
SLA — спецификация продолжающегося сервиса. Google разделяет SLI specification и реализацию измерения, предлагает фиксировать SLO с владельцами, reviewer/approver и датами; SLA дополнительно связывает выполнение с последствиями для бизнеса факт [S29]. Для внутреннего стандарта SLA-профиль должен назвать календарь/окно, eligible events, исключения, источник измерений, частоту отчёта, разбор расхождений и действия при нарушении гипотеза.
SLI = число пригодных событий / число учитываемых событий
Нулевой знаменатель требует отдельного правила. Например, отсутствие обращений за отчётное окно не означает автоматически 100% качества; это состояние «нет наблюдений», если владелец сервиса не утвердил иной смысл. Порог, например 99,5% за календарный месяц, является иллюстрацией, а не рекомендуемой универсальной нормой гипотеза.
Актуальность и доказательная база на дату среза
Что установлено на 2026-09-21
Выполнено 68 отдельных поисковых запросов, в реестр включено 60 источников: 52 полных открытых текста, 6 фрагментов и 2 аннотации. Поиск сочетал запросы по классам документов, официальным сайтам, эмпирическим исследованиям и критике, затем переходы к первоисточникам и уточнение версий; это целевой аналитический обзор, не систематический обзор всей литературы. Дата доступа всех включённых материалов — 2026-09-21; полная страница опубликованного книжного отрывка не означает прочтение всей книги.
Существование практик подтверждено лучше, чем их сравнительное превосходство. Официальные стандарты и публичные описания компаний показывают устойчивые формы требований, решений и контрактов; репрезентативного исследования, которое выбрало бы один лучший шаблон для компаний рассматриваемого масштаба и всех пяти аудиторий, не найдено. Поэтому рекомендации отчёта являются проектом внутреннего стандарта, а не рейтингом доказанной эффективности гипотеза.
| Сегмент | Наблюдаемый тренд и основание | Что из этого не следует |
|---|---|---|
| Продуктовые команды | Продолжают публиковаться и поддерживаться problem-first PRD, PR-FAQ и pitch; Amazon описывает PR/FAQ в письме за 2024 год, опубликованном в 2025 факт [S1, S13, S11] | Нет установленной доли применения и доказательства, что форма Amazon лучше короткого brief |
| Инженерные команды | RFC/design doc/ADR и docs as code остаются доступными практиками с определёнными функциями; сведения подтверждают применение в конкретных организациях факт [S2, S30, S3, S31] | Публикация Google/HashiCorp не даёт рыночной статистики или норм размера документа |
| Интеграции | Развиваются формальные интерфейсные контракты; актуальные релизы OpenAPI и AsyncAPI в 2026 подтверждают продолжающееся сопровождение факт [S22, S24] | Новый стандарт не означает немедленной совместимости всей инструментальной цепочки |
| LLM-разработка | Доступны открытый Spec Kit, Kiro и общий AGENTS.md; актуальные продукты поддерживают отдельные режимы по размеру/типу работы факт [S32, S33, S34] | Число репозиториев, заявленное сайтом AGENTS.md, и наличие продукта не доказывают качество результата |
| Непрограммные задания | HSE продолжает публиковать guidance с work instructions, а performance-based acquisition связывает результат со способом оценки факт [S26, S4] | Это не измерение распространённости task briefs в агропроизводстве или компаниях до 500 сотрудников |
| Сервисы | В SRE опубликована развитая модель измеримых SLO с владельцами и циклом review факт [S29] | Подход Google не обязывает малую сервисную компанию воспроизводить весь процесс |
Эмпирика: дизайн, результат, предел переноса
| Работа | Дизайн и размер | Результат, допустимый для этого отчёта | Ограничения |
|---|---|---|---|
| NaPiRE | Опрос 228 компаний в 10 странах, 21 класс проблем требований | Повторяются неполнота, проблемы коммуникации и меняющиеся цели эмпирика [S35] | Самоотчёт, неоднородная выборка, не эксперимент сравнения шаблонов |
| Обзор quality requirements, Olsson et al. | Отбор 84 статей из 530, корпус 1995–2019; 43 case studies, 15 surveys, 13 tests | Решения часто оценены в академической среде; мало сопоставимых и длительных проверок эмпирика [S36] | Обзор опубликован на arXiv в 2022, но корпус заканчивается 2019; его нельзя выдавать за обзор LLM-практик 2026 |
| Исходный EARS | Один кейс раздела CS-E 50: 36 требований преобразованы в 47; средняя длина 36,9 → 25,6 слова | Структурирование вместе с предметным анализом уменьшило некоторые дефекты в данном материале эмпирика [S37] | Авиационный кейс приведён только как основание переносимого метода; эксперты участвовали, отсутствие пропусков не доказано |
| DoD survey | 137 полных ответов из 45 стран, 24 предоставленных DoD с 143 пунктами | 93% респондентов оценили DoD скорее/определённо полезной; встречаются недоступные и устаревшие правила эмпирика [S38] | Удобная выборка, 139 незавершённых ответов, преимущественно Scrum, самооценка без причинного эффекта |
| LLM для SRS, Krishna et al. | GPT-4 и CodeLlama; один основной university-club кейс и 4 независимых рецензента; для времени — 4 задачи и 3 студента | Модели способны дать полезный структурированный черновик, но ошибаются в содержании и «исправляют» ограничения эмпирика [S7] | Документные оценки, старые модели, студенческая база сравнения, не замер качества поставленного продукта |
| Поиск неоднозначности, Bashir et al. | 663 требования: 219 Westermo, 179 и 265 Alstom; 3 набора, несколько разбиений, 8 экспертов | Релевантные примеры улучшают классификацию; средняя оценка всех аспектов объяснений 3,84/5, полезности — 3,38/5 эмпирика [S39] | Два промышленных контекста, несбалансированные классы, распознавание дефекта не равно корректному ремонту требования |
| AGENTS.md efficiency, Lulla et al., v2 | Парное сравнение с/без AGENTS.md, 124 небольших PR в 10 репозиториях, Codex/gpt-5.2-codex | Медианное время 98,57 → 70,34 с, выходные токены 2925 → 2440 эмпирика [S40] | Нет полноценной gold-test оценки корректности; один агент, ограниченные изменения, часть заданий получена из diff |
| AGENTS.md evaluation, Gloaguen et al., v2 | 300 SWE-bench Lite и 138 CTXbench задач, 4 сочетания модели/harness, по одному completion | Значимого улучшения success относительно отсутствия context file не установлено; LLM-файлы увеличили среднюю inference cost на 20% и 23% в двух наборах эмпирика [S8] | Python, ограниченный набор моделей и задач, долгосрочное качество не измерялось; версия v2 от 2026-06-23 уточняет более сильные выводы v1 |
| Context ablation, Khatri | 17 задач, 3 Python-репозитория, 2 агента, 288 прогонов с gold-test результатом | Обнаружимого улучшения корректности нет эмпирика [S41] | Малый preprint, недостаточная мощность для малых эффектов, каналы и объём контекста различаются; отсутствие значимости не доказанная эквивалентность |
Исследования AGENTS.md не следует усреднять в один процент. В первом основной исход — время и токены, во втором и третьем — корректность на другом наборе задач; отличались файлы контекста, агенты и процедура. Практический вывод — измерять собственные результаты и стоимость, сохранять только полезные инструкции; универсальное «больше контекста улучшает код» не установлено эмпирика [S40, S8, S41]; гипотеза.
Практика компаний, вендорские обещания и критика
| Класс свидетельства | Пример | Вес для решения |
|---|---|---|
| Практика компании | Amazon объясняет письменное обсуждение решений; Intercom — работу от проблемы; HashiCorp — PRD/RFC факт [S1, S13, S2] | Подтверждает осуществимость и анатомию в конкретной культуре |
| Рекомендация автора | Shape Up, INVEST, Adzic, Nygard мнение [S14, S17, S21, S3] | Даёт полезный механизм и trade-off, не общий размер эффекта |
| Документация вендора | Kiro использует EARS и анализ требований; Spec Kit проводит через артефакты и проверки факт [S42, S32] | Подтверждает заявленные функции, не сравнительный результат использования |
| Сильная заявка на автоматизацию | SMART: один инструмент ML-performance, 50 design docs примерно на 9000 строк; авторы сообщают регенерацию за 1,5–3 часа и около $100 API вендор [S43] | Свежий case report 2026-09-04 без контрольной группы; перспективный референс spec-as-source, не прогноз стоимости корпоративного продукта |
| Критика SDD | Böckeler различает spec-first, spec-anchored и spec-as-source, обсуждает многословие, ревью и сопровождение мнение [S44] | Практический критический разбор версий 2025; актуальные quick/bugfix ветви продуктов нужно оценивать отдельно |
Главный спор касается цены ясности. Подробность помогает передаче и проверке, но преждевременно фиксирует решения и требует обслуживания; короткий документ облегчает обсуждение, но предполагает доступный общий контекст. Эти позиции совместимы при разделении стадии выбора и пакета исполнения, но универсальный порог страниц источники не устанавливают гипотеза.
Что изменилось в 2023–2026
- LLM стала и автором, и адресатом. Появились исследования генерации/анализа требований и специализированные agent instructions; теперь требуется проверять происхождение предложенного требования, а не только качество языка эмпирика [S7, S39]; факт [S34].
- Спецификация приблизилась к автоматическому исполнению. Spec Kit и Kiro связывают requirements/design/tasks, но обещание source of truth требует собственного процесса изменений и проверки расхождения факт [S32, S33]; гипотеза.
- Появилась критическая эмпирика контекста. Работы 2026 отделяют соблюдение инструкций, стоимость и правильность, ослабляя аргумент о пользе автоматически сгенерированного большого AGENTS.md по умолчанию эмпирика [S8, S41].
- Сохранилась человеческая ответственность за смысл. Structured Outputs ограничивает форму ответа, а сама документация предупреждает об ошибках содержимого; техническая валидность не даёт права модели утверждать бизнес-требования факт [S45]; гипотеза.
Где применимо и где нет, плюсы и минусы
Подходит, когда
- Работа передаётся между людьми или агентами. Общий разговор перестаёт быть доступным контекстом, поэтому фиксируются входы, результат, границы полномочий и способ проверки; для сотрудника это task brief, для агента — пакет задачи с исполняемыми примерами гипотеза.
- Ошибку дорого обратить. Миграция данных, внешний подряд и обязательство перед клиентом требуют заранее определённых отклонений, возврата и принимающего, даже если сама работа короткая гипотеза.
- Поведение повторяется или связывает системы. Контракт и регрессионные проверки сохраняют одинаковый смысл при смене исполнителя; спецификация отдельного запуска ссылается на действующую инструкцию, а не копирует её гипотеза.
- Решение ещё обсуждается. One-pager, PR-FAQ, pitch или RFC позволяют сравнивать варианты до реализации; приёмкой этого этапа является решение либо проверенная гипотеза, а не готовый продукт гипотеза.
Не подходит, когда
- Неизвестен даже нужный результат. Детальный исполнительский контракт закрепляет догадки; сначала нужен discovery brief с вопросом, способом проверки и пределом затрат гипотеза.
- Локальное изменение дёшево и немедленно наблюдаемо. Отдельные PRD, RFC и протокол для исправления опечатки дают больше обслуживания, чем информации; достаточно карточки с проверкой результата гипотеза.
- Текст заменяет отсутствующее решение владельца. Ни дополнительная страница, ни более сильная LLM не выбирают легитимно коммерческий компромисс, приемлемый риск или обязанность клиента гипотеза.
- Исполнитель не может прочитать или применить формат. Git-процесс для полевого сотрудника без связи или Gherkin для клиента без подготовки создаёт барьер; нужны краткая карточка, пример, фото и доступный канал сдачи гипотеза.
Плюсы
- Разделение результата и способа. Можно делегировать реализацию, сохранив наблюдаемые обязательства и допустимые границы; глубина предписания определяется ценой ошибки гипотеза.
- Проверяемая передача работы. Связи requirement → criterion → evidence позволяют объяснить принятие или возврат без ссылки на память участников гипотеза.
- Повторное использование знания. Живой контракт, версия входов и история решения снижают необходимость заново восстанавливать контекст; величина выигрыша требует измерения на собственных задачах гипотеза.
- Машинная проверка части ошибок. Схема, ссылки и проверки обнаруживают пропущенные поля, неизвестные идентификаторы и расхождения версий до запуска; истинность бизнес-потребности остаётся вне этой проверки гипотеза.
Минусы
- Цена сопровождения. Чем больше независимых копий правила, тем больше мест нужно обновлять при изменении; дублирование текста между PRD, задачей и тестом увеличивает риск расхождения гипотеза.
- Ложная уверенность. Грамматически точное требование может закрепить неверную гипотезу, а успешный тест — проверять неполный набор случаев гипотеза.
- Сужение пространства решения. Предписания внутренней реализации до проверки проблемы уменьшают свободу специалиста и могут повысить стоимость результата гипотеза.
- Неравная доступность контекста. Агенту, подрядчику и клиенту нельзя автоматически выдавать весь внутренний корпус; подготовка доступного представления и проверка полноты ссылок требуют отдельной работы гипотеза.
Альтернативы и дерево решений
Сравниваются способы зафиксировать одну работу и передать её исполнителю. Предмет сравнения — предлагаемое общее ядро с представлениями; альтернативы — более узкие пакеты документов. Они могут дополнять друг друга, поэтому критерий выбора — самый лёгкий пакет, закрывающий конкретные неизвестные и цену ошибки гипотеза.
| Пакет | Когда целесообразнее | Что выигрывает относительно общего ядра | Что теряет / чем дополнять | Цена сопровождения |
|---|---|---|---|---|
| Общее ядро + представления по аудиториям | Продукт управляет смешанными исполнителями, версиями и приёмкой | Единые связи и проверяемые переходы между формами | Требует реализации модели и человеческого review смысла | Начальные вложения выше; проект автора гипотеза |
| One-pager / PR-FAQ / pitch | Ещё выбирается проблема, ценность или ставка | Быстрое обсуждение зачем и границ | Не готовый task contract; перед исполнением добавить критерии и приёмку | Низкая для одноразового решения мнение [S1, S11, S14]; оценка гипотеза |
| Story + acceptance examples | Небольшое изменение поведения, владелец доступен | Минимум формы, удобная проверка ценного среза | Сложные ветви и системные ограничения приходится связывать отдельно | Низкая, пока объём ограничен факт [S17, S18, S20]; оценка гипотеза |
| Use case + требования качества | Процесс проходит через роли, состояния и исключения | Видны ветвления и итог каждой ветви | Не выбирает архитектуру и не задаёт весь API | Средняя: меняется вместе с процессом факт [S19]; оценка гипотеза |
| RFC/design doc + ADR + задача | Главная неизвестность — технический выбор | Явные альтернативы и история решения | RFC не заменяет контракт результата и критерии задачи | Оправдана значимым решением факт [S2, S3]; мнение [S16] |
| Contract-first + примеры и tests | Есть межсистемная граница и несколько потребителей | Автоматическая проверка структуры/совместимости, генерация части tooling | Семантика прав, повторов, отказов и бизнес-цели остаётся за схемой | Высокая окупаемость повторного использования — гипотеза, не измеренный ROI факт [S22, S5, S23]; гипотеза |
| Task brief + checklist/образец | Исполнитель выполняет известную ограниченную работу | Понятнее сотруднику, легко выдать мобильную/печатную карточку | Для значимого нового решения слишком узок | Низкая при ссылке на действующую инструкцию факт [S26, S27]; оценка гипотеза |
| SOW / клиентский brief + acceptance schedule | Внешняя граница ответственности и поставки | Явные deliverables, входы сторон и порядок сдачи | Цена письменных изменений, риск зафиксировать недоказанные ожидания | Выше из-за внешних зависимостей факт [S4, S28]; мнение [S46]; оценка гипотеза |
Самая сильная альтернатива для малого обратимого изменения — карточка результата с примерами и проверкой. Общее ядро не должно заставлять создавать RFC, SRS или отдельный акт там, где те же сведения помещаются в задаче; machine-readable запись может существовать под простым интерфейсом гипотеза.
Связь с типом работы
Классификатор из соседнего исследования недоступен по условиям независимости. Ниже предлагается совместимая ось work_type, которую координатор должен сопоставить с фактическими названиями; соответствие с тем исследованием не заявляется гипотеза.
| Временный тип работы | Что неизвестно | Основная форма | Что принимается |
|---|---|---|---|
| Исследование / discovery | Какой результат нужен и достижим ли он | Discovery brief / one-pager | Свидетельства и решение по гипотезе |
| Новая поставка | Требуемое поведение, затем решение | PRD/pitch → по необходимости RFC → задачи | Поставляемый результат; бизнес-эффект отдельно |
| Изменение / исправление | Разница между текущим и нужным | Change brief / bug specification | Воспроизводимый дефект устранён, регрессии проверены |
| Повторяемая операция | Конкретные входы, место и срок | Task brief + ссылка на work instruction | Результат данного запуска и исключения |
| Инцидент | Сначала состояние, затем безопасное действие | Incident brief + действующая инструкция восстановления | Восстановление по критериям и запись фактов; разбор позже |
| Продолжающийся сервис | Уровень качества и способ наблюдения | Service specification + SLO/SLA | Отчётный период, нарушения и действия |
| Внешняя проектная поставка | Разделение ответственности и условия сдачи | SOW / ТЗ + матрица приёмки | Версия deliverables и протокол приёмки |
Дерево решений
- Если результат ещё неизвестен или успехом считается новое знание→discovery brief с гипотезой, источниками, ограничением затрат и критерием завершения.
- Если обсуждается клиентская ценность новой возможности→one-pager PRD либо PR-FAQ с реестром неподтверждённых обещаний.
- Если проблема ясна и выбирается объём в фиксированном appetite→Shape Up pitch с обязательным результатом и no-gos.
- Если сравниваются технические варианты→RFC/design doc с планом проверки спорных предположений.
- Если работа — продолжающийся сервис→service specification + SLO; при обязательстве внешней стороне — SLA с измерением и процедурой разбора периода.
- Если требуется срочное восстановление→incident task brief со stop conditions, проверкой восстановления и ссылкой на действующую инструкцию; ADR после стабилизации при смене решения.
- Если результат известен и исполнитель внешний→пакет результата с явной процедурой сдачи.
- Если исполнитель — подрядчик или партнёр→SOW/ТЗ + deliverables + acceptance matrix + change log.
- Если документ предназначен клиенту для уточнения и получения услуги→клиентский brief + образец результата + обязанности клиента + правила feedback и приёмки.
- Если результат известен и исполнитель — сотрудник подразделения→task brief с входами, местом, временем, способом сдачи.
- Если операция повторяемая и инструкция существует→карточка запуска + версия work instruction + checklist исключений.
- Если операция новая либо дорого обратимая→расширенный task brief + подтверждение понимания + промежуточная контрольная точка до необратимого действия.
- Если работа недорогая и полностью наблюдаема→короткая карточка результата с одной процедурой проверки.
- Если результат известен и исполнитель — разработчик или агент→пакет инженерной задачи.
- Если цена ошибочного технического решения высока либо нужна миграция/новая граница системы→mini-RFC/design doc + выбранный контракт + план rollback + задачи; ADR для причины выбора.
- Если главная сложность — несколько акторов и ветвлений процесса→use case + требования качества + acceptance scenarios.
- Если главная граница — HTTP, события или структура данных→OpenAPI, AsyncAPI либо JSON Schema соответственно + семантические правила + contract tests.
- Если исправляется дефект→bug specification: воспроизведение, expected/actual, область регрессии и критерии.
- Если изменение небольшое и обратимое→user story/task brief + примеры приёмки + ссылка на DoD.
- Если исполнитель — LLM при любом предыдущем выборе→тот же выбранный пакет плюс manifest контекста, полномочия, команды проверки, формат evidence и stop conditions.
Модификатор цены ошибки применяется ко всем веткам. При необратимой операции добавляются независимая проверка до действия, точная baseline и полномочия на выполнение; при низком риске роли владельца и принимающего могут совпадать. Это проектное правило, а не обязательный корпоративный ритуал гипотеза.
Практическое применение
Жизненный цикл без отдельного ритуала на каждую задачу
Единица управления — версия обязательств. Предлагаемый процесс допускает короткую карточку и совмещение ролей; обязательны ясность полномочий и след от требования к доказательству, а не число встреч гипотеза.
| Шаг | Действие LLM / системы | Решение человека | Выход и условие перехода |
|---|---|---|---|
| 1. Intake | Сохраняет исходную формулировку и её источник без «улучшения» смысла | Называет владельца и адресата результата | Brief запроса, вид работы, первоначальные неизвестные |
| 2. Интервью | Уточняет реальный сценарий, пример провала, границы и приёмку | Выбирает бизнес-компромиссы и подтверждает факты | Ответы связаны с будущими requirements; молчание не равно согласию |
| 3. Черновик | Формирует минимальный пакет, отделяет facts/assumptions/proposals | Проверяет ожидаемый результат на конкретном примере | Draft с блокирующими вопросами, а не скрытыми догадками |
| 4. Проверка полноты | Проверяет структуру, ссылки, роли, ошибки/границы, противоречия | Предметный эксперт оценивает смысл и опасные пропуски | Отчёт дефектов; исправление текста не меняет требования без решения |
| 5. Review и baseline | Показывает разницу версий, список must и исключений | Владелец утверждает версию и разрешённый объём | Approved revision; утверждение хранится событием приложения |
| 6. Подготовка исполнения | Формирует представление по аудитории и доступный context manifest | Назначает исполнителя и принимающего | Пакет содержит входы, методы проверки, полномочия и stop conditions |
| 7. Выполнение | Исполнитель делает работу, сохраняет факты и исключения | Решает новые смысловые вопросы и изменения scope | Result revision и evidence; недостаток контекста виден как blocker |
| 8. Проверка и приёмка | Проверяет комплект, версии и criteria; готовит сводку | Уполномоченный принимающий принимает/возвращает/отклоняет | Протокол по той же baseline; тест не создаёт человеческое одобрение |
| 9. Эксплуатация | Обновляет действующий контракт, сигнализирует о drift | Решает, нужны ли пересмотр цели и новая версия | Ссылки на текущую спецификацию; прошлое решение и акт сохраняются |
Docs as code — один способ обеспечить этот цикл. Git, review и автоматические проверки позволяют менять текст вместе с кодом; Google отдельно рекомендует сохранять реализованные design docs как историю, а действующую документацию обновлять с изменением системы факт [S31, S30]. Для сотрудников тот же цикл может выглядеть как карточка в мобильном приложении, а не pull request гипотеза.
Сквозной пример A: задание агенту кодирования
Все предметные параметры примера — иллюстрация; локальный прогон ниже выполнен реально. Задача — предварительно проверить импорт задач из CSV без записи в систему. Потребность, поведение и поручение помещены в один небольшой пакет; отдельный RFC здесь не требуется гипотеза.
| Поле | Заполнение |
|---|---|
| Владелец / исполнитель / принимающий | Для локального прогона: основной исследователь / отдельный coding agent / основной исследователь как технический проверяющий; пользователь не утверждал продуктовую поставку |
| Результат | Python 3.12 plan_import(csv_text, existing_ids) → status, create, errors; модуль и записка о проверках |
| Входит | Разбор CSV, проверка входов, план новых задач; только стандартная библиотека |
| Не входит | UI, БД, запись, выбор компании, авторизация; existing_ids уже передан для выбранной компании |
| Полномочия | Писать только в выделенный каталог; без сети, установки пакетов и внешних действий |
| Контракт | Заголовок точно external_id,title; один ведущий BOM допускается; CSV reader strict=True; сначала полный синтаксический разбор |
| Правила | Поля обрезаются str.strip(); ID и title непустые; title до 80 Unicode code points; повтор ID в файле запрещён, регистр учитывается |
| Атомарность | Любая ошибка → invalid и пустой create; существующие ID не создаются, но проверяются; ошибка в первой дублирующей записи не отменяет duplicate во второй |
| Ошибки | Синтаксис: только malformed_csv, row 0; header: invalid_header, row 1; далее wrong_field_count, empty_id, empty_title, title_too_long, duplicate_id по определённому порядку |
| Нумерация | row — номер записи reader, не физической строки; пустая запись [] даёт wrong_field_count |
| C-A1…C-A5 | Синтаксис/header, поля/границы, дубликаты/атомарность, quoted CSV/номера записей, отсутствие мутаций/внешнего I/O |
| Сдача / возврат | Версия модуля + логи; возврат с ID критерия; смысловой дефект → новая версия спецификации, не молчаливое исправление теста |
Пример трассировки: R-A5 «внутренние дубликаты запрещены» → задача T-A1 «реализовать планировщик» → C-A3 «второй ID даёт duplicate» → evidence проверки → техническая оценка этой версии. Бизнес-разрешение на импорт в production в эту цепочку не включено гипотеза.
Реальный прогон выявил ошибку спецификации до реализации. В версии 1.0 автор ошибочно написал, что csv.reader пропускает пустые физические строки; исполнитель воспроизвёл возврат пустой записи и сообщил блокер. После одного уточнения версия 1.1 выполнена без дополнительных вопросов, исполнитель сдал функцию и выполнил 19 собственных тестов; основной исследователь отдельно сформировал 19 проверочных примеров и статическую проверку I/O — все 20 проверок прошли.
- Воспроизведение:
python -X utf8 pilot/acceptance_check.py. - Артефакты: исходная версия, уточнённое задание, модуль, независимые проверочные случаи, протокол с SHA-256.
- Граница результата: это технический опыт на одной искусственной задаче, с агентами одной модельной семьи, без рандомизации и человека-исполнителя. Проверки написаны основным исследователем до чтения кода реализации, но не являются независимым внешним исследованием.
Первичная передача не выдержала критерий «без уточнений». Это не скрывается успешным повтором: данный прогон подтверждает пользу обнаруживаемого блокера и версионного исправления, но не доказывает универсальную исполнимость предложенного стандарта. «Без вынужденного угадывания» предлагается как более безопасная цель, а долю передач без уточнений — измерять отдельно гипотеза.
Сквозной пример B: задание сотруднику в поле
Сценарий и числа — иллюстрация, полевого испытания не было. Руководителю нужен отчёт о состоянии точек поливной линии, чтобы назначить ремонт; сотрудник выполняет осмотр, а не ремонт. Карточка содержит маршрут K01–K12 по приложенной схеме route-v3, не требует доступа к инженерной документации продукта гипотеза.
| Поле | Заполнение |
|---|---|
| Роли | Владелец — руководитель участка; исполнитель — назначенный обходчик; принимает — сменный мастер |
| Входы | Схема route-v3, список 12 ID, инструкция безопасного осмотра WI-07 revision 2, телефон/бумажная форма; фактический доступ подтверждается перед выходом |
| Результат и срок | Отчёт по 12 точкам до 17:00 Europe/Kyiv указанной в карточке даты; дата и смена обязательны |
| Входит / не входит | Осмотр с безопасной точки, фото и регистрация; вскрытие узлов, ремонт и изменение режима оборудования исключены |
| R-B1 | Для каждой точки ровно одна категория: «проблема», «нет видимой проблемы», «недоступно»; отсутствие записи не равно «недоступно» |
| R-B2 | Доступная точка: ID, время, фото общего вида с привязкой к метке; при проблеме — дополнительное фото и краткое описание. GPS — если доступен, его отсутствие явно отмечается |
| R-B3 | Недоступная точка: причина, последнее безопасное место осмотра, время, уведомление мастеру по указанному каналу; запрещено обходить ограничение ради полноты |
| R-B4 | При отсутствии связи запись хранится локально; после восстановления передаётся без изменения исходного времени; невозможность уложиться в срок — отдельное исключение |
| C-B1 | Сверка множества ID с маршрутом: 12 уникальных записей и ни одной чужой |
| C-B2 | Для всех доступных точек есть обязательные поля и различимое фото нужного объекта |
| C-B3 | Для всех недоступных точек есть причина и след уведомления; статус не выдаётся за факт исправности |
| Сдача и возврат | Мастер проверяет записи и фото до 10:00 следующего календарного дня; возвращает только дефектные записи с ID критерия, повторный выход решается отдельно |
| Допустимое исключение | При 11 осмотренных и одной недоступной точке отчёт может быть принят как полный отчёт с исключением; исправность всех 12 точек не подтверждена |
Объект приёмки — достоверный отчёт о выполненном обходе. Требование «везде поставить галочку» создало бы стимул скрывать недоступность; предложенная форма разделяет завершение отчётности и состояние оборудования гипотеза. Рекомендации HSE о понятном действии, явном pass/fail и соответствии инструкции условиям работы поддерживают анатомию карточки, но не подтверждают эффективность этого конкретного сценария факт [S26, S27].
Сквозной пример C: ТЗ подрядчику с приёмкой
Сценарий и числа — иллюстрация, подрядчик не привлекался. Требуется модуль импорта контактов в staging на фиксированном наборе contacts-v1.csv: 1000 строк, из них заранее размечены 980 корректных и 20 некорректных. До baseline стороны проверяют эту разметку и фиксируют контрольную сумму реального файла; фиктивная checksum в договорённость не подставляется гипотеза.
| Поле | Заполнение |
|---|---|
| Владелец / исполнитель / принимает | Руководитель CRM-проекта / подрядчик / назначенный представитель заказчика |
| Вклад заказчика | Обезличенный CSV и эталонная разметка, таблица соответствия полей, staging-доступ с ограниченными правами, согласованный API-контракт |
| D-C1 | Исходный код модуля и инструкция воспроизводимого запуска |
| D-C2 | Отчёт на fixture: 980 созданных контактов, 20 отклонённых с номером строки и причиной; равенство сверяется с эталоном |
| D-C3 | Повторный запуск того же файла: ноль новых контактов; ключ дедупликации — согласованный внешний ID в границе компании |
| D-C4 | Отчёт проверок и процедура удаления только объектов тестового запуска по его идентификатору |
| Не входит | Production-запуск, исправление исходных данных, новые правила нормализации телефонов, поддержка других источников |
| Приёмочная среда | Указанная версия staging, зафиксированные исходные данные и пустое множество объектов данного тестового запуска |
| C-C1 | Все 980 ожидаемых объектов совпадают по утверждённому mapping; 20 ошибок совпадают с эталоном |
| C-C2 | Повтор не создаёт дубликатов и не меняет чужие данные |
| C-C3 | Проверка доступа и удаления тестового запуска подтверждает границу компании/набора |
| Процедура | Подрядчик уведомляет о комплекте сдачи; принимающий за 2 календарных дня проверяет его по той же baseline; часы отсчитываются от зафиксированного времени получения полного комплекта |
| Возврат | Таблица criterion ID → наблюдение → evidence → ожидаемое исправление; после новой сдачи повторяются затронутые проверки и связанная регрессия |
| Изменение | Просьба дополнительно нормализовать телефоны оформляется change request с новым scope, сроком и критериями; это не дефект уже согласованного результата |
Акт здесь — операционный протокол, а не юридическая форма. В нём фиксируются версия ТЗ, версия поставки, проверенные deliverables, результаты C-C1…C-C3, ссылки на evidence, решение, ответственное лицо и дата. Юридические требования к подписи, оплате, ответственности и последствиям акта находятся вне исследования гипотеза.
Сквозной пример D: бриф для клиента
Сценарий и числа — иллюстрация, интервью не проводились. Клиент заказывает диагностику процесса обработки заявок: шесть интервью по утверждённому списку ролей, карта текущего процесса, перечень подтверждённых проблем и три варианта улучшения. Рост выручки — возможный отложенный outcome, а не критерий сдачи диагностического отчёта гипотеза.
| Поле | Заполнение |
|---|---|
| Роли | Со стороны клиента — спонсор и единый принимающий; со стороны исполнителя — аналитик |
| Цель | Выбрать, какую из обнаруженных проблем проверять/исправлять первой |
| Вклад клиента | Доступность шести респондентов, разрешённые обезличенные примеры заявок, ограничения на использование данных |
| Поставляемое | Отчёт, карта as-is, реестр фактов/предположений, три сравнимых варианта с основаниями, стоимостью порядка величины и рисками |
| Границы | Внедрение изменений и гарантия экономического эффекта исключены; расчёты эффекта маркируются как оценки |
| C-D1 | Карта покрывает вход заявки, ответственные роли, основные переходы, исключения и конечное состояние; клиент подтверждает фактическую точность или указывает конкретную ошибку |
| C-D2 | У каждой существенной проблемы есть обезличенный пример/источник или явная метка «гипотеза»; отсутствующие интервью не объявляются состоявшимися |
| C-D3 | Три варианта сравниваются по одному набору критериев; у каждого есть ожидаемый результат, предпосылки и способ проверки |
| Приёмка | Демонстрация одного типичного и одного проблемного сценария по карте; единый список замечаний от принимающего в течение 3 календарных дней от полной сдачи |
| Возврат | Ошибка факта, пропуск согласованного deliverable или нарушение рубрики — доработка; новый бизнес-вопрос — отдельное изменение |
| Исключение | Если доступны только четыре респондента, документ отмечает пробел; принять меньший объём можно только по явно изменённой baseline |
Субъективное качество нуждается в рубрике, а не в фиктивной точности. Для клиента можно закрепить уровни «есть подтверждение / есть гипотеза и план проверки / нет основания» и требование не оставлять существенные выводы без статуса. Один общий балл «качество 8 из 10» не объясняет основание возврата гипотеза.
Вход, первые ошибки и жизнь через месяцы
| Затраты входа | Иллюстративный ориентир для пилота | Что фактически требуется |
|---|---|---|
| Простая карточка | 15–30 минут на первое заполнение | Владение предметом, способность назвать результат и проверку |
| Новый шаблон подразделения | 1–2 рабочих дня на несколько реальных задач | Владелец процесса, исполнитель, принимающий и разбор разночтений |
| Машинные проверки | 2–5 рабочих дней для ограниченного прототипа | Разработчик, JSON Schema/семантические проверки, доступ к данным и версиям |
| Постоянное сопровождение | Измерять отдельно; универсальная доля времени неизвестна | Изменение требований, контекстных пакетов и evidence после изменения результата |
Числа таблицы — плановые иллюстрации, не отраслевые нормы и не смета этого продукта. Платформа не обязательна для начала: возможны текстовый шаблон и таблица критериев. Основная компетенция — предметное решение и проверка, поэтому доступ к LLM не устраняет стоимость владельца и принимающего гипотеза.
- Ошибка первого применения: перенос всех разделов PRD в каждую задачу. Исправление — минимальное ядро и расширения по риску гипотеза.
- Ошибка первого применения: LLM заполняет неизвестные числовыми порогами. Исправление — provenance и подтверждение must до baseline гипотеза.
- Ошибка первого применения: критерии пишет только исполнитель после реализации. Исправление — фиксировать ожидаемое наблюдение до работы, оставляя исполнителю свободу выбора способа гипотеза.
- Через месяцы: универсальных продольных данных для этого смешанного контекста не найдено; опрос DoD показывает, что правила иногда не обновляются, но не задаёт частоту пересмотра эмпирика [S38].
- Предлагаемый режим: пересматривать при изменении поведения, повторной ошибке, смене исполнителя/среды и окончании срока предпосылки; календарный обзор нужен только тем объектам, для которых нет надёжного событийного сигнала гипотеза.
Артефакты
Комплект и владельцы
Все шаблоны этого раздела — авторское предложение. Они не объявляются внедрёнными, согласованными с пользователем или соответствующими полному нормативному тексту ISO; JSON Schema и демонстрация являются локальными прототипами гипотеза.
| Артефакт | Назначение и поля | Кто создаёт / как живёт / когда устаревает | Заполненный пример |
|---|---|---|---|
| Intake record | Исходный запрос, источник, дата, owner, контекст, неизвестные, решения интервью | LLM сохраняет, человек подтверждает ответы; исходный запрос не переписывается | «Нужен предварительный импорт задач» → владелец уточнил: план без записи |
| Product brief / PRD | Проблема, evidence, аудитория, сценарий, outcome, scope, non-goals, assumptions, критерий следующего решения | Product owner с LLM; пересмотр при смене проблемы/целевой аудитории | Менеджер должен увидеть ошибки CSV до создания задач; запись в БД исключена |
| Technical design / RFC | Контекст, constraints, варианты, выбранное решение, отказы, контракты, проверка, rollout/rollback | Технический владелец; после реализации исторический документ со ссылкой на текущие контракты | Чистая функция предварительной проверки; полный разбор до выдачи плана |
| ADR | ID, context, decision, status, consequences, supersedes, review trigger | Автор решения; принятое решение сохраняется, новое помечает прежнее superseded | «Отказ от частичного плана при любой ошибке»; пересмотр, если согласуют иной UX |
| Task packet | ID/revision, goal, roles, inputs, deliverables, scope, requirements, authority, checks, handoff | Владелец формирует для исполнителя; пакет фиксируется на время выполнения | A: R-A1…R-A6, C-A1…C-A5, модуль и записка |
| Матрица трассировки | requirement ID → task ID → criterion ID → evidence ID → acceptance event | Система строит из ссылок; проверяет после каждого изменения | R-A5 → T-A1 → C-A3 → лог duplicate → протокол технической проверки |
| Acceptance protocol | Версии, критерии, observations, evidence, verdict, actor, deviations, дата | Принимающий; неизменяемая запись, исправление отдельным событием | B: 12 записей, одна inaccessible; принят отчёт, исправность всей линии не подтверждена |
| Change log / request | Причина, old/new revision, affected IDs, влияние, кто решил, что перепроверить | Инициатор + владелец; история не заменяется новым состоянием | A 1.0 → 1.1: пустые reader-records учитываются и дают wrong_field_count |
| Context manifest | Обязательные входы и версии, доступность, приоритеты, секретность/аудитория, срок актуальности | Система выдачи задания; устаревает при смене любой значимой зависимости | Спецификация 1.1, Python 3.12, фикстуры, разрешённый каталог |
| Service specification | Граница сервиса, consumers, SLI/SLO, окно, исключения, измерение, reviewer, отчёт и действия | Владелец сервиса; меняется только вместе с правилами измерения и обязательств | Оценивать долю обращений с первым ответом в установленное время; пустое окно отдельно |
Универсальный минимальный шаблон
spec:
id: TASK-A
revision: "1.1"
kind: task
owner: владелец результата
executor: назначенный исполнитель
acceptor: уполномоченный принимающий
goal: какой наблюдаемый результат нужен и зачем
inputs: ссылки, версии, доступность
deliverable: объект, формат, место сдачи
scope_in: что входит
scope_out: что исключено
requirements:
- id: R-A5
text: повтор нормализованного ID в одном CSV запрещён
source: решение владельца в записи интервью
certainty: confirmed
priority: must
checks:
- id: C-A3
requirement_ids: [R-A5]
method: test
setup: CSV с повторным ID
expected: invalid, пустой create, duplicate_id
evidence: лог + версии спецификации и результата
authority: допустимые действия, запреты, stop conditions
acceptance: кто, где, когда проверяет, как оформляет возврат
unresolved: блокирующие вопросы и кто их решает
Шаблон YAML показывает редакторскую форму, а не второй конкурирующий API. При реализации его поля должны однозначно отображаться на машиночитаемую модель ниже; нельзя поддерживать два независимо редактируемых списка требований гипотеза.
Дополнения шаблона по адресатам
| Профиль | Обязательные дополнительные поля | Пример заполнения | Что принимается |
|---|---|---|---|
| Агент | Рабочая среда, разрешённые пути/инструменты, commands, output contract, context manifest, stop conditions | python -X utf8 pilot/acceptance_check.py; внешняя запись запрещена |
Код/артефакт и evidence; право deployment отдельно |
| Разработчик | Изменяемое поведение, совместимость, зависимости, NFR, rollout при необходимости | Изменить правило импорта, сохранив существующие ID | Поведение и общее качество по DoD |
| Сотрудник | Объект/место, дата/часовой пояс, материалы, последовательность если нужна, пределы и контакт при отклонении | K01–K12, фото доступных точек, inaccessible с причиной | Результат конкретной операции с исключениями |
| Подрядчик | Deliverables, вклад заказчика, комплект сдачи, acceptance environment, сроки review, change request | D-C1…D-C4 и C-C1…C-C3, staging, 2 календарных дня — иллюстрация | Поставка по зафиксированной baseline |
| Клиент | Ожидаемый результат обычным языком, что предоставить, пример, один принимающий, рубрика и период feedback | Карта процесса и 3 варианта, 6 интервью — иллюстрация | Согласованные deliverables, не обещанный будущий доход |
| Сервис | Eligible events, SLI, target, окно, exclusions, measurement owner, dispute process | Доля ответов по журналу с однозначным началом отсчёта | Период наблюдения и меры по нарушению |
Чек-лист качества перед выдачей
- Q1. Потребность: понятны адресат результата и причина работы; источник не заменён текстом LLM гипотеза.
- Q2. Ответственность: назначены owner, executor и acceptor; совмещение ролей явно гипотеза.
- Q3. Граница: указаны deliverable, входит/не входит, зависимости и вклад другой стороны гипотеза.
- Q4. Значимость: каждое must связано с потребностью, обязательным ограничением или явным решением гипотеза.
- Q5. Происхождение: facts, assumptions и proposed decisions различаются; LLM не подтверждает собственную догадку гипотеза.
- Q6. Атомарность: одному ID соответствует самостоятельно проверяемая обязанность, составная разбита либо обоснована гипотеза.
- Q7. Язык: определены субъект, термины, условия, кванторы, единицы, границы и время гипотеза.
- Q8. Поведение: разобраны релевантные успех, отказ, отсутствие/повтор входа, отмена и частичное выполнение гипотеза.
- Q9. Качество: производительность, доступ, надёжность и другие важные ограничения выражены наблюдаемо; неприменимое не добавлено ради шаблона гипотеза.
- Q10. Критерий: у каждого must есть метод, ожидаемое наблюдение и проверяющий; проверка технически выполнима гипотеза.
- Q11. Приёмка: определены evidence, версии, уполномоченный actor, сроки review и возврат гипотеза.
- Q12. Полномочия: известны разрешённые действия и условия остановки до необратимого шага гипотеза.
- Q13. Контекст: исполнитель реально получает обязательные материалы той же версии и может их открыть гипотеза.
- Q14. Целостность: ID уникальны, ссылки существуют, нет блокирующих неразрешённых вопросов у выдаваемого must гипотеза.
- Q15. Изменения: новая версия показывает влияние на задачи, проверки и прежнее evidence гипотеза.
- Q16. Пробная передача: исполнитель воспроизводит цель и один сложный сценарий; разночтения фиксируются до исполнения гипотеза.
Положительный checklist означает готовность к следующему шагу, а не математическую полноту требований. Автоматизируются Q2/Q10/Q14 в части наличия связей и полей; предметная достаточность Q1/Q4/Q8/Q9 остаётся review, даже если помогает LLM гипотеза.
Протокол приёмки
| Поле протокола | Пример для B, полностью иллюстративный |
|---|---|
| Объект | Отчёт обхода участка, не исправность оборудования |
| Основание | TASK-B revision 1, route-v3 |
| Версия результата | report-v1; в рабочем продукте — реальный immutable ID/hash |
| Проверяющий / полномочие | Назначенный сменный мастер, полномочие задано владельцем |
| C-B1 | 12 уникальных записей K01–K12 — pass, ссылка на сверку |
| C-B2 | У 11 доступных точек нужные поля и различимые фото — pass |
| C-B3 | K07 inaccessible, есть причина и след уведомления — pass |
| Отклонения | K07 не осмотрена физически; предусмотренное контрактом исключение |
| Решение | Принять отчёт; дальнейший доступ/осмотр — отдельное задание |
| Дата | Фактическое время решения с часовым смещением; не время генерации черновика LLM |
| Возврат при другом исходе | criterion ID, наблюдение, ссылка на evidence, нужное исправление, повторная сдача |
Новое отклонение нельзя незаметно оформить как pass. В минимальной модели обязательный критерий либо выполнен, либо результат возвращён/отклонён; изменение критерия создаёт новую baseline. Более развитый продукт может добавить explicit waiver с владельцем риска, сроком и отдельной видимой категорией приёмки, но такой механизм не реализован в приложенной схеме гипотеза.
Журнал изменений
| Изменение | Причина | Затронуто | Решение и последствия |
|---|---|---|---|
| A 1.0 → 1.1, выполнено в локальном опыте | Исполнитель воспроизвёл ошибку описания csv.reader |
R-A1, проверка пустой записи в C-A4 | Автор уточнил семантику, сохранил 1.0; приёмочные случаи строятся по 1.1 |
| C baseline 1 → предложенная 2, иллюстрация | Заказчик просит новую нормализацию телефона | Новый requirement, mapping, ошибки, сроки | До решения владельца не входит в обязательный scope; evidence старой версии не подтверждает новое правило |
| Service revision 2 → предложенная 3, иллюстрация | Меняется начало отсчёта response time | SLI specification и историческая сопоставимость | Старые отчёты сохраняют старую формулу; изменение публикуется как новая метрика |
Машиночитаемая структура
Предлагается разделить состояние документа, исполнения, проверки и приёмки. Одна колонка «Done» не позволяет отличить утверждённое требование от завершённой задачи или принятой поставки. Модель и правила ниже помечены как проектная гипотеза, а реализация в файлах — ограниченный демонстрационный профиль гипотеза.
| Группа / поле | Тип и значения | Проверяемый инвариант |
|---|---|---|
schema_version / revision |
Версия формата / версия содержания, обе строки | Изменение текста не маскируется повышением только версии схемы |
id, kind, audience |
ID; product/technical/task/service; agent/developer/employee/contractor/client | Известный профиль выдачи |
status |
draft, in_review, approved, superseded, retired | Это состояние документа |
owner, executor, acceptor |
Идентификаторы субъектов/ролей | Непустые значения; существование и полномочия требуют внешнего каталога |
goal, scope |
Текст; included/excluded массивы | Граница результата явно задана |
inputs[] |
id, reference, revision, access | Requirement ссылается на существующий источник; реальная доступность отдельно |
requirements[] |
id, text, priority must/should, source_ref, confirmed | Уникальные ID, must подтверждены перед approved |
criteria[] |
id, requirement_ids, method, procedure, expected, evidence_required | Каждое must покрыто хотя бы одним критерием |
tasks[] |
id, requirement_ids, criterion_ids | Ссылки существуют; критерий относится к требованиям задачи |
open_questions[] |
id, text, blocking, resolved | Нет blocking unresolved при утверждении/исполнении принятой версии |
authority |
allowed, forbidden, stop_conditions | Полномочия представлены явно; текст не заменяет sandbox |
execution |
status: not_started/in_progress/submitted/changes_requested/accepted/rejected; artifact_ref, artifact_revision | Принята именно предъявленная версия артефакта |
evidence[] |
id, criterion_id, spec_revision, artifact_revision, result pass/fail/not_run, reference, checker | Доказательство связано с конкретными версиями |
acceptance |
decision pending/accept/return/reject, actor, reason, evidence_ids, версии, decided_at | accept требует все обязательные критерии pass и совпадение принимающего/версий |
change_log[] |
revision, reason, affected_ids | Причина и область изменения сохраняются |
Схема не удостоверяет одобрение. confirmed:true, actor и pass — данные, которые LLM может выдумать; в рабочем продукте эти поля заполняются/подтверждаются доверенным серверным событием, а не принимаются из ответа модели на веру. В приложенном JSON все роли, решения и evidence синтетические, это тест структуры, а не совершившийся обход гипотеза.
{
"id": "SPEC-FIELD-DEMO",
"schema_version": "1.0",
"revision": "r1",
"kind": "task",
"audience": "employee",
"status": "approved",
"requirements": [
{
"id": "REQ-COVERAGE",
"text": "Ровно одна запись для каждой точки K01–K12; числа — иллюстрация.",
"priority": "must",
"source_ref": "INPUT-MAP",
"confirmed": true
}
],
"criteria": [
{
"id": "CRIT-COVERAGE",
"requirement_ids": ["REQ-COVERAGE"],
"method": "analysis",
"procedure": "Сверить множество point_id с версией карты.",
"expected": "Все точки учтены ровно один раз.",
"evidence_required": true
}
]
}
JSON выше — сокращённая проекция для чтения, а не валидный полный экземпляр схемы. Полный пример содержит остальные обязательные поля и явно отмеченные синтетические evidence; машинный потребитель должен использовать полный файл гипотеза.
- Полная схема: specification.schema.json.
- Полный синтетический пример: specification.example.json.
- Проверка семантических связей: validate_spec.py.
- Протокол проверок и границы: schema-check.json, schema-notes.md.
- HTML-демонстрация выбора формы и приёмки: specification-demo.html.
Прототип не равен готовой подсистеме управления требованиями. В нём нет аутентификации, каталога пользователей, электронных подписей, исполнения команд из JSON, долговременного хранилища событий и автоматической проверки фактической доступности внешних evidence. Подробный предел машинной проверки и команда запуска приведены в разделе 10 гипотеза.
С чем используется в связке
Спецификация связывает discovery, исполнение и наблюдение результата. Она работает как граница между этапами, а не как замена продуктового исследования, управления работой или профессиональной компетентности исполнителя гипотеза.
| Связка | Что обычно предшествует | Что следует | Конфликт и его устранение |
|---|---|---|---|
| Discovery → PRD/pitch → delivery | Интервью, данные проблемы, проверка гипотез | Выбор объёма, задачи, измерение эффекта | Нельзя принимать поставку по ещё не наблюдаемой выручке; outcome измеряется отдельно гипотеза |
| RFC → ADR → contract/task | Существенная развилка реализации | История решения и проверяемое поручение | Не поддерживать старый ADR как постоянно переписываемое описание кода факт [S3]; гипотеза |
| Story → examples → tests | Разговор о бизнес-правиле | Автоматическая регрессия при подходящем объекте | Gherkin требует исполняющих шагов; текст сценария сам себя не проверяет факт [S20] |
| Contract-first → implementation → conformance checks | Согласование интерфейса producer/consumer | Проверка совместимости, негативных ответов, версии контракта | Корректная схема сообщения не исчерпывает временную/бизнес-семантику факт [S22, S5, S23]; гипотеза |
| Task brief → work instruction → report | Выданные входы и компетентный сотрудник | Результат операции и исключения | Инструкция не компенсирует отсутствие навыка или физически недоступный объект факт [S26] |
| Acceptance criteria + DoD | Конкретное поведение и общие меры качества | Проверяемая поставка и решение принимающего | Критерии истории не заменяют общую DoD; DoD не создаёт индивидуального акта факт [S18, S6]; гипотеза |
| Docs as code + CI | Изменение поведения в контроле версий | Изменение контракта и связанных проверок в том же review | Нельзя ограничиться автогенерацией документации из кода, когда нужно проверить независимое намерение факт [S31]; гипотеза |
| SLO/SLA + наблюдаемость | Определение качества и источника событий | Периодический отчёт и действия при нарушении | Смена измерения без версии разрушает сопоставимость факт [S29]; гипотеза |
Diátaxis полезен для справочного слоя вокруг спецификаций. Он различает tutorial, how-to, reference и explanation; это классификация потребностей документации, а не схема требований и не процедура приёмки факт [S47]. В продукте инструкция выполнения может быть how-to, контракт — reference, а причины решения — explanation, при этом их статусы и полномочия задаёт модель спецификации гипотеза.
потребность → требование → задача → результат
↓ ↓
критерий ←────────── evidence
↓ ↓
baseline версии → решение о приёмке
Формальные методы — выборочный дополнительный уровень. TLA+ или Alloy целесообразно рассматривать как средство проверки особенно сложных состояний/инвариантов, если соответствующий риск оправдывает компетенции и стоимость; исследование не проводит их сравнение и не объявляет необходимыми для обычной задачи гипотеза.
Метрики здоровья и антипаттерны
Здоровье измеряется качеством передачи и решений, а не длиной документа. Все нормы таблицы — предлагаемые ориентиры внутреннего пилота, если не указано иное; они не являются опубликованными отраслевыми порогами гипотеза.
| Признак | Здоровая норма | Симптом деградации | Источник |
|---|---|---|---|
| Покрытие известных обязательств | Для каждого must есть criterion и ответственный; доля = покрытые must / все must; 100% — целевой структурный ориентир, при нулевом знаменателе метрика неприменима | Requirement существует только в тексте, критерий не привязан | Авторский ориентир гипотеза |
| Актуальность доказательств | Evidence привязано к той же revision spec и artifact, что принимаются | Старый зелёный запуск прикладывают к новой поставке | Авторский ориентир гипотеза |
| Происхождение порогов | У утверждённых must есть источник и решение; assumptions видимы | Цифры LLM становятся обязательством без владельца | Риск изменения ограничений показан в [S7]; правило гипотеза |
| Разночтения при передаче | Учитываются уточнения из-за пропусков, отдельно от новой информации и технического выбора | KPI «ноль вопросов» поощряет угадывание | Авторский ориентир гипотеза |
| Возвраты | Причины разделены: дефект результата / дефект требования / новый scope | Любое недовольство записывается ошибкой исполнителя | Авторский ориентир гипотеза |
| Цена приёмки | Время подготовки/проверки сопоставлено с риском и стоимостью результата | Проверка дороже дешёвого обратимого результата без причины | Авторский ориентир гипотеза |
| Жизнь действующего контракта | Изменение поведения обновляет текущий контракт; исторические решения имеют статус | Новый код и три страницы дают три разных правила | Практика документации [S30]; ориентир гипотеза |
| Общий agent context | Содержит проверенно полезные правила; измеряются success и cost | После автогенерации AGENTS растут расходы без улучшения результата | Разные результаты эмпирики [S40, S8]; ориентир гипотеза |
| Смысл приёмки | Отделены проверка, полномочие и решение | tests_passed автоматически переписан как approved_by_owner |
Авторский ориентир гипотеза |
| Доступность инструкции | Исполнитель может открыть и применить её на месте | Сотрудник фотографирует старую распечатку и угадывает исключения | Guidance [S26, S27]; ориентир гипотеза |
Антипаттерны
«LLM написала роман»
Как выглядит. На короткое поручение создано двадцать страниц общих правил, а критерий возврата найти невозможно; число страниц здесь иллюстрация гипотеза.
Почему возникает. Объём принимается за полноту, модель повторяет исходные требования в PRD, design и tasks, а автор не платит внимание читателя гипотеза.
Как чинить. Свернуть повторения в одно ядро, оставить конкретный результат, существенные исключения и проверки; переместить справку в ссылки с версиями гипотеза.
Когда менять практику. Если стоимость чтения устойчиво превышает цену ошибки для такого класса работы — перейти к task brief или story с примерами, сохранив приёмку гипотеза.
«Спецификация как оружие, приёмка по настроению»
Как выглядит. После сдачи принимающий добавляет новое требование и утверждает, что исполнитель должен был догадаться; либо подрядчик прячет очевидный дефект за буквальным пробелом текста гипотеза.
Почему возникает. Нет baseline, процедуры изменений и общего понимания цели; документ обслуживает спор о виноватом вместо определения результата гипотеза.
Как чинить. Разделить дефект, неопределённость и новое пожелание; оформить наблюдение по criterion ID, решение владельца и изменение версии при смене обязательств гипотеза.
Когда менять практику. Если доверия недостаточно для совместного уточнения, для внешней границы нужен более строгий SOW/acceptance schedule и контроль входов; один более длинный PRD конфликт полномочий не исправит гипотеза.
«Переспецификация до знания»
Как выглядит. До проверки потребности выбраны технология, все внутренние классы и подробные сроки; альтернативный способ результата запрещён без причины гипотеза.
Почему возникает. Неизвестность маскируется деталями, а продуктовый вопрос преждевременно превращается в техническое поручение гипотеза.
Как чинить. Вернуть непроверенное в hypotheses, задать discovery brief; в исполнительской версии сохранять обязательное поведение и реальные constraints гипотеза.
Когда менять практику. Если требования меняются после каждого контакта с пользователем, сначала нужны исследование/прототип/ставка малого размера, а не полный SRS гипотеза.
«Устаревшая правда в нескольких местах»
Как выглядит. PRD допускает частичный импорт, API возвращает другой результат, а старый ADR запрещает новый режим гипотеза.
Почему возникает. Исторические объяснения и действующие обязательства не различены, копии не имеют владельца, обновление считается факультативным гипотеза.
Как чинить. Выбрать владельца каждого правила, связать представления ID, версионировать контракт, пометить исторические документы superseded/implemented и проверить затронутые evidence гипотеза.
Когда менять практику. Если ручное обслуживание копий стабильно не работает, перейти к единому структурированному источнику и производным представлениям; историю решений всё равно сохранять гипотеза.
«Есть задача, нет владельца и исполнителя»
Как выглядит. Карточка наполнена acceptance criteria, но никто не вправе решить спорный порог, исполнитель не назначен, срок review отсутствует гипотеза.
Почему возникает. Генерация документа подменяет делегирование и передачу полномочий; автоматизация проверяет наличие текста вместо ответственности гипотеза.
Как чинить. Блокировать выдачу обязательной работы без owner/executor/acceptor и доступных входов; разрешить совмещение ролей в малой команде гипотеза.
Когда менять практику. Если владелец результата неизвестен, требуется решение об ответственности или отмене работы; новый инструмент спецификаций проблему не решит гипотеза.
Инструменты и софт
Инструмент выбирается после модели ответственности и приёмки. Следующие возможности и цены проверены по публичной документации 2026-09-21, продукты не запускались; сравнение удобства для данного продукта остаётся гипотезой. Валюта указанных платных цен — USD, стоимость внедрения и налоги не включены гипотеза.
| Продукт / экосистема | Сущности и операции | Связи и интеграции | Ограничение для спецификаций | Цена входа на дату проверки |
|---|---|---|---|---|
| Notion | Pages/blocks, databases, свойства, формы, шаблонные карточки, история страниц | API, webhooks, ссылки/embeds, экспорт Markdown/CSV/HTML | Наличие полей и verified badge не проверяет истинность requirements; на Free ограничены командные blocks, история 7 дней | Free $0; подходит для начала, но история/права и командный объём требуют проверки тарифа факт [S48]; ограничение метода гипотеза |
| Linear | Issues, projects, initiatives и привязанные documents; шаблоны, комментарии, история и ссылки | API/webhooks, связанные задачи, agent guidance через документы | Документ возле issue ещё не обеспечивает requirement-level traceability или отдельную приёмку | Free: 2 команды, 250 issues; Basic $10/пользователь/месяц при годовой оплате факт [S49, S50]; ограничение метода гипотеза |
| Jira + Confluence | Jira work items/статусы/представления; Confluence PRD pages с ролями, требованиями и ссылками на issues | Встроенная связь страниц с Jira, расширяемые процессы | Схему требований и разграничение approval/Done нужно проектировать; сложность настройки — цена вариативности | Jira Free до 10 пользователей; цена Confluence и итог комплектной подписки здесь отдельно не рассчитаны факт [S51, S15]; оценка гипотеза |
| Kiro | Spec и requirements/bugfix, design, tasks; режимы Feature, Bugfix, Quick, анализ требований и выполнение | Работа с репозиторием, Markdown-артефакты; матрица возможностей различает IDE/CLI/Web | Correctness с property-based testing в прочитанной матрице доступен в IDE; доказательство бизнес-приёмки отдельное | Free $0/50 credits; Pro $20/пользователь/месяц и 1000 credits; credit не равен законченной задаче факт [S33, S52]; ограничение метода гипотеза |
Остальные категории как референсы реализации
| Категория | Референсы | Роль в предлагаемом стандарте |
|---|---|---|
| Контрактные схемы и редакторы | OpenAPI/Swagger-экосистема, JSON Schema, AsyncAPI | Хранение контракта, lint, генерация представлений; поддержку версии проверять у выбранной реализации факт [S22, S5, S23]; назначение гипотеза |
| Исполняемые примеры | Cucumber/Gherkin | Связать бизнес-сценарий с кодом проверки; поддерживать step definitions факт [S20] |
| Код и версии документов | Git, Markdown, CI по docs as code | Review изменения поведения вместе с изменением контракта факт [S31] |
| Агентские редакторы и harness | Codex, Claude Code, Cursor, Kiro; открытый GitHub Spec Kit | Загрузить контекст, выполнить ограниченную задачу, предоставить evidence; совместимость AGENTS.md и точное наследование проверять по продукту факт [S34, S53, S54, S32] |
Соло целесообразно начать с существующей среды и короткого шаблона. Для инженерной команды — связывать задачи и спецификации в уже используемом tracker/repository; для подразделений — дать понятную карточку и мобильную сдачу, сохранив общую модель. Организации с внешними исполнителями важнее адресный доступ, версии и доказуемое решение принимающего, чем единый редактор для всех; это рекомендации по выбору, не сравнительный тест продуктов гипотеза.
Адаптация под LLM и агентов
Существующие практики и их зрелость
Spec-driven development обозначает несколько разных обещаний. В типологии Böckeler spec-first означает подготовку спецификации до кода, spec-anchored — сохранение её как сопровождаемого ориентира, spec-as-source — спецификацию как основной исходник для получения реализации. Это авторская классификация практики, не формальный стандарт мнение [S44].
| Практика | Что проверено по источнику | Ограничение вывода |
|---|---|---|
| GitHub Spec Kit | Открытый репозиторий с constitution, Markdown-артефактами и текущей последовательностью specify → plan → tasks → implement → converge; есть отдельные входы для исправлений и оценки идей факт [S32] | Прочитан main на дату доступа, commit не закреплён; продуктовая возможность не доказательство эффекта |
| AWS Kiro | requirements.md/bugfix.md, design.md, tasks.md; requirements-first/design-first, Feature/Bugfix/Quick; EARS и анализ требований факт [S33, S42] | Утверждение об однозначности от одного синтаксиса — вендорское обещание, не гарантия вендор [S42] |
| AGENTS.md | Открытый Markdown-формат без обязательной схемы полей для команд, соглашений и контекста факт [S34] | Не является формальной спецификацией одной задачи |
| Codex | Загружает глобальные/проектные инструкции по пути к рабочей папке; документация описывает overrides и лимит совокупного размера, по умолчанию 32 KiB факт [S53] | Поведение загрузчика не гарантирует буквальное исполнение моделью; фактический контекст проверяется отдельно |
| Claude Code | Документация советует проверяемые результаты, планирование, интервью перед значительной работой, отдельный SPEC.md и точечный CLAUDE.md мнение [S54] | Рекомендации производителя, а не независимое сравнение процессов |
| Context engineering | Anthropic описывает релевантный контекст, загрузку по потребности, compaction и устойчивые заметки мнение [S55] | Полное окно контекста не означает правильное использование каждого требования |
| Structured Outputs | Соответствие поддерживаемому подмножеству JSON Schema; документация предупреждает об ошибках содержимого факт [S45] | Не проверяет правильность постановки, полноту и полномочия одобряющего |
Для рассматриваемого продукта предлагается spec-anchored подход. Требования и критерии поддерживаются вместе с поведением, но код, реальные наблюдения и человеческие решения остаются самостоятельными проверяемыми артефактами. Spec-as-source допустим как отдельный эксперимент в ограниченном домене с сильным эталоном, а не как исходная архитектурная догма гипотеза.
LLM как автор: интервью по решениям
Первый результат LLM — карта неизвестных, а не длинный PRD. Вопросы задаются небольшими порциями в порядке влияния на результат и цену ошибки; уже имеющиеся ответы извлекаются из разрешённых источников и предъявляются как сведения с provenance, а не запрашиваются повторно гипотеза.
| Ось интервью | Вопрос владельцу | Что записать | Признак блокирующего пробела |
|---|---|---|---|
| Потребность | Что сейчас происходит и какой конкретный случай это показывает? | Источник, сценарий, ущерб/потеря возможности | Есть только название желаемой функции |
| Адресат | Кто будет выполнять и кто пользоваться результатом? | Audience, executor, рабочая среда | Формат подходит автору, но не исполнителю |
| Результат | Какой объект или изменение должно существовать после работы? | Deliverable и наблюдаемый outcome | Вместо результата названа активность |
| Достаточность | Как будет выглядеть минимально приемлемый результат? | Must, критерии и допустимые исключения | «Качественно», «как обычно», «чтобы удобно» без общего смысла |
| Граница | Что точно не входит? | Scope_out и зависимости | Новые пожелания не отличимы от дефектов |
| Входы | Какие данные, материалы и доступы предоставляет каждая сторона? | Inputs с версией и доступностью | Агент/сотрудник должен домыслить отсутствующий вход |
| Время | От какого события отсчитывается срок, в какой зоне и календаре? | Due, time zone, review window | Пятница/день/срочно трактуются по-разному |
| Ошибки | Что делать при отказе, недоступном объекте, повторе или неполных данных? | Alternative flow, stop condition, escalation | Исполнитель обязан выбирать бизнес-политику сам |
| Качество | Какие ограничения действительно важны и почему? | Порог, единица, среда, источник решения | LLM сама выбрала latency, SLA или допустимый процент брака |
| Полномочия | Какие действия можно выполнить самостоятельно? | Allowed/forbidden и граница необратимых действий | Результат требует невыданного доступа или внешнего обязательства |
| Проверка | Какое наблюдение убедит, что требование выполнено? | Procedure, expected, evidence | Проверка технически невозможна или стоит дороже оправданного риска |
| Приёмка | Кто вправе принять, вернуть и изменить требование? | Acceptor, review procedure, change authority | Два конфликтующих принимающих либо никто не назначен |
LLM не должна превращать отсутствие ответа в согласие. Если неизвестное блокирует must, черновик сохраняет вопрос и владельца решения; необязательную деталь реализации можно оставить исполнителю в явно заданной границе свободы. Эта разница уменьшает лишние уточнения, не заставляя модель выдумывать бизнес-политику гипотеза.
Как проверять полноту и противоречия
| Уровень | Автоматизируемая операция | Что остаётся человеку |
|---|---|---|
| Поля и типы | Schema validation, обязательные поля, enum, date-time при явно включённой проверке | Соответствие профиля реальной работе |
| Граф | Уникальность ID, разрешение ссылок, покрытие must критериями, версии | Достаточность самого набора must |
| Лексика | Поиск «быстро», «удобно», «и т. п.», неопределённых местоимений/кванторов | Решение, какая конкретизация нужна |
| Сценарии | Матрица actor × состояние × вход × успех/отказ; поиск пустых важных клеток | Выбор значимых границ и редких опасных случаев |
| Противоречия | Сопоставление требований к одному объекту/условию/сроку, поиск несовместимых порогов | Разрешение бизнес-компромисса, определение приоритета |
| Примеры | Генерация позитивных, негативных и граничных входов; предложение контрпримеров | Утверждение expected results и предметного эталона |
| Поставка | Запуск проверок в ограниченной среде, сбор логов/снимков | Полезность результата, приемлемость остаточного риска и полномочия приёмки |
Полнота всегда относительна границе и источникам. Наличие всех полей и 100% связей по известным требованиям не доказывает отсутствие неизвестного требования; для сокращения этого риска нужен просмотр реального сценария с исполнителем и принимающим. В индустриальном исследовании неоднозначностей эксперты отмечали, что ссылка на стандарт без нужного уровня/условий проверки часто оставалась недостаточной, хотя LLM считала её ясной гипотеза; эмпирика [S39].
Пример проверки противоречия — иллюстрация. «Ответ за 24 часа» и «обработка только по рабочим дням» совместимы лишь при уточнении календаря и ожидаемого поведения на выходных; LLM должна предъявить конфликт условий и варианты владельцу, а не самостоятельно заменить 24 часа на иной срок гипотеза.
Чему нельзя доверять без отдельной проверки
- Достоверности восстановленного намерения. Модель может правдоподобно сформулировать потребность, которой не было в интервью; нужен источник для requirement гипотеза.
- Самостоятельно выбранным числам. Улучшение измеримости не разрешает менять допуск или придумывать нагрузку; такой риск виден в эксперименте SRS эмпирика [S7].
- Собственному баллу качества LLM. Уверенный verdict не является доказательством отсутствия противоречий или предметных пропусков гипотеза.
- Автогенерированным tests как единственному эталону. Они могут повторить ту же ошибку интерпретации, что и код; важные expected outputs нужны из независимого правила, fixture, измерения или review гипотеза.
- Ссылке без проверки содержимого и версии. Документ мог быть недоступен исполнителю, изменён или содержать инструкцию, которой нельзя предоставлять полномочия гипотеза.
- Имени в поле одобрения.
approved_byне становится человеческим решением от того, что строка валидна по схеме гипотеза. - Текстовой политике как техническому ограничителю. Запрет в AGENTS/authority не заменяет права доступа, sandbox и ограничение инструмента гипотеза.
LLM как исполнитель: пакет, границы контекста, сдача
Стабильные правила среды отделяются от задания. В AGENTS.md/CLAUDE.md помещаются специфичные команды и договорённости проекта; в task packet — результат и baseline, в context manifest — нужные входы с версиями. Подробные справки загружаются по потребности, но обязательное требование не прячется в необязательной ссылке мнение [S54, S55]; гипотеза.
| Слой пакета | Обязательное содержание предлагаемого профиля | Проверка перед стартом |
|---|---|---|
| Результат | Goal, scope/non-scope, deliverables, must, criteria | Можно описать ожидаемый выход без памяти прежнего диалога |
| Среда | Runtime, команды, рабочие каталоги, данные, доступы | Команда и fixture существуют, версия определена |
| Контекст | Минимальный manifest, обязательные материалы, приоритет/статус документа | Ссылки открываются в правах этого исполнителя |
| Полномочия | Допустимые инструменты, внешние эффекты, условия остановки | Технические права не шире нужных; текстовая граница явно задана |
| Проверка | Methods, expected, test commands, ручные проверки | Исполнитель может предъявить наблюдение, а не только обещание |
| Сдача | Изменённые файлы/объекты, версии, evidence manifest, невыполненные критерии | Отчёт не скрывает skipped/blocked/failed и не выдаёт их за pass |
Конфликт версий — основание остановить затронутую часть работы. Агент не должен выбирать удобный ему текст между PRD, контрактом и тестом либо снижать критерий, чтобы получить зелёный запуск; владелец разрешает конфликт и фиксирует новую baseline. При этом требования задачи не отменяют более высокие ограничения среды или инструментов гипотеза.
Сжатие контекста не должно уничтожать обязательства. Для долгой работы предлагается checkpoint: baseline, выполненное, оставшиеся criteria, найденные вопросы, версии evidence и следующий безопасный шаг; после нового старта агент проверяет manifest. Повторное чтение всего архива увеличивает стоимость и может вернуть устаревшие указания гипотеза.
Автоматическая приёмка: граница делегирования
Автоматическая приёмка возможна только как заранее заданное полномочие. Для дешёвого обратимого класса работ владелец может поручить конкретному механизму принимать результат по определённым критериям и версии политики; для нового, спорного или необратимого результата решение остаётся у назначенного человека. Разрешение выполнить работу, успешный тест и право принять результат — разные факты гипотеза.
| Этап проверки | Что подтверждает | Что не подтверждает |
|---|---|---|
| JSON parse | Текст является JSON | Соответствие схеме |
| JSON Schema | Структура и закодированные ограничения | Истинность требований и отсутствие смысловых пробелов |
| Semantic validator | Целостность ID, требуемые связи и согласованность snapshot | Реальные полномочия actor, исторические переходы |
| Поведенческие проверки | Наблюдаемое поведение на проверенных входах/условиях | Всё возможное поведение или ценность продукта |
| Review evidence | Доказательства относятся к нужным версиям и критериям | Достижение будущего бизнес-эффекта |
| Решение приёмки | Уполномоченный субъект принял данный результат на названном основании | Что вся компания уже внедрила стандарт |
Model Spec полезен как пример оформления поведения. Датированная редакция OpenAI 2025-12-18 разделяет обзор, определения, уровни полномочий, правила, комментарии и примеры; сама публикация предупреждает, что production-модели ещё не полностью отражают спецификацию. Это образец разделения нормативного и поясняющего текста, а не свидетельство точного соответствия реализации документу факт [S56].
Машиночитаемая модель: переходы и контроль
Поля и enum из раздела 6 — гипотеза внутреннего формата. Предлагаемые переходы ниже описывают рабочую систему, тогда как приложенный валидатор проверяет только один снимок и не реализует полноценный журнал событий гипотеза.
| Переход | Необходимое основание | Что инвалидируется / сохраняется |
|---|---|---|
| draft → in_review | Владелец сформировал проверяемый черновик | Вопросы видимы, исполнения ещё нет |
| in_review → approved | Человек подтверждает must, scope и приёмку; blockers закрыты | Создаётся baseline, связанная с решением |
| approved → новая revision draft | Изменился смысл, scope или критерий | Прежняя baseline и приёмка сохраняются исторически; новая ещё не принята |
| approved → superseded / retired | Есть замена или прекращение применимости | Исторические evidence и решение остаются доступны |
| not_started → in_progress | Выдана разрешённая baseline и доступны входы | Исполнитель не изменяет критерии сам |
| in_progress → submitted | Есть версия результата и комплект сдачи | Начинается проверка, accepted ещё не установлен |
| submitted → changes_requested / rejected | Возврат/отказ с причиной и criterion IDs | История попытки сохраняется |
| submitted → accepted | Все обязательные критерии подтверждены текущими evidence и есть уполномоченное решение | Принята конкретная версия; новая версия требует нового решения |
Обновление версии делает прежнее evidence непригодным для автоматического зачёта новой версии. Минимальный прототип применяет консервативное точное сравнение revision целиком; production-система может повторно использовать незатронутую проверку только после явного анализа зависимостей, а не переносить pass автоматически гипотеза.
Фактически проверены 20 семантических случаев прототипа. Пять положительных и пятнадцать отрицательных случаев подтвердили ожидаемую работу связей/версий и ограничений приёмки; два структурных случая пропущены, поскольку обнаруживаемое имя jsonschema в среде не предоставляет Draft202012Validator. JSON обоих файлов разбирается, но полное соответствие Draft 2020-12 в этом прогоне не проверено; обычная команда возвращает код 2 и valid:null, не успех.
python -X utf8 validate_spec.py specification.example.json
python -X utf8 validate_spec.py --self-test --output schema-check.json
Для полного запуска требуется рабочая установленная библиотека jsonschema с Draft202012Validator и FormatChecker. Скрипт ничего не устанавливает, а режим self-test при её отсутствии выполняет только контролируемые семантические примеры и сохраняет full_validation_complete:false. Полная схема, обработка реальных evidence и полномочия должны быть проверены до использования для production-приёмки гипотеза.
| Расширение рабочего продукта, ещё не реализовано | Предлагаемые поля | Зачем нужно |
|---|---|---|
| Профили работы и риска | work_type, reversibility, impact, profile_version | Автоматически выбирать обязательные расширения формы |
| Сроки и календарь | due_at, time_zone, review_period, calendar_ref | Машинно проверять сроки сдачи и review |
| Подтверждённое происхождение | source_kind, source_revision, extracted_span, decision_event_id | Отличать исходный факт, предположение и решение человека |
| События полномочий | actor_id, authority_policy_id, authenticated_event, event_time | Не доверять имени, сгенерированному LLM |
| Набор версии | content_hash, input_hashes, artifact_hash, criterion_revision | Обнаруживать изменение содержания без смены строковой revision |
| Evidence store | immutable_ref, checker_identity, environment, executed_at, retention | Проверять действительное происхождение и воспроизводимость |
| Профили внешней передачи | audience_acl, handoff_location, return_procedure, client_inputs | Давать адресату нужное представление и управлять возвратом |
Главная гипотеза продукта — единая модель, разные интерфейсы. Человек подтверждает смысл и видит понятную карточку, LLM получает тот же утверждённый набор обязательств с машиночитаемыми связями, а система проверяет полноту формы и процедуру перехода. Полнота предметного знания, полезность результата и право действия не сводятся к заполненности полей гипотеза.
Происхождение, ключевые фигуры, что читать
Короткая линия происхождения
Сохранились три разные задачи письменной спецификации. SRS систематизирует требования, функциональная спецификация помогает выбрать поведение до реализации, а современные brief/story формы сохраняют место для разговора и изменения; противопоставлять их как «водопад против отсутствия документов» неполезно гипотеза.
| Этап | Что осталось полезным | Что не переносится автоматически |
|---|---|---|
| Функциональные спецификации, Spolsky, 2000 | Текст позволяет выявлять решения и обсуждать поведение до дорогостоящей реализации мнение [S57] | Его вымышленный пример экономии не является экспериментом или основанием обязательной подробности |
| Agile Manifesto, 2001 | Работоспособный результат ценится выше исчерпывающей документации, но ценность правой стороны не отрицается факт [S58] | Манифест не предписывает отсутствие спецификаций |
| Stories/use cases/ADR | Wake, Cohn, Cockburn, Nygard разделяют ценность, сценарий и историю решения факт [S17, S18, S19, S3] | Каждая форма закрывает свой вопрос, ни одна не является универсальным полным заданием |
| 2016–2022 | Требования и docs as code живут внутри итеративной разработки; ISO 29148:2018 остаётся системным референсом, Google описывает жизненный цикл документации факт [S31, S9, S30] | Наличие процесса не означает измеренный эффект на срок/стоимость |
| 2023–2026 | LLM генерируют и анализируют требования; SDD-продукты связывают текст с планом исполнения, исследования начинают проверять стоимость и корректность факт [S32, S33]; эмпирика [S7, S8] | Генерация аккуратного документа не равна замене владельца решения |
Что читать и зачем
- ISO/IEC/IEEE 29148:2018, публичные карточка и определения: различать качество требований, валидацию смысла и проверку результата; полный нормативный текст не прочитан факт [S9, S10].
- Alistair Mavin, EARS: освоить ограниченный синтаксис условий/событий/реакций, затем отдельно изучить ограничения исходного кейса факт [S25, S37].
- Bill Wake, INVEST; Mike Cohn, Acceptance Criteria: не путать историю для разговора, критерии конкретного результата и общую DoD факт [S17, S18].
- Alistair Cockburn, Basic Use Case Template: увидеть структуру ветвей и результатов сценария; прочитан авторский шаблон, не книга Writing Effective Use Cases факт [S19].
- Cucumber, Gherkin Reference; Gojko Adzic, Focus on key examples: отделить правило от примеров и реальную исполняемость от похожего на тест текста факт [S20]; мнение [S21].
- Malte Ubl, Design Docs at Google; HashiCorp, Writing Practices and Culture: понять, какие решения заслуживают design doc/RFC, и не смешивать одинаковую аббревиатуру PRD в разных культурах мнение [S16]; факт [S2].
- Michael Nygard, Documenting Architecture Decisions: сохранять контекст одного решения и его замену факт [S3].
- Amazon, открытый отрывок Working Backwards: увидеть PR-FAQ как итеративную проверку клиентского замысла; доступен только опубликованный отрывок, не вся книга факт [S59].
- Intercom problem-first и шаблон Lenny: сопоставить разные уровни краткости продуктового brief факт [S13, S11].
- Ryan Singer, Write the Pitch: различить проблему, appetite, решение, rabbit holes и no-gos; в этом исследовании прочитан доступный фрагмент главы факт [S14].
- HSE Procedures и audit tool: писать рабочую инструкцию под действительную задачу и условия сотрудника, не рассчитывая на один красивый текст факт [S26, S27].
- FAR 37.6 и Part 46: структурный референс результата, измерения и приёмки внешней работы, без переноса правового режима факт [S4, S28].
- BIID, The Brief: полезный референс извлечения ограничений и ожиданий клиента; перенос из другой отрасли требует адаптации мнение [S46].
- Google SRE Workbook, Implementing SLOs: описывать сервис через измерение, владельца и цикл принятия решений факт [S29].
- ГОСТ 34.602-2020, официальная карточка Росстандарта: референс ТЗ на автоматизированную систему; карточка указывает действующий статус и замену 34.602-89, полного текста и юридической применимости исследование не устанавливает факт [S60].
- Birgitta Böckeler, Understanding SDD; Gloaguen et al., версия v2: сопоставить критическое мнение практика с экспериментом, не подменяя одно другим мнение [S44]; эмпирика [S8].
- Diátaxis и Write the Docs: организовать справку, пояснения и review документации вокруг требований, сохранив различие функций факт [S47, S31].
Открытые репозитории как материал для изучения реализации: GitHub Spec Kit доступен по проверенному репозиторию, дата доступа 2026-09-21; текущий README использован как источник функций, а не готовая политика компании факт [S32]. Для численной spec-as-source регенерации полезен свежий SMART case report, но его результаты не воспроизведены вендор [S43].
Открытые вопросы и границы уверенности
Что осталось неизвестным
| Вопрос | Текущая граница | Что могло бы изменить вывод |
|---|---|---|
| Какой формат объективно лучше? | Нет сопоставимых причинных данных PRD vs PR-FAQ vs pitch для данного контекста | Контролируемые сопоставления похожих работ с измерением итогового качества и полной стоимости |
| Исполняется ли стандарт без уточнений? | Первый локальный coding-handoff потребовал одного исправления; после уточнения проверки прошли | Серия новых передач без доступа исполнителя к интервью с разбором причин уточнений |
| Подходит ли полевая форма сотрудникам? | Создан сценарий, реального обхода и проверки понимания не было | Испытание с сотрудниками нужной квалификации, условиями связи и реальными материалами |
| Работает ли внешняя приёмка? | SOW/клиентские примеры иллюстративны; юридические последствия исключены | Пилот на реальной поставке с фиксацией scope changes, возвратов и времени приёмки |
| Сколько нужно текста и контекста? | Исследования общих agent guidelines дают разные исходы и ограниченный перенос | Сравнение короткого/расширенного пакета на своих типах задач, без изменения критериев между группами |
| Сохраняются ли выгоды через месяцы? | Сильных продольных данных для смешанных исполнителей не найдено | Наблюдение drift, затрат обновления, повторных дефектов и времени восстановления контекста |
| Достаточна ли машиночитаемая модель? | Прототип проверяет форму связей и версий, не предметную истину или полномочия | Полная schema validation, аутентифицированные события, реальные evidence и профильные пилоты |
| Совпадает ли дерево с классификатором доставки? | Соседнее исследование намеренно не читалось | Сопоставление координатором предложенной оси work_type с фактическим классификатором |
Уверенность высокая в функциональном различии артефактов и необходимости отделять свидетельство от решения. Уверенность умеренная в предлагаемой форме внутреннего стандарта и низкая в любом универсальном обещании ускорения или исполнения без уточнений; это авторская оценка применимости прочитанной базы гипотеза.
Доступ и временные ограничения
- ISO 29148: прочитаны официальная аннотация и публичный фрагмент с определениями/оглавлением; нормативное платное тело не читалось. Соответствие предлагаемого профиля стандарту не сертифицируется.
- Закрытые книги: целиком не читались Working Backwards, Writing Effective Use Cases и Specification by Example; использованы открытый отрывок, авторский шаблон и статья соответственно.
- Shape Up: прямое открытие главы и PDF не удалось, использованы содержательные индексированные фрагменты оригинала; доступ честно отмечен как фрагмент.
- Google PRD: единый действующий официальный универсальный шаблон не установлен. Design Docs at Google — авторское описание практики Malte Ubl, не официальный стандарт всех команд Google.
- Lenny: личный Google Doc не раскрыл содержимое; анатомия опирается на открытый шаблон с авторской атрибуцией на Atlassian.
- ГОСТ: официальная карточка, не полный текст. Требования применимого права, договоров и подписи не исследованы.
- Большие документы: Model Spec, Claude Code best practices, Structured Outputs и критический разбор SDD прочитаны тематическими частями; в реестре указан фрагмент.
- Динамические страницы: docs/pricing и main Spec Kit отражают чтение 2026-09-21; снимки всех страниц и commit SHA не закреплены. Датированные arXiv-версии и Model Spec выбраны явно.
- Технические ошибки доступа: старые домены/пути, IEEE/ScienceDirect, отдельные PDF и Google Docs иногда не извлекались; там, где использован другой доступный первичный адрес, он приведён в реестре. Недоступный полный текст не заменён пересказом без отметки.
- Продукты: Kiro, Notion, Linear, Jira/Confluence, Codex и Claude Code не сравнивались в контролируемом практическом испытании. Исследована публичная документация, кроме собственного ограниченного coding-пилота.
- Границы локального чтения: материалы соседних исследований и ответы другого участника не использовались. Служебный OpenAI Docs SKILL прочитан по обязательному правилу среды; он не является источником содержательных выводов.
- Дополнительные проверки: HTML/JavaScript проверены структурно и в Node с имитацией DOM; браузерного и визуального QA не было. Полная JSON Schema validation не выполнена из-за отсутствующей реализации зависимости.
Предлагаемый приёмочный эксперимент для стандарта
Пилот должен измерять результат передачи, а не оценку текста моделью. Иллюстративный дизайн: по пять новых задач для агента, сотрудника, подрядчика и клиента, всего двадцать; это удобный старт для выявления дефектов, не статистически обоснованный размер выборки гипотеза.
- До выдачи владелец фиксирует результат, baseline и критерии; отдельный проверяющий формирует ожидаемые наблюдения гипотеза.
- При передаче исполнитель получает только разрешённый пакет; все вопросы классифицируются по причине, а не запрещаются гипотеза.
- После выполнения измеряются доля правильных результатов с первой сдачи, вынужденные предположения, время автора/исполнителя/принимающего и дефекты, пропущенные тестами гипотеза.
- При сравнении сохраняются сопоставимые сложность, риск и качество входов; отличие от прежней практики анализируется по типам работы, без усреднения сотрудников и кодирующих агентов гипотеза.
- Решение о внедрении принимается по снижению суммарных разночтений/переделок при приемлемых затратах, а не по росту числа заполненных полей гипотеза.
Статус отчёта complete означает завершение исследования в заданных границах. Он не означает подтверждённую эффективность предлагаемого стандарта, полную нормативную сертификацию, согласование пользователем или внедрение приложенного прототипа.
Реестр источников
| ID | Название | Автор или издатель | URL | Публикация | Доступ (дата) | Вид доступа | Что подтверждает |
|---|---|---|---|---|---|---|---|
| S1 | CEO Andy Jassy’s 2024 Letter to Shareholders | Andy Jassy / Amazon | aboutamazon.com/news/company-news/amazon-ceo-andy-jassy-2… | 2025-04-10 | 2026-09-21 | полный текст | Разделы 0, 1, 2, 4: Amazon PR/FAQ, narrative memo и письменные решения |
| S2 | Writing Practices and Culture | HashiCorp | hashicorp.com/en/how-hashicorp-works/articles/writing-pra… | без даты | 2026-09-21 | полный текст | Разделы 0, 1, 2, 4, 11: практика HashiCorp: PRD, RFC, обсуждение решения |
| S3 | Documenting Architecture Decisions | Michael Nygard / Cognitect | cognitect.com/blog/2011/11/15/documenting-architecture-de… | 2011-11-15 | 2026-09-21 | полный текст | Разделы 0, 1, 2, 4, 7, 11: анатомия ADR и сохранение superseded решений |
| S4 | FAR Subpart 37.6 — Performance-Based Acquisition | Acquisition.gov / FAR | acquisition.gov/far/subpart-37.6 | без даты | 2026-09-21 | полный текст | Разделы 0, 1, 2, 4, 11: результаты, измеримые стандарты и scope внешней работы |
| S5 | JSON Schema Validation: A Vocabulary for Structural Validation of JSON, Draft 2020-12 | A. Wright, H. Andrews, B. Hutton / JSON Schema | json-schema.org/draft/2020-12/json-schema-validation | 2022-06-16 | 2026-09-21 | полный текст | Разделы 0, 1, 4, 7, 9: Draft 2020-12, assertions, annotations, limits |
| S6 | The 2020 Scrum Guide | Ken Schwaber, Jeff Sutherland | scrumguides.org/scrum-guide.html | 2020-11 | 2026-09-21 | полный текст | Разделы 0, 1, 7: DoD и границы Sprint Review |
| S7 | Using LLMs in Software Requirements Specifications: An Empirical Evaluation | Madhava Krishna et al. | arxiv.org/html/2404.17842v1 | 2024-04-27 | 2026-09-21 | полный текст | Разделы 0, 1, 2, 8, 10, 11: генерация SRS, дизайн опыта, ошибки ремонта требований |
| S8 | Evaluating AGENTS.md: Are Repository-Level Context Files Helpful for Coding Agents? (v2) | Thibaud Gloaguen et al. / ETH Zurich, LogicStar.ai | arxiv.org/html/2602.11988v2 | 2026-06-23 | 2026-09-21 | полный текст | Разделы 0, 2, 8, 11: v2, 300+138 задач, correctness и стоимость |
| S9 | IEEE/ISO/IEC 29148-2018 | IEEE Standards Association | standards.ieee.org/ieee/29148/6937/ | 2018-11-30 | 2026-09-21 | аннотация | Разделы 1, 11: scope стандарта и процессы требований; только аннотация |
| S10 | ISO/IEC/IEEE 29148:2018(en): Systems and software engineering — Life cycle processes — Requirements engineering | ISO / IEC / IEEE | iso.org/obp/ui?_escaped_fragment_=iso:std:iso-iec-ieee:29… | 2018 | 2026-09-21 | фрагмент | Разделы 1, 11: публичные определения verification и validation |
| S11 | Lenny's Product Requirements template | Lenny Rachitsky / Atlassian | atlassian.com/software/confluence/templates/requirements | без даты | 2026-09-21 | полный текст | Разделы 1, 2, 4, 11: открытый PRD-шаблон с атрибуцией Lenny |
| S12 | Lessons learned from scaling a product team | Paul Adams / Intercom | intercom.com/blog/how-we-build-software/ | 2015-01-28 | 2026-09-21 | полный текст | Разделы 1: историческая анатомия Intermission, не процесс 2026 |
| S13 | Intercom’s product principles: Start with the problem to achieve better solutions | Stephen Forbes / Intercom | intercom.com/blog/intercom-product-principles-start-with-… | 2022-10-05 | 2026-09-21 | полный текст | Разделы 1, 2, 11: Intercom: совместное понимание проблемы |
| S14 | Write the Pitch — Shape Up, Chapter 6 | Ryan Singer / Basecamp | basecamp.com/shapeup/1.5-chapter-06 | без даты | 2026-09-21 | фрагмент | Разделы 1, 2, 4, 11: пять элементов pitch Shape Up; индексированный фрагмент |
| S15 | Product requirements document (PRD) template | Atlassian | atlassian.com/software/confluence/templates/product-requi… | без даты | 2026-09-21 | полный текст | Разделы 1, 9: анатомия PRD и связь Confluence с Jira |
| S16 | Design Docs at Google | Malte Ubl | industrialempathy.com/posts/design-docs-at-google/ | 2020-07-06 | 2026-09-21 | полный текст | Разделы 1, 4, 11: описание design docs практиком Google |
| S17 | INVEST in Good Stories, and SMART Tasks | Bill Wake | xp123.com/invest-in-good-stories-and-smart-tasks/ | 2003-08-17 | 2026-09-21 | полный текст | Разделы 1, 2, 4, 11: авторство и смысл INVEST |
| S18 | Acceptance Criteria | Mountain Goat Software / Mike Cohn | mountaingoatsoftware.com/agile/user-stories/acceptance-cr… | без даты | 2026-09-21 | полный текст | Обновление 2026-08-07. Разделы 1, 4, 7, 11: критерии истории, DoD и тесты; дата обновления |
| S19 | Basic Use Case Template, HaT TR.96.03a, version 2 | Alistair Cockburn; зеркало University of Otago | cs.otago.ac.nz/coursework/cosc461/uctempla.htm | 1998-10-26 | 2026-09-21 | полный текст | Разделы 1, 4, 11: авторский шаблон use case, потоки и результаты |
| S20 | Gherkin Reference | Cucumber | cucumber.io/docs/gherkin/reference/ | без даты | 2026-09-21 | полный текст | Разделы 1, 4, 7, 9, 11: Gherkin и связь сценариев со step definitions |
| S21 | Focus on key examples | Gojko Adzic | gojko.net/2014/05/05/focus-on-key-examples/ | 2014-05-05 | 2026-09-21 | полный текст | Разделы 1, 2, 11: правила и ключевые примеры; критика чрезмерных примеров |
| S22 | OpenAPI Specification v3.2.1 | OpenAPI Initiative / Linux Foundation | spec.openapis.org/oas/v3.2.1.html | 2026-09-10 | 2026-09-21 | полный текст | Разделы 1, 2, 4, 7, 9: OpenAPI 3.2.1, HTTP API, дата версии |
| S23 | AsyncAPI Specification 3.1.0 | AsyncAPI Initiative | asyncapi.com/docs/reference/specification/v3.1.0 | 2026-01-31 | 2026-09-21 | полный текст | Разделы 1, 4, 7, 9: контракт событий и семантика AsyncAPI |
| S24 | AsyncAPI Spec 3.1.0 Release Notes | Lukasz Gornicki / AsyncAPI Initiative | asyncapi.com/blog/release-notes-3.1.0 | 2026-01-31 | 2026-09-21 | полный текст | Разделы 1, 2: дата и содержание релиза AsyncAPI 3.1.0 |
| S25 | EARS — Easy Approach to Requirements Syntax | Alistair Mavin | alistairmavin.com/ears/ | без даты | 2026-09-21 | полный текст | Разделы 1, 11: паттерны и синтаксис EARS |
| S26 | Procedures | Health and Safety Executive (HSE) | hse.gov.uk/humanfactors/topics/procedures.htm | без даты | 2026-09-21 | полный текст | Разделы 1, 2, 4, 5, 7, 8, 11: инструкция под задачу, человека и последствия ошибки |
| S27 | Procedures Audit Tool (Style / Layout / Language), version 1.1 | Health and Safety Executive (HSE) | hse.gov.uk/humanfactors/assets/docs/procedures-audit-tool… | 2009-12 | 2026-09-21 | полный текст | Разделы 1, 4, 5, 8, 11: структура, язык и явная проверка рабочих инструкций |
| S28 | FAR Part 46 — Quality Assurance | Acquisition.gov / FAR | acquisition.gov/far/part-46 | без даты | 2026-09-21 | полный текст | Разделы 1, 4, 11: различие контроля качества и оформления acceptance |
| S29 | Implementing SLOs — The Site Reliability Workbook | Steven Thurgood, David Ferguson, Alex Hidalgo, Betsy Beyer / Google | sre.google/workbook/implementing-slos/ | 2018 | 2026-09-21 | полный текст | Разделы 1, 2, 7, 11: SLI, SLO, владельцы, измерение и цикл review |
| S30 | Documentation Best Practices | Google Style Guides | google.github.io/styleguide/docguide/best_practices.html | без даты | 2026-09-21 | полный текст | Разделы 2, 5, 8, 11: сопровождение текущей документации, архив design docs |
| S31 | Docs as Code | Eric Holscher; Write the Docs | writethedocs.org/guide/docs-as-code/ | без даты | 2026-09-21 | полный текст | Разделы 2, 5, 7, 9, 11: версии, review и проверки документации |
| S32 | GitHub Spec Kit — README | GitHub | github.com/github/spec-kit | без даты | 2026-09-21 | полный текст | Разделы 2, 9, 10, 11: текущая структура открытого Spec Kit; main без SHA |
| S33 | Specs | AWS / Kiro | kiro.dev/docs/specs/ | без даты | 2026-09-21 | полный текст | Обновление 2026-08-27. Разделы 2, 9, 10, 11: модель specs, режимы, различия IDE/CLI/Web; обновление |
| S34 | AGENTS.md | AGENTS.md / Agentic AI Foundation | agents.md/ | без даты | 2026-09-21 | полный текст | Разделы 2, 9, 10: AGENTS.md, назначение и совместимые инструменты |
| S35 | Naming the Pain in Requirements Engineering: Contemporary Problems, Causes, and Effects in Practice | D. Méndez Fernández et al. | arxiv.org/pdf/1611.10288 | 2016-11-27 | 2026-09-21 | полный текст | Разделы 2: NaPiRE: 228 организаций, проблемы требований |
| S36 | A Systematic Literature Review of Empirical Research on Quality Requirements | Thomas Olsson; Séverine Sentilles; Efi Papatheocharous | arxiv.org/html/2201.08627v1 | 2022-01-21 | 2026-09-21 | полный текст | Разделы 2: обзор 84 работ, ограничения эмпирики quality requirements |
| S37 | Easy Approach to Requirements Syntax (EARS) | Alistair Mavin, Philip Wilkinson, Adrian Harwood, Mark Novak | researchgate.net/publication/224079416_Easy_approach_to_r… | 2009 | 2026-09-21 | полный текст | Разделы 2, 11: исходный EARS case study и его ограничения |
| S38 | On the Benefits And Problems Related to Using Definition of Done — A Survey Study | Sylwia Kopczyńska, Mirosław Ochodek, Jakub Piechowiak, Jerzy Nawrocki | arxiv.org/pdf/2208.04003 | 2022-08-08 | 2026-09-21 | полный текст | Разделы 2, 5: опрос DoD, 137 ответов, ограничения самоотчёта |
| S39 | Requirements Ambiguity Detection and Explanation with LLMs: An Industrial Study | Sarmad Bashir et al. | es.mdu.se/pdf_publications/7221.pdf | 2025 | 2026-09-21 | полный текст | Разделы 2, 10: 663 требования, поиск неоднозначностей, оценки экспертов |
| S40 | On the Impact of AGENTS.md Files on the Efficiency of AI Coding Agents (v2) | Jai Lal Lulla et al. | arxiv.org/html/2601.20404v2 | 2026-03-30 | 2026-09-21 | полный текст | Разделы 2, 8: 124 PR, время и токены; без gold correctness |
| S41 | Do Context Files Help Coding Agents? A Two-Agent Ablation Study on Real Repositories | Prakhar Khatri | arxiv.org/html/2607.27250v1 | 2026-07-28 | 2026-09-21 | полный текст | Разделы 2: 17 задач, 288 оценённых прогонов; малая мощность |
| S42 | Feature Specs | AWS / Kiro | kiro.dev/docs/specs/feature-specs/ | без даты | 2026-09-21 | полный текст | Обновление 2026-08-04. Разделы 2, 10: requirements/design, EARS, анализ; дата обновления |
| S43 | Design Docs Are All You Need: An AI-native Machine-Learning Performance Tool | Samuel Kushnir et al. | arxiv.org/html/2609.05364v1 | 2026-09-04 | 2026-09-21 | полный текст | Разделы 2, 11: узкий case report spec-as-source, авторские числа затрат |
| S44 | Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl | Birgitta Böckeler / Thoughtworks; MartinFowler.com | martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html | 2025-10-15 | 2026-09-21 | фрагмент | Разделы 2, 10, 11: типология и критика SDD по опыту 2025 |
| S45 | Structured model outputs | OpenAI | developers.openai.com/api/docs/guides/structured-outputs | без даты | 2026-09-21 | фрагмент | Разделы 2, 10: форма JSON Schema не удостоверяет содержание |
| S46 | Professional Practice Series: The Brief | British Institute of Interior Design (BIID) | biid.org.uk/resources/professional-practice-series-brief | 2020-12-15 | 2026-09-21 | полный текст | Разделы 4, 11: клиентский brief, ожидания, ограничения и ответственность |
| S47 | Diátaxis | Daniele Procida | diataxis.fr/ | без даты | 2026-09-21 | полный текст | Разделы 7, 11: четыре потребности и формы документации |
| S48 | Notion Pricing Plans | Notion | notion.com/pricing | без даты | 2026-09-21 | полный текст | Разделы 9: сущности, возможности, ограничения Free и история |
| S49 | Documents | Linear | linear.app/docs/documents | без даты | 2026-09-21 | полный текст | Разделы 9: документы, шаблоны, история и связи с работой |
| S50 | Pricing | Linear | linear.app/pricing | без даты | 2026-09-21 | полный текст | Разделы 9: цены и ограничения тарифов |
| S51 | What are the different Jira plans? | Atlassian | atlassian.com/software/jira/guides/more/jira-editions | без даты | 2026-09-21 | полный текст | Разделы 9: сущности Jira, тарифы и ограничения Free |
| S52 | Pricing | AWS / Kiro | kiro.dev/pricing/ | без даты | 2026-09-21 | полный текст | Разделы 9: цены Free/Pro и кредитная модель расхода |
| S53 | Custom instructions with AGENTS.md | OpenAI | learn.chatgpt.com/docs/agent-configuration/agents-md | без даты | 2026-09-21 | полный текст | Разделы 9, 10: загрузка и границы AGENTS.md в Codex |
| S54 | Best practices for Claude Code | Anthropic | code.claude.com/docs/en/best-practices | без даты | 2026-09-21 | фрагмент | Разделы 9, 10: тематические рекомендации по интервью, контексту, проверке |
| S55 | Effective context engineering for AI agents | Anthropic | anthropic.com/engineering/effective-context-engineering-f… | 2025-09-29 | 2026-09-21 | полный текст | Разделы 10: релевантный контекст, compaction и заметки |
| S56 | OpenAI Model Spec (2025-12-18) | OpenAI | model-spec.openai.com/2025-12-18.html | 2025-12-18 | 2026-09-21 | фрагмент | Разделы 10: структура датированной спецификации поведения |
| S57 | Painless Functional Specifications – Part 1: Why Bother? | Joel Spolsky | joelonsoftware.com/2000/10/02/painless-functional-specifi… | 2000-10-02 | 2026-09-21 | полный текст | Разделы 11: позиция практика о проектировании в тексте |
| S58 | Manifesto for Agile Software Development | Авторы Agile Manifesto | agilemanifesto.org/ | 2001 | 2026-09-21 | полный текст | Разделы 11: ценности документации и работающего результата |
| S59 | An insider look at Amazon's culture and processes — Working Backwards excerpt | Colin Bryar, Bill Carr / Amazon | aboutamazon.com/news/workplace/an-insider-look-at-amazons… | 2021 | 2026-09-21 | полный текст | Разделы 11: публичный отрывок Working Backwards; не полная книга |
| S60 | ГОСТ 34.602-2020 — официальная карточка стандарта | Росстандарт | protect.gost.ru/gost/details/5876f733-ee91-431a-8cb6-9e02… | 2021 | 2026-09-21 | аннотация | Разделы 11: официальная карточка ГОСТ 34.602-2020; не полный текст |
Словарь терминов
- Specification спецификация
- описание ожидаемого результата и ограничений, позволяющее различать допустимое и недопустимое исполнение.
- PRD — Product Requirements Document документ продуктовых требований
- объясняет проблему, аудиторию, ожидаемый результат и объём продукта; у HashiCorp та же аббревиатура означает Problem Requirements Document.
- One-pager краткий одностраничный документ
- форма сжатого описания проблемы и решения; не универсальный норматив размера.
- PR-FAQ пресс-релиз и ответы на вопросы
- описание будущего клиентского опыта и существенных вопросов до инвестирования в реализацию.
- Six-pager / narrative memo письменная аналитическая записка
- форма развёрнутого рассуждения для обсуждения решения, не синоним PR-FAQ.
- Pitch предложение работы по Shape Up
- проблема, appetite, решение, рисковые места и исключения для выбора ставки.
- Appetite допустимый объём вложений
- сколько времени/усилий готовы потратить, а не оценка всей мыслимой функциональности.
- Rabbit hole / no-go ловушка / исключённое направление
- известный риск разрастания решения либо часть, которую сознательно не делают.
- Design doc документ проектного решения
- описание существенного технического выбора, альтернатив и компромиссов.
- RFC — Request for Comments предложение для обсуждения
- артефакт согласования решения с заинтересованными сторонами.
- ADR — Architecture Decision Record запись архитектурного решения
- сохраняет контекст, выбор, статус и последствия одного решения.
- SRS — Software Requirements Specification спецификация требований к ПО
- организованный набор требований к программной системе.
- Requirements engineering инженерия требований
- извлечение, анализ, формулирование, проверка и сопровождение требований.
- EARS — Easy Approach to Requirements Syntax упрощённый синтаксис требований
- паттерны условий, событий и реакций, ограничивающие форму естественного языка.
- User story пользовательская история
- краткая формулировка ценности, поддерживаемая разговором и критериями.
- INVEST признаки качественной истории
- независимая, допускающая обсуждение, ценная, оцениваемая, небольшая и проверяемая.
- Use case сценарий использования
- цель актора, предпосылки, основной и альтернативные потоки и результат.
- BDD — Behavior-Driven Development разработка через обсуждение поведения
- уточнение ожидаемого поведения на понятных примерах.
- Gherkin язык сценариев поведения
- текстовая форма Given/When/Then, исполняемая только при наличии соответствующего кода шагов.
- Step definition реализация шага
- код, связывающий текстовый шаг сценария с действием или проверкой.
- Specification by example спецификация через примеры
- уточнение правила репрезентативными входами и ожидаемыми результатами.
- Acceptance criterion критерий приёмки
- наблюдаемое условие, по которому проверяется конкретное обязательство.
- Definition of Done, DoD определение готовности
- общие меры качества, которым должен соответствовать результат в заданном процессе.
- Acceptance приёмка
- решение уполномоченного субъекта о конкретной версии поставки на основании критериев и evidence.
- Verification / validation проверка соответствия / подтверждение пригодности
- различение выполнения заданных требований и удовлетворения предполагаемой потребности; термины также применяются к самим требованиям.
- Deliverable / outcome поставляемый объект / полученный эффект
- артефакт или услуга, которые сдаются, и изменение для бизнеса/пользователя, которое может проявиться позже.
- Scope / non-goals граница работы / исключённые цели
- что входит в обязательство и что сознательно не входит.
- Baseline зафиксированная исходная версия
- версия обязательств, по которой выполняется и принимается работа.
- Revision / version редакция / версия
- идентификатор состояния содержания или формата; эти два изменения в модели разделены.
- Traceability трассируемость
- явные связи потребности, требования, задачи, проверки, evidence и решения.
- Evidence проверяемое свидетельство
- лог, измерение, фото, отчёт или другое наблюдение, связанное с версией и критерием.
- Oracle / gold tests эталон результата / эталонные тесты
- внешнее основание ожидаемого поведения, с которым сравнивается выполнение.
- Fixture фиксированный проверочный вход
- подготовленные данные и условия для воспроизводимой проверки.
- Assumption / provenance предположение / происхождение сведений
- неподтверждённое допущение и ссылка на источник/решение, из которого выведено требование.
- Must / should обязательное / желательное
- в предлагаемом профиле must блокирует приёмку при невыполнении, should — явно необязательное пожелание.
- NFR — Non-Functional Requirement требование качества или ограничения
- характеристики вроде времени ответа, надёжности и доступа, дополняющие основную функцию.
- Task brief / task packet карточка задания / пакет исполнения
- результат, входы, требования, полномочия, проверки и процедура сдачи конкретной работы.
- Work instruction рабочая инструкция
- описание способа известной операции для определённого исполнителя и условий.
- SOW — Statement of Work описание внешней работы
- объём, поставляемые результаты, обязанности сторон и порядок сдачи.
- SLI / SLO / SLA показатель / цель / соглашение об уровне сервиса
- измерение качества, желаемый уровень и оформленное обязательство с последствиями.
- Eligible event учитываемое событие
- событие, входящее в знаменатель метрики по установленным правилам.
- Discovery / intake исследование потребности / приём запроса
- уточнение неизвестного результата и сохранение исходной постановки.
- Contract-first сначала контракт
- согласование интерфейса и его правил перед независимой реализацией сторон.
- OpenAPI / JSON Schema / AsyncAPI контракты HTTP API / JSON / событий
- машиночитаемые формы интерфейса, структуры данных и обмена сообщениями.
- API / UI программный интерфейс / пользовательский интерфейс
- граница обмена между системами и средство взаимодействия человека с продуктом.
- LLM — Large Language Model большая языковая модель
- модель, генерирующая и анализирующая текст, в том числе задания и код.
- SDD — Spec-Driven Development разработка, направляемая спецификацией
- семейство процессов, связывающих спецификацию с реализацией.
- Spec-first / spec-anchored / spec-as-source спецификация сначала / сопровождаемая опора / исходник реализации
- три разных уровня роли документа в SDD.
- AGENTS.md / CLAUDE.md файлы инструкций агенту
- устойчивые соглашения и контекст среды, отличные от спецификации конкретного результата.
- Harness среда исполнения агента
- механизм, который загружает инструкции, предоставляет инструменты и управляет выполнением.
- Context manifest / checkpoint перечень контекста / контрольная запись состояния
- версии нужных входов и сохранённый срез текущей работы.
- Compaction сжатие контекста
- сокращение истории агентской сессии с сохранением нужных сведений.
- Structured Outputs структурированный вывод модели
- ограничение формы ответа поддерживаемой схемой, без гарантии истинности содержимого.
- Assertion / annotation проверяемое ограничение / аннотация
- правило валидации данных и описательные метаданные схемы.
- Lint / semantic validation проверка формальных признаков / проверка смысловых связей модели
- обнаружение типовых дефектов текста и инвариантов между записями, без полного понимания предметной области.
- CI — Continuous Integration непрерывная интеграция
- автоматический запуск проверок при изменениях.
- Docs as code / Diátaxis документация по процессу кода / модель потребностей документации
- способ версионирования и review; отдельно — разделение обучения, инструкции, справки и объяснения.
- Markdown / YAML / JSON текстовая разметка / форматы данных
- человекочитаемые способы записи документа и структурированных полей.
- Staging / production проверочная / рабочая среда
- среда приёмочных испытаний и среда реальных пользователей.
- Rollout / rollback / deployment ввод изменения / откат / развёртывание
- применение версии результата, восстановление прежней и её размещение в среде исполнения.
- Drift / diff расхождение / разница версий
- утрата соответствия спецификации поведению и явный набор изменений.
- Sandbox / ACL ограниченная среда / список прав доступа
- технические средства ограничения действий и доступа, не заменяемые инструкцией в тексте.
- Review / handoff / feedback проверка и обсуждение / передача работы / обратная связь
- действия уточнения, выдачи и оценки результата.
- Waiver явное разрешение отклонения
- отдельное решение владельца риска принять невыполненное условие; в минимальном прототипе не реализовано.
- BOM / Unicode code point / UTC / GPS маркер кодировки / кодовая точка / всемирное время / спутниковые координаты
- точные технические понятия входного CSV, длины текста, времени и привязки наблюдения в примерах.
- SHA-256 / hash контрольная сумма
- идентификатор содержимого файла для обнаружения изменения; сам по себе не удостоверяет автора.
- ROI / TCO окупаемость / полная стоимость владения
- эффект относительно вложений и суммарные затраты; в отчёте не рассчитаны.