TS — TFW-52 / Phase A: линейка редакций и стабильный Light

Date: 2026-08-08 Author: Coordinator Status: ✅ TS_APPROVED — 2026-08-08 Parent HL: HL-TFW-52 — ✅ HL_APPROVED rev. 2

Отдельный Phase HL не создаётся. Master HL §3.2, §3.5, §3.6 и §4 полностью специфицируют Phase A; дублирующий документ добавил бы процессный артефакт без нового содержания и нарушил бы HL DoF 12. Контекст фазы берётся из master HL.

---

1. Objective

Phase A превращает успешный полевой прототип TFW-51 в первую редакцию продуктовой линейки: создаёт каталог editions/, переносит в editions/01-light/ проверенный четырёхфайловый пакет, даёт человеку понятную точку выбора между Light, Assisted и Full и подтверждает работоспособность Light двумя живыми не-кодовыми прогонами. Assisted в этой фазе не создаётся — Phase A обязана оставить после себя самостоятельный работающий продукт, а не половину будущей конструкции.

2. Scope

In Scope

• Создание каталога editions/ и файла editions/README.md — выбор редакции по характеру работы, короткая история метода, переходы между ступенями.
• Перенос baseline TFW-51 из tasks/TFW-51__tfw_light_ru/tfw-light-ru/ в editions/01-light/ — копированием, с сохранением ровно четырёх входных документов.
• Три ограниченные правки внутри Light (и никаких других):
• инструкция установки приводится в соответствие с HL §3.5 — копируется содержимое папки в корень проекта, а не папка целиком;
• в карточку проекта memory/PROJECT.md добавляются поля активной редакции и версии (основание для остановки Assisted при двух контрактах в Phase B, HL DoD 10);
• упоминания старого имени пакета tfw-light-ru заменяются на актуальные пути.
• Добавление в корневой README.md короткого входа в линейку редакций.
• Два живых не-кодовых прогона Light на чистом проекте с сохранением evidence.

Out of Scope

• Assisted, .codex/, hooks, people/, статусные папки, knowledge/ — Phase B.
• Периодическая консолидация памяти — отдельная будущая задача (HL §3.7).
• Ось организации работы по ролям — TFW-54 (HL §3.3).
• Перевод Light на английский. Baseline TFW-51 русскоязычный и проверен вживую именно в таком виде; смена языка меняет проверенный артефакт и требует повторной полевой проверки. editions/README.md и корневой README.md пишутся на языке окружающих их файлов репозитория (английский), содержимое 01-light/ остаётся русским. Английская редакция Light, если понадобится, — отдельная задача.
• Изменение, перемещение или удаление исходника tasks/TFW-51__tfw_light_ru/tfw-light-ru/. Это исторический след завершённой задачи (HL Principle 7).
• Изменение .tfw/ в любом виде.
• Содержательная переработка Light: новые разделы, новые правила, новые сущности, изменение рабочего цикла и статусов.

3. Principles Check

#	Principle (from HL §7)	Enforced by	Gate
P1	Цель выше задачи	AC-6, AC-7	Прогон показывает, что ИИ уточняет цель и аудиторию до работы, а не выполняет формулировку буквально
P2	Working Backwards до действий	AC-6, AC-7	В TRACE.md каждого прогона критерии готовности заполнены до раздела «Ход работы»
P3	След работы — часть результата	AC-6, AC-7	TRACE.md содержит источники и решения, а не отчёт, дописанный после завершения
P4	Знание должно накапливаться	AC-6, AC-7	По итогам прогона в memory/PROJECT.md перенесено долговечное знание либо в trace записано обоснованное «нечего переносить»
P5	Структура поддерживает дисциплину	AC-2	Статус задачи и её след существуют как файлы, а не как обещание в тексте
P6	Автоматика тиха до границы риска	AC-2	Правило «не более трёх вопросов одним пакетом» сохранено в AGENTS.md без изменений
P7	Первичный след не уничтожается	AC-8	Исходник TFW-51 существует и побайтово совпадает с состоянием до фазы
P8	Один писатель на изменяемую сущность	N/A	В Light один участник; правило вступает в силу в Phase B
P9	Редакции обучают постепенно	AC-1	editions/README.md называет предел Light и проблему, которую решает следующая ступень
P10	Просто снаружи, честно внутри	AC-1, AC-3	Ограничения Light названы прямо; ни один файл не обещает возможностей Assisted

4. Affected Files

File	Action	Description
editions/README.md	CREATE	Выбор редакции по характеру работы, история метода, переходы, граница Light
editions/01-light/README.md	CREATE	Копия baseline + правка инструкции установки и путей
editions/01-light/AGENTS.md	CREATE	Копия baseline без содержательных изменений
editions/01-light/TASKS.md	CREATE	Копия baseline без изменений
editions/01-light/memory/PROJECT.md	CREATE	Копия baseline + поля активной редакции и версии в карточке проекта
README.md	MODIFY	Короткий вход в линейку редакций; существующие разделы не переписываются

Budget: 5 new files, 1 modification, ≈250 LOC. Лимиты: max 14 files, max 8 new, max 12 modified, max 1200 LOC. Укладывается.

Артефакты evidence (phase-a/evidence/) в бюджет продуктовых файлов не входят.

5. Acceptance Criteria

AC-1: Точка выбора редакции

editions/README.md позволяет человеку выбрать редакцию по характеру своей работы, не читая остальную документацию.

• [ ] Описаны три редакции: Light, Assisted, Full — с указанием, для какой работы каждая
• [ ] Выбор сформулирован через характеристики работы (разовость, повторяемость, число участников, цена ошибки), а не через должность или техническую подготовку
• [ ] Названы ручные пределы Light и то, какую наблюдавшуюся проблему решает Assisted
• [ ] Явно указано, что Assisted появится в Phase B и что папки 03-team/ не будет
• [ ] Текст не обещает возможностей, которых после Phase A не существует
• [ ] Объём — не более 600 слов

Gate: файл существует; сверка каждого пункта чтением; подсчёт слов Evidence: N/A — проверяется чтением файла, отдельная среда не требуется

AC-2: Light перенесён без потери сути

editions/01-light/ содержит ровно четыре входных документа, идентичных baseline TFW-51 за исключением трёх правок из §2.

• [ ] Существуют ровно README.md, AGENTS.md, TASKS.md, memory/PROJECT.md; других файлов и папок нет
• [ ] Diff против tasks/TFW-51__tfw_light_ru/tfw-light-ru/ содержит только правки, перечисленные в §2 In Scope; каждое отличие соотнесено с конкретным пунктом
• [ ] Рабочий цикл, статусы задач, структура TRACE.md и правило «не более трёх вопросов» не изменены
• [ ] Соблюдены словесные лимиты TFW-51: README.md ≤ 500, AGENTS.md ≤ 900, TASKS.md ≤ 250, memory/PROJECT.md ≤ 400 слов
• [ ] Hooks, исполняемые файлы, work/, knowledge/ и пустые папки «на будущее» отсутствуют

Gate: diff -r против исходника; подсчёт слов; листинг каталога Evidence: minimal — вывод diff -r и подсчёта слов приложить в EV как доказательство того, что изменения ограничены заявленными

AC-3: Инструкция установки соответствует топологии редакций [depends: AC-2]

Человек, следуя инструкции буквально, получает рабочий Light в корне своего проекта, а не вложенную папку.

• [ ] editions/01-light/README.md предписывает скопировать содержимое папки в корень проекта
• [ ] Ни один файл не описывает editions/01-light/ как рабочий каталог внутри проекта
• [ ] Стартовый промпт остаётся самодостаточным вне контекста README
• [ ] Упоминания tfw-light-ru отсутствуют

Gate: чтение файла; поиск строки tfw-light-ru по каталогу editions/ — совпадений ноль Evidence: minimal — подтверждается прогонами AC-6/AC-7, где установка выполняется по инструкции буквально

AC-4: Активная редакция объявлена [depends: AC-2]

Проект на Light декларирует, какая редакция и версия в нём активны — это основание для остановки Assisted при обнаружении двух контрактов в Phase B.

• [ ] В карточке проекта memory/PROJECT.md есть поля активной редакции и её версии с заполненными начальными значениями
• [ ] Поля описаны на пользовательском языке, без служебной терминологии
• [ ] Пользователь не обязан их редактировать вручную в обычной работе

Gate: чтение файла Evidence: N/A — фактическое использование полей проверяется в Phase B

AC-5: Вход в линейку из корня репозитория

Читатель корневого README.md понимает, что редакции существуют и где они лежат.

• [ ] Добавлен короткий блок со ссылкой на editions/README.md и назначением трёх редакций
• [ ] Существующие разделы, Task Board и ссылки не переписаны и не потеряны
• [ ] Не утверждается, что Assisted уже доступен

Gate: чтение diff корневого README.md Evidence: N/A — изменение документации, отдельная среда не требуется

AC-6: Живой прогон — анализ противоречий в пакете документов [depends: AC-3]

Light на чистом проекте доводит до готового результата не-кодовую задачу анализа.

• [ ] Создан чистый проект; содержимое editions/01-light/ скопировано в его корень по инструкции AC-3
• [ ] Подготовлен вход: не менее трёх документов с не менее чем двумя намеренными противоречиями между ними
• [ ] ИИ провёл первый запуск, заполнил memory/PROJECT.md и добавил задачу в TASKS.md
• [ ] Создана work/T-001__.../TRACE.md с целью, критериями, источниками, находками, решениями и проверкой
• [ ] Итоговая таблица противоречий существует файлом и ссылается на конкретные документы и разделы
• [ ] Оба намеренных противоречия найдены; выдуманных противоречий нет
• [ ] Статус задачи в TASKS.md соответствует фактическому состоянию по завершении

Gate: файлы результата и TRACE.md существуют и заполнены; таблица сверена с намеренными противоречиями Evidence: полная. Прогон выполняется в реальной сессии Codex на чистом проекте вне этого репозитория. В phase-a/evidence/ приложить: дерево файлов проекта после прогона, итоговый TRACE.md, файл результата, TASKS.md, memory/PROJECT.md. В EV зафиксировать, сколько вопросов задал ИИ до начала работы и потребовалось ли ручное вмешательство в структуру.

AC-7: Живой прогон — упрощение методички с раздаточным материалом [depends: AC-3]

Light доводит до готового результата не-кодовую задачу другого типа — переработку и производство материала.

• [ ] Создан отдельный чистый проект по той же инструкции
• [ ] Вход: методический текст, непригодный для целевой аудитории без переработки
• [ ] Результатом является готовый к использованию раздаточный материал, а не рекомендации по его созданию
• [ ] TRACE.md фиксирует аудиторию, учебную цель, исходный уровень и критерий понимания
• [ ] Долговечное знание перенесено в memory/PROJECT.md, либо в trace записано обоснование, почему переносить нечего
• [ ] Задача закрыта: статус, пути к результатам и следующий шаг заполнены

Gate: файл раздаточного материала открывается и пригоден для заявленной аудитории; TRACE.md заполнен по всем разделам Evidence: полная. Второй чистый проект, отдельная сессия. Приложить в phase-a/evidence/: дерево проекта, TRACE.md, файл раздаточного материала, memory/PROJECT.md. В EV отметить, отличается ли поведение ИИ от первого прогона и где Light потребовал ручной дисциплины от человека — эти наблюдения являются входом для Phase B.

AC-8: Полевой baseline TFW-51 не тронут

Исходный след завершённой задачи сохранён как история.

• [ ] tasks/TFW-51__tfw_light_ru/tfw-light-ru/ существует и не изменён
• [ ] Файлы [HL-TFW-51](../../TFW-51__tfw_light_ru/HL-TFW-51__tfw_light_ru.md) и содержимое папки TFW-51 не редактировались в этой фазе

Gate: git status по пути TFW-51 — изменений нет Evidence: minimal — вывод git status в EV

Evidence Artifacts

File	Description
phase-a/evidence/EV__phase-a__product_line_and_light.md	Структурированное evidence: заголовок среды, таблица по каждому AC, вердикт, индекс вложений (обязателен)
phase-a/evidence/run-1-contradictions/	Артефакты прогона AC-6: дерево проекта, TRACE.md, результат, TASKS.md, memory/PROJECT.md
phase-a/evidence/run-2-handout/	Артефакты прогона AC-7: дерево проекта, TRACE.md, раздаточный материал, memory/PROJECT.md
phase-a/evidence/diff-vs-tfw51.txt	Вывод diff -r и подсчёта слов для AC-2

6. Technical Guidance

Справочный материал, не инструкция. Исполнитель может отклониться, обосновав это в RF.

• Источник Light: tasks/TFW-51__tfw_light_ru/tfw-light-ru/ — четыре файла, 1735 слов суммарно. Текущие объёмы: README.md 468, AGENTS.md 769, TASKS.md 193, memory/PROJECT.md 305 слов.
• Правка установки касается README.md раздела «Запуск за минуту» — пункт «Положите эту папку в новый проект» противоречит HL §3.5 и является единственной обязательной содержательной правкой.
• Карточка проекта в memory/PROJECT.md — существующая таблица «Поле / Текущее состояние»; поля редакции добавляются туда же, отдельная секция не нужна.
• Требования к самому Light заданы в HL TFW-51 §DoD 1–12 — словесные лимиты, пять статусов, правило трёх вопросов, разделы TRACE.md. Они остаются в силе.
• Формат EV: .tfw/templates/evidence/EV.md. Требования к evidence — .tfw/conventions.md §Evidence subfolder: минимум один структурированный EV-файл, бинарные вложения индексируются в секции Attachments.
• Прогоны AC-6/AC-7 выполняются вне репозитория steps-framework, чтобы Codex не подхватил корневой AGENTS.md этого проекта. Это же условие проверяет реалистичность инструкции установки.
• Корневой README.md содержит Task Board с большим количеством ссылок — при правке использовать точечную вставку блока, а не переписывание файла.

7. Definition of Failure

• ❌ В editions/01-light/ оказывается больше или меньше четырёх входных документов.
• ❌ Diff против baseline содержит изменения, не перечисленные в §2 In Scope, включая «улучшения формулировок» и новые разделы.
• ❌ В Phase A появляются editions/02-assisted/, .codex/, hooks или заготовки под них.
• ❌ Создаётся пустая editions/03-team/ либо любая другая папка «на будущее».
• ❌ Исходник TFW-51 изменён, перемещён или удалён.
• ❌ Прогоны AC-6/AC-7 заменены описанием ожидаемого поведения, выполнены внутри этого репозитория или помечены VERIFIED без приложенных артефактов.
• ❌ Инструкция установки продолжает предлагать положить папку 01-light внутрь проекта.
• ❌ Любой файл Phase A обещает hooks, автоматическую память, ролевые режимы или другие возможности, которых после фазы не существует.
• ❌ .tfw/ изменена.

8. Phase Risks

Risk	Mitigation
Исполнитель воспринимает перенос как приглашение переписать Light «получше»	§2 Out of Scope и DoF 2 запрещают любые правки сверх трёх названных; AC-2 требует построчного diff
Прогон выполняется внутри steps-framework и подхватывает корневой AGENTS.md	§6 требует чистый проект вне репозитория; EV фиксирует путь проекта
Прогоны заменяются пересказом ожидаемого поведения	AC-6/AC-7 требуют приложенные файлы результата и trace; DoF отвергает VERIFIED без артефактов
editions/README.md начинает описывать Assisted как готовый	AC-1 требует явной пометки, что Assisted появится в Phase B
Правка корневого README.md ломает Task Board или ссылки	AC-5 требует сохранности существующих разделов; §6 предписывает точечную вставку
Наблюдения о ручных пределах Light теряются	AC-7 Evidence обязывает записать, где Light потребовал ручной дисциплины — это вход для Phase B

9. Cross-Phase Modifications

File	Also modified in	Coordination note
README.md (корневой)	Phase B	Phase B добавит упоминание готового Assisted. Блок редакций из Phase A должен быть расширяемым, а не переписанным заново
editions/README.md	Phase B	Phase B заменит формулировку «Assisted появится позже» на описание готовой редакции. Структура файла остаётся
editions/01-light/memory/PROJECT.md	Phase B (читается, не изменяется)	Поля активной редакции из AC-4 являются входом для остановки Assisted при двух контрактах (HL DoD 10). Имена полей менять нельзя без правки Phase B

---

TS — TFW-52 / Phase A: линейка редакций и стабильный Light | 2026-08-08