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 проверок прошли.

Первичная передача не выдержала критерий «без уточнений». Это не скрывается успешным повтором: данный прогон подтверждает пользу обнаруживаемого блокера и версионного исправления, но не доказывает универсальную исполнимость предложенного стандарта. «Без вынужденного угадывания» предлагается как более безопасная цель, а долю передач без уточнений — измерять отдельно гипотеза.

Сквозной пример 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; машинный потребитель должен использовать полный файл гипотеза.

Прототип не равен готовой подсистеме управления требованиями. В нём нет аутентификации, каталога пользователей, электронных подписей, исполнения команд из 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 не выполнена из-за отсутствующей реализации зависимости.

Предлагаемый приёмочный эксперимент для стандарта

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

  1. До выдачи владелец фиксирует результат, baseline и критерии; отдельный проверяющий формирует ожидаемые наблюдения гипотеза.
  2. При передаче исполнитель получает только разрешённый пакет; все вопросы классифицируются по причине, а не запрещаются гипотеза.
  3. После выполнения измеряются доля правильных результатов с первой сдачи, вынужденные предположения, время автора/исполнителя/принимающего и дефекты, пропущенные тестами гипотеза.
  4. При сравнении сохраняются сопоставимые сложность, риск и качество входов; отличие от прежней практики анализируется по типам работы, без усреднения сотрудников и кодирующих агентов гипотеза.
  5. Решение о внедрении принимается по снижению суммарных разночтений/переделок при приемлемых затратах, а не по росту числа заполненных полей гипотеза.

Статус отчёта complete означает завершение исследования в заданных границах. Он не означает подтверждённую эффективность предлагаемого стандарта, полную нормативную сертификацию, согласование пользователем или внедрение приложенного прототипа.

Реестр источников

IDНазваниеАвтор или издательURLПубликацияДоступ (дата)Вид доступаЧто подтверждает
S1CEO Andy Jassy’s 2024 Letter to ShareholdersAndy Jassy / Amazonaboutamazon.com/news/company-news/amazon-ceo-andy-jassy-2…2025-04-102026-09-21полный текстРазделы 0, 1, 2, 4: Amazon PR/FAQ, narrative memo и письменные решения
S2Writing Practices and CultureHashiCorphashicorp.com/en/how-hashicorp-works/articles/writing-pra…без даты2026-09-21полный текстРазделы 0, 1, 2, 4, 11: практика HashiCorp: PRD, RFC, обсуждение решения
S3Documenting Architecture DecisionsMichael Nygard / Cognitectcognitect.com/blog/2011/11/15/documenting-architecture-de…2011-11-152026-09-21полный текстРазделы 0, 1, 2, 4, 7, 11: анатомия ADR и сохранение superseded решений
S4FAR Subpart 37.6 — Performance-Based AcquisitionAcquisition.gov / FARacquisition.gov/far/subpart-37.6без даты2026-09-21полный текстРазделы 0, 1, 2, 4, 11: результаты, измеримые стандарты и scope внешней работы
S5JSON Schema Validation: A Vocabulary for Structural Validation of JSON, Draft 2020-12A. Wright, H. Andrews, B. Hutton / JSON Schemajson-schema.org/draft/2020-12/json-schema-validation2022-06-162026-09-21полный текстРазделы 0, 1, 4, 7, 9: Draft 2020-12, assertions, annotations, limits
S6The 2020 Scrum GuideKen Schwaber, Jeff Sutherlandscrumguides.org/scrum-guide.html2020-112026-09-21полный текстРазделы 0, 1, 7: DoD и границы Sprint Review
S7Using LLMs in Software Requirements Specifications: An Empirical EvaluationMadhava Krishna et al.arxiv.org/html/2404.17842v12024-04-272026-09-21полный текстРазделы 0, 1, 2, 8, 10, 11: генерация SRS, дизайн опыта, ошибки ремонта требований
S8Evaluating AGENTS.md: Are Repository-Level Context Files Helpful for Coding Agents? (v2)Thibaud Gloaguen et al. / ETH Zurich, LogicStar.aiarxiv.org/html/2602.11988v22026-06-232026-09-21полный текстРазделы 0, 2, 8, 11: v2, 300+138 задач, correctness и стоимость
S9IEEE/ISO/IEC 29148-2018IEEE Standards Associationstandards.ieee.org/ieee/29148/6937/2018-11-302026-09-21аннотацияРазделы 1, 11: scope стандарта и процессы требований; только аннотация
S10ISO/IEC/IEEE 29148:2018(en): Systems and software engineering — Life cycle processes — Requirements engineeringISO / IEC / IEEEiso.org/obp/ui?_escaped_fragment_=iso:std:iso-iec-ieee:29…20182026-09-21фрагментРазделы 1, 11: публичные определения verification и validation
S11Lenny's Product Requirements templateLenny Rachitsky / Atlassianatlassian.com/software/confluence/templates/requirementsбез даты2026-09-21полный текстРазделы 1, 2, 4, 11: открытый PRD-шаблон с атрибуцией Lenny
S12Lessons learned from scaling a product teamPaul Adams / Intercomintercom.com/blog/how-we-build-software/2015-01-282026-09-21полный текстРазделы 1: историческая анатомия Intermission, не процесс 2026
S13Intercom’s product principles: Start with the problem to achieve better solutionsStephen Forbes / Intercomintercom.com/blog/intercom-product-principles-start-with-…2022-10-052026-09-21полный текстРазделы 1, 2, 11: Intercom: совместное понимание проблемы
S14Write the Pitch — Shape Up, Chapter 6Ryan Singer / Basecampbasecamp.com/shapeup/1.5-chapter-06без даты2026-09-21фрагментРазделы 1, 2, 4, 11: пять элементов pitch Shape Up; индексированный фрагмент
S15Product requirements document (PRD) templateAtlassianatlassian.com/software/confluence/templates/product-requi…без даты2026-09-21полный текстРазделы 1, 9: анатомия PRD и связь Confluence с Jira
S16Design Docs at GoogleMalte Ublindustrialempathy.com/posts/design-docs-at-google/2020-07-062026-09-21полный текстРазделы 1, 4, 11: описание design docs практиком Google
S17INVEST in Good Stories, and SMART TasksBill Wakexp123.com/invest-in-good-stories-and-smart-tasks/2003-08-172026-09-21полный текстРазделы 1, 2, 4, 11: авторство и смысл INVEST
S18Acceptance CriteriaMountain Goat Software / Mike Cohnmountaingoatsoftware.com/agile/user-stories/acceptance-cr…без даты2026-09-21полный текстОбновление 2026-08-07. Разделы 1, 4, 7, 11: критерии истории, DoD и тесты; дата обновления
S19Basic Use Case Template, HaT TR.96.03a, version 2Alistair Cockburn; зеркало University of Otagocs.otago.ac.nz/coursework/cosc461/uctempla.htm1998-10-262026-09-21полный текстРазделы 1, 4, 11: авторский шаблон use case, потоки и результаты
S20Gherkin ReferenceCucumbercucumber.io/docs/gherkin/reference/без даты2026-09-21полный текстРазделы 1, 4, 7, 9, 11: Gherkin и связь сценариев со step definitions
S21Focus on key examplesGojko Adzicgojko.net/2014/05/05/focus-on-key-examples/2014-05-052026-09-21полный текстРазделы 1, 2, 11: правила и ключевые примеры; критика чрезмерных примеров
S22OpenAPI Specification v3.2.1OpenAPI Initiative / Linux Foundationspec.openapis.org/oas/v3.2.1.html2026-09-102026-09-21полный текстРазделы 1, 2, 4, 7, 9: OpenAPI 3.2.1, HTTP API, дата версии
S23AsyncAPI Specification 3.1.0AsyncAPI Initiativeasyncapi.com/docs/reference/specification/v3.1.02026-01-312026-09-21полный текстРазделы 1, 4, 7, 9: контракт событий и семантика AsyncAPI
S24AsyncAPI Spec 3.1.0 Release NotesLukasz Gornicki / AsyncAPI Initiativeasyncapi.com/blog/release-notes-3.1.02026-01-312026-09-21полный текстРазделы 1, 2: дата и содержание релиза AsyncAPI 3.1.0
S25EARS — Easy Approach to Requirements SyntaxAlistair Mavinalistairmavin.com/ears/без даты2026-09-21полный текстРазделы 1, 11: паттерны и синтаксис EARS
S26ProceduresHealth and Safety Executive (HSE)hse.gov.uk/humanfactors/topics/procedures.htmбез даты2026-09-21полный текстРазделы 1, 2, 4, 5, 7, 8, 11: инструкция под задачу, человека и последствия ошибки
S27Procedures Audit Tool (Style / Layout / Language), version 1.1Health and Safety Executive (HSE)hse.gov.uk/humanfactors/assets/docs/procedures-audit-tool…2009-122026-09-21полный текстРазделы 1, 4, 5, 8, 11: структура, язык и явная проверка рабочих инструкций
S28FAR Part 46 — Quality AssuranceAcquisition.gov / FARacquisition.gov/far/part-46без даты2026-09-21полный текстРазделы 1, 4, 11: различие контроля качества и оформления acceptance
S29Implementing SLOs — The Site Reliability WorkbookSteven Thurgood, David Ferguson, Alex Hidalgo, Betsy Beyer / Googlesre.google/workbook/implementing-slos/20182026-09-21полный текстРазделы 1, 2, 7, 11: SLI, SLO, владельцы, измерение и цикл review
S30Documentation Best PracticesGoogle Style Guidesgoogle.github.io/styleguide/docguide/best_practices.htmlбез даты2026-09-21полный текстРазделы 2, 5, 8, 11: сопровождение текущей документации, архив design docs
S31Docs as CodeEric Holscher; Write the Docswritethedocs.org/guide/docs-as-code/без даты2026-09-21полный текстРазделы 2, 5, 7, 9, 11: версии, review и проверки документации
S32GitHub Spec Kit — READMEGitHubgithub.com/github/spec-kitбез даты2026-09-21полный текстРазделы 2, 9, 10, 11: текущая структура открытого Spec Kit; main без SHA
S33SpecsAWS / Kirokiro.dev/docs/specs/без даты2026-09-21полный текстОбновление 2026-08-27. Разделы 2, 9, 10, 11: модель specs, режимы, различия IDE/CLI/Web; обновление
S34AGENTS.mdAGENTS.md / Agentic AI Foundationagents.md/без даты2026-09-21полный текстРазделы 2, 9, 10: AGENTS.md, назначение и совместимые инструменты
S35Naming the Pain in Requirements Engineering: Contemporary Problems, Causes, and Effects in PracticeD. Méndez Fernández et al.arxiv.org/pdf/1611.102882016-11-272026-09-21полный текстРазделы 2: NaPiRE: 228 организаций, проблемы требований
S36A Systematic Literature Review of Empirical Research on Quality RequirementsThomas Olsson; Séverine Sentilles; Efi Papatheocharousarxiv.org/html/2201.08627v12022-01-212026-09-21полный текстРазделы 2: обзор 84 работ, ограничения эмпирики quality requirements
S37Easy Approach to Requirements Syntax (EARS)Alistair Mavin, Philip Wilkinson, Adrian Harwood, Mark Novakresearchgate.net/publication/224079416_Easy_approach_to_r…20092026-09-21полный текстРазделы 2, 11: исходный EARS case study и его ограничения
S38On the Benefits And Problems Related to Using Definition of Done — A Survey StudySylwia Kopczyńska, Mirosław Ochodek, Jakub Piechowiak, Jerzy Nawrockiarxiv.org/pdf/2208.040032022-08-082026-09-21полный текстРазделы 2, 5: опрос DoD, 137 ответов, ограничения самоотчёта
S39Requirements Ambiguity Detection and Explanation with LLMs: An Industrial StudySarmad Bashir et al.es.mdu.se/pdf_publications/7221.pdf20252026-09-21полный текстРазделы 2, 10: 663 требования, поиск неоднозначностей, оценки экспертов
S40On the Impact of AGENTS.md Files on the Efficiency of AI Coding Agents (v2)Jai Lal Lulla et al.arxiv.org/html/2601.20404v22026-03-302026-09-21полный текстРазделы 2, 8: 124 PR, время и токены; без gold correctness
S41Do Context Files Help Coding Agents? A Two-Agent Ablation Study on Real RepositoriesPrakhar Khatriarxiv.org/html/2607.27250v12026-07-282026-09-21полный текстРазделы 2: 17 задач, 288 оценённых прогонов; малая мощность
S42Feature SpecsAWS / Kirokiro.dev/docs/specs/feature-specs/без даты2026-09-21полный текстОбновление 2026-08-04. Разделы 2, 10: requirements/design, EARS, анализ; дата обновления
S43Design Docs Are All You Need: An AI-native Machine-Learning Performance ToolSamuel Kushnir et al.arxiv.org/html/2609.05364v12026-09-042026-09-21полный текстРазделы 2, 11: узкий case report spec-as-source, авторские числа затрат
S44Understanding Spec-Driven-Development: Kiro, spec-kit, and TesslBirgitta Böckeler / Thoughtworks; MartinFowler.commartinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html2025-10-152026-09-21фрагментРазделы 2, 10, 11: типология и критика SDD по опыту 2025
S45Structured model outputsOpenAIdevelopers.openai.com/api/docs/guides/structured-outputsбез даты2026-09-21фрагментРазделы 2, 10: форма JSON Schema не удостоверяет содержание
S46Professional Practice Series: The BriefBritish Institute of Interior Design (BIID)biid.org.uk/resources/professional-practice-series-brief2020-12-152026-09-21полный текстРазделы 4, 11: клиентский brief, ожидания, ограничения и ответственность
S47DiátaxisDaniele Procidadiataxis.fr/без даты2026-09-21полный текстРазделы 7, 11: четыре потребности и формы документации
S48Notion Pricing PlansNotionnotion.com/pricingбез даты2026-09-21полный текстРазделы 9: сущности, возможности, ограничения Free и история
S49DocumentsLinearlinear.app/docs/documentsбез даты2026-09-21полный текстРазделы 9: документы, шаблоны, история и связи с работой
S50PricingLinearlinear.app/pricingбез даты2026-09-21полный текстРазделы 9: цены и ограничения тарифов
S51What are the different Jira plans?Atlassianatlassian.com/software/jira/guides/more/jira-editionsбез даты2026-09-21полный текстРазделы 9: сущности Jira, тарифы и ограничения Free
S52PricingAWS / Kirokiro.dev/pricing/без даты2026-09-21полный текстРазделы 9: цены Free/Pro и кредитная модель расхода
S53Custom instructions with AGENTS.mdOpenAIlearn.chatgpt.com/docs/agent-configuration/agents-mdбез даты2026-09-21полный текстРазделы 9, 10: загрузка и границы AGENTS.md в Codex
S54Best practices for Claude CodeAnthropiccode.claude.com/docs/en/best-practicesбез даты2026-09-21фрагментРазделы 9, 10: тематические рекомендации по интервью, контексту, проверке
S55Effective context engineering for AI agentsAnthropicanthropic.com/engineering/effective-context-engineering-f…2025-09-292026-09-21полный текстРазделы 10: релевантный контекст, compaction и заметки
S56OpenAI Model Spec (2025-12-18)OpenAImodel-spec.openai.com/2025-12-18.html2025-12-182026-09-21фрагментРазделы 10: структура датированной спецификации поведения
S57Painless Functional Specifications – Part 1: Why Bother?Joel Spolskyjoelonsoftware.com/2000/10/02/painless-functional-specifi…2000-10-022026-09-21полный текстРазделы 11: позиция практика о проектировании в тексте
S58Manifesto for Agile Software DevelopmentАвторы Agile Manifestoagilemanifesto.org/20012026-09-21полный текстРазделы 11: ценности документации и работающего результата
S59An insider look at Amazon's culture and processes — Working Backwards excerptColin Bryar, Bill Carr / Amazonaboutamazon.com/news/workplace/an-insider-look-at-amazons…20212026-09-21полный текстРазделы 11: публичный отрывок Working Backwards; не полная книга
S60ГОСТ 34.602-2020 — официальная карточка стандартаРосстандартprotect.gost.ru/gost/details/5876f733-ee91-431a-8cb6-9e02…20212026-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 окупаемость / полная стоимость владения
эффект относительно вложений и суммарные затраты; в отчёте не рассчитаны.