---
title: "Лучшие практики написания спецификаций: от PRD и RFC до спецификаций для LLM-агентов"
slug: "specification-writing-practices"
created: 2026-09-21
rounds: 1
---

# Уточнение задачи

## Исходная формулировка пользователя

> нужно исследование:
> лучшие практики написания спецификаций

## Раунд 1

| # | Ось | Вопрос | Рекомендация | Ответ |
|---|---|---|---|---|
| 1 | Цель и решение | Что обслуживает исследование? | Внутренний стандарт спецификаций для продукта и компании: как писать спецификации, которые однозначно исполняют человек и LLM-агент, на трёх уровнях (продуктовая, техническая, задача для исполнителя); шаблоны, чек-лист качества, машиночитаемая структура с полями и статусами | да, включая проверки, приемку и т.д.... |
| 2 | Границы темы | Что внутри и что снаружи? | Внутри: PRD, one-pager, PR-FAQ, pitch; design doc, RFC, ADR; инженерия требований по 29148, EARS, user stories с критериями приёмки, use cases, BDD и Gherkin, specification by example; контракты OpenAPI, JSON Schema, AsyncAPI; spec-driven development для LLM-агентов; качество: неоднозначность, проверяемость, трассируемость, ревью, версионирование. Снаружи: дизайн-спецификации интерфейсов в глубину, юридические ТЗ и SOW, аппаратные спецификации, TLA+ и Alloy как референс, ГОСТ 34 как референс | да |
| 3 | Контекст применения | Кто пишет и кто исполняет? | Продукт для управления компанией; пишут владелец продукта и аналитик, исполняют разработчики и LLM-агенты кодирования; запросы подразделений как вход; SOP не раскрывать | Пишет - ллм под руковотсвом человека, исполняет - все: ллм, сотрудники разных отделов, партенер, клиент... |
| 4 | Исторический горизонт | — | Только действующие практики, состояние на сентябрь 2026, тренды 2016–2026, особенно 2023–2026; происхождение кратко | Да, только современные с упором для LLM |
| 5 | Обязательные объекты сравнения | — | PRD в версиях Google, Intercom, Lenny; Amazon PR-FAQ и 6-pager; Shape Up pitch; RFC инженерных культур; Google design doc; ADR; SRS по 29148; EARS; user story с INVEST; Gherkin и specification by example; use cases; OpenAPI и JSON Schema; GitHub Spec Kit, Kiro, AGENTS.md, рекомендации OpenAI и Anthropic; docs as code и Diátaxis как референс; Spolsky как происхождение; ГОСТ 34.602 как референс; инструменты как референсы | Всё, что считаешь нужным |
| 6 | Акценты по разделам | — | Усилить 1, 3, 4, 5, 6, 8; раздел 10 как ядро; раздел 9 сжато | Да |
| 7 | Название и slug | — | «Лучшие практики написания спецификаций: от PRD и RFC до спецификаций для LLM-агентов», `specification-writing-practices` | ок |

Оси «Критерии успеха» и «Ограничения» зафиксированы по умолчанию без вопроса. Запуск обеих моделей сразу: очередь Fable свободна.

## Раунд 2

Не потребовался. Ответ по оси 3 расширил аудиторию исполнителей за пределы разработки: спецификации пишет LLM под руководством человека, исполняют LLM-агенты, сотрудники разных подразделений, партнёры и клиенты. Расширение принято как есть и внесено в цель, границы и контекст: юридическая сторона договоров и SOW остаётся снаружи, но структура задания для партнёра и подрядчика, бриф для клиента и протокол приёмки входят в предмет.

## Итог уточнения

| Ось | Значение | Источник |
|---|---|---|
| Цель и решение | Внутренний стандарт спецификаций для продукта управления компанией: как писать спецификации, которые однозначно исполняют человек и LLM-агент, на уровнях продуктовой, технической и задачи для исполнителя, включая встроенные проверки, критерии приёмки и процедуру приёмки результата; шаблоны, чек-лист качества, машиночитаемая структура с полями и статусами; автор спецификации — LLM под руководством человека | ответ пользователя |
| Границы темы | Внутри: продуктовые и технические документы, инженерия требований, контракты как спецификация, spec-driven development и спецификации для LLM-агентов, LLM как автор спецификации, задания для сотрудников подразделений, задания и ТЗ для партнёров и подрядчиков с приёмкой, брифы для клиентов, качество и приёмка. Снаружи: дизайн-спецификации интерфейсов в глубину, юридическая сторона договоров, аппаратные и строительные спецификации, формальные методы и ГОСТ 34 как референсы, регламенты SOP, управление требованиями крупных программ в глубину | рекомендация, принята с расширением по оси 3 |
| Контекст применения | Продукт для управления компанией 5–500 человек; автор — LLM под руководством человека; исполнители — LLM-агенты, сотрудники разных подразделений, партнёры и подрядчики, клиенты; масштаб от соло до команды инженеров 5–20 и подразделений до 500 человек | ответ пользователя |
| Исторический горизонт | Только действующие практики; состояние на сентябрь 2026 подробно; тренды 2016–2026 с упором на 2023–2026 и LLM; происхождение кратко; устаревшие не описывать | ответ пользователя |
| Обязательные объекты сравнения | Рекомендованный список плюс формы для нелинейных аудиторий: statement of work и scope statement с критериями приёмки, work instruction для сотрудников, бриф для клиента и подрядчика, акт приёмки и Definition of Done, SLA как спецификация сервиса; остальное на усмотрение исследователя | рекомендация, принята («всё, что считаешь нужным») |
| Акценты по разделам | Усилены 1, 3, 4, 5, 6, 8; раздел 10 как ядро (LLM как автор и LLM как исполнитель); раздел 9 сжат до референсов; во всех разделах проверки и приёмка как часть спецификации | ответ пользователя |
| Критерии успеха | Полнота по стандарту; по итогам можно собрать шаблоны по аудиториям, чек-лист качества, протокол приёмки и машиночитаемую структуру; спецификация, написанная по стандарту, исполняется агентом или сотрудником без уточнений и принимается по критериям | по умолчанию |
| Ограничения | Только запреты стандарта | по умолчанию |
