HL — TFW-51: TFW Light RU — четыре файла для дисциплинированной работы с ИИ¶

Date: 2026-08-06 Author: Codex (Coordinator) Status: ✅ DONE — owner-confirmed retrospective closure, 2026-08-08

0. Retrospective Closure Context¶

TFW-51 was delivered on 2026-08-06 as an explicit owner-authorized emergency exception. The owner was travelling to a same-day seminar and instructed the Coordinator to create the complete Light starter autonomously, without the normal TFW planning and handoff ceremony. The four-file starter was delivered and successfully used at the seminar. The owner confirmed this outcome on 2026-08-08.

The task then moved directly into the broader TFW-52 product-development discussion, and TFW-51 was left administratively open at HL_DRAFT. This closure records the real chronology instead of fabricating a lifecycle that did not happen:

the owner confirms that the requested result was delivered, used successfully, and completed its purpose;
the four files under tfw-light-ru/ are frozen as the original field baseline and are not revised during closure;
the intentionally skipped TS, ONB, RF, evidence, and REVIEW artifacts are not reconstructed after the fact;
no seminar materials or participant data are copied into this repository;
TFW-52 is the successor for stabilization and further development, not evidence that TFW-51 failed.

1. Vision¶

TFW Light RU уже можно дать человеку, который впервые работает с ИИ: он переносит в новый проект четыре коротких Markdown-файла, описывает задачу обычными словами и сразу получает дисциплинированную работу со следами, памятью и понятным результатом. Комплект сохраняет философию TFW — мышление и решения не испаряются после чата — но не требует знания терминов, команд, ролей и полного жизненного цикла TFW.

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

«Я положил четыре файла в новый проект, ИИ спросил, кто я и что нужно сделать, а дальше сам сохранил задачу, ход работы, знания и готовый результат».

2. Current State (As-Is)¶

Полная TFW решает задачу сохранения контекста, но стала тяжёлой точкой входа для незнакомого с методологией пользователя.

Наблюдение	Реальное состояние	Следствие для семинара
Размер полного ядра `.tfw/`	63 файла: 16 workflow, 19 templates, 19 adapter-файлов	Новичок видит систему, которую сначала нужно изучить
Жизненный цикл	9 основных статусов, 6 типов рабочих артефактов и отдельные evidence/research/review-следы	Для первой задачи дисциплина воспринимается как церемония
Первая версия, commit `45fd1b0`	6 содержательных файлов	Уже давала переносимость, роль агента, задачу и журнал
Ранняя компактная версия, commit `e3a9591`	5 содержательных файлов	Подтверждает, что полезное поведение запускается малым набором
Откат экспериментов TFW-48/49, commit `bc6779e`	149 файлов изменено; удалено 27 103 строки	Контрпример: формальная полнота может уничтожить доступность метода
Текущий пользовательский контекст	Выступление сегодня; на подготовку 20–30 минут; аудитория — новички	Нужен готовый, переносимый, русскоязычный комплект без обязательного обучения TFW

В раннем наборе уже были сильные элементы: AGENTS.md, описание проекта, текущая задача и STEPS.md. Но он требовал вручную переносить Summary после каждого ответа, частично говорил языком разработки, не имел простой памяти о проекте и людях и не отделял рабочие результаты от общего журнала.

3. Target State (To-Be)¶

Создаётся отдельный комплект tfw-light-ru/, не являющийся новым режимом полной TFW и не изменяющий её текущие workflow.

Аспект	Целевое состояние
Начальный комплект	Ровно 4 Markdown-файла
Язык	Понятный русский; без необъяснённых сокращений и англоязычных заголовков
Предметная область	Документы, финансы, аналитика, образование, исследования, управление, контент; никаких допущений о разработке ПО
Первый запуск	Один пакет максимум из 3 вопросов: человек и участники; цель и аудитория проекта; первая задача и роль ИИ
Список задач	Один файл, 5 статусов: `НОВАЯ`, `В РАБОТЕ`, `НА ПРОВЕРКЕ`, `ГОТОВО`, `ЗАБЛОКИРОВАНО`
Память	Проект, люди, договорённости, подтверждённые знания и решения — без сырой переписки
Рабочие следы	На каждую задачу один `TRACE.md` рядом с результатами в `work/`
Результаты	Любые нужные форматы: Markdown, DOCX, XLSX, PPTX, PDF, изображения и другие материалы
Возобновление	Новый чат читает 4 стартовых файла и `TRACE.md` активной задачи, затем продолжает с последней зафиксированной точки

3.1 Result Visualization¶

Сразу после копирования:

tfw-light-ru/
├─ README.md             философия и запуск за 60 секунд
├─ AGENTS.md             короткие правила для ИИ
├─ TASKS.md              простой список задач и статусов
└─ memory/
   └─ PROJECT.md         проект, люди, договорённости, знания, решения

После первой задачи агент сам создаёт рабочую папку:

work/
└─ T-001__analiz-dokumentov/
   ├─ TRACE.md           цель, роль, источники, находки, решения, проверка
   ├─ contradictions.md  найденные нестыковки со ссылками на источники
   └─ brief.docx         готовый материал для пользователя

Пользователь видит не методологические артефакты, а четыре знакомых сущности: правила, задачи, память и работу. TRACE.md создаётся не заранее как пятый шаблон, а только тогда, когда начинается реальная задача.

3.2 Value Flow¶

ЧЕЛОВЕК + 4 ФАЙЛА
        │
        ▼
ИИ уточняет: кто участвует → зачем проект → какую роль взять и что сделать
        │
        ├──► memory/PROJECT.md  сохраняет устойчивый контекст
        └──► TASKS.md           фиксирует задачу и статус
                                  │
                                  ▼
                         work/T-XXX/TRACE.md
                   источники → находки → решения → проверка
                                  │
                                  ▼
                           ГОТОВЫЙ РЕЗУЛЬТАТ
                                  │
                   TASKS обновлён; полезное знание перенесено в память
                                  │
                                  ▼
                     НОВЫЙ ЧАТ ПРОДОЛЖАЕТ БЕЗ ПЕРЕСКАЗА

4. Phases¶

Задача намеренно однофазная: четыре новых файла находятся внутри лимита одной компактной поставки. Разделение на дополнительные фазы создало бы именно ту церемонию, от которой уходит TFW Light.

Phase A: Собрать и проверить TFW Light RU 🔴¶

Создать tfw-light-ru/README.md: тезис, философия, структура, запуск за 60 секунд и один самодостаточный стартовый промпт.
Создать tfw-light-ru/AGENTS.md: роль агента, чтение контекста, первый разговор, простой цикл задачи, дисциплина источников, следов, памяти и проверки.
Создать tfw-light-ru/TASKS.md: таблицу задач, пять статусов и короткие правила обновления.
Создать tfw-light-ru/memory/PROJECT.md: честное начальное состояние проекта и разделы для людей, целей, договорённостей, знаний и решений.
Проверить комплект на трёх сценариях семинара: анализ документов и нестыковок; упрощение методички; подготовка визуализации или раздаточного материала.
Проверить возобновление: новый агент должен понять проект, активную задачу и следующий шаг только по файлам.

5. Definition of Done (DoD)¶

✅ 1. В tfw-light-ru/ находятся ровно четыре стартовых Markdown-файла: README.md, AGENTS.md, TASKS.md, memory/PROJECT.md.
✅ 2. Все четыре файла написаны на ясном русском языке и не требуют знания TFW, разработки ПО, Git, CLI, YAML или специальных команд.
✅ 3. README.md объясняет проблему испаряющегося знания, философию следов и запуск комплекта за 60 секунд; стартовый промпт самодостаточен вне контекста README.
✅ 4. AGENTS.md при первом запуске задаёт не более трёх вопросов одним пакетом: кто пользователь и участники; цель и аудитория проекта; первая задача и роль ИИ. Если пользователь не назначил роль, агент предлагает конкретную роль сам.
✅ 5. Для каждой начатой задачи агент создаёт work/T-XXX__название/TRACE.md и фиксирует минимум: цель, роль и аудиторию, входные материалы, источники, существенные находки и противоречия, решения и допущения, проверку, пути к результатам и следующий шаг.
✅ 6. TASKS.md использует только пять заданных статусов, содержит ссылки на рабочие папки и обновляется самим агентом при начале, передаче на проверку, завершении или блокировке задачи.
✅ 7. memory/PROJECT.md хранит только устойчивый проектный контекст: цель, людей и их проектные роли, договорённости, подтверждённые знания и решения. Сырые логи, чувствительные личные сведения и одноразовые детали туда не попадают.
✅ 8. Для анализа документов агент отделяет факты источника от своих выводов, указывает файл и страницу/раздел, не скрывает пробелы и не выдумывает содержание отсутствующих материалов.
✅ 9. Для редактуры, визуализаций и раздаточных материалов агент сохраняет не только итог, но и критерии аудитории, ключевые смысловые решения и способ проверки пригодности результата.
✅ 10. Три семинарских сценария завершаются готовым к использованию результатом, заполненным TRACE.md, актуальным статусом в TASKS.md и переносом действительно долговечного знания в memory/PROJECT.md.
✅ 11. Тест нового чата подтверждает, что работа возобновляется без пересказа истории: агент называет цель проекта, пользователя, активную задачу, уже принятые решения и следующий шаг.
✅ 12. Каждый стартовый файл остаётся коротким: README.md до 500 слов, AGENTS.md до 900 слов, TASKS.md до 250 слов без строк задач, memory/PROJECT.md до 400 слов без накопленных записей.

6. Definition of Failure (DoF)¶

❌ 1. Для запуска требуется больше четырёх стартовых файлов или отдельная установка.
❌ 2. Комплект вводит HL, TS, RF, RES, ONB, REVIEW, phase, role lock, evidence gate, YAML-конфигурацию или /tfw-* команды.
❌ 3. Текст по умолчанию говорит о коде, сборке, тестах, коммитах, ветках или деплое вместо универсальной работы с информацией и результатами.
❌ 4. Агент задаёт длинное интервью, требует вручную вести журнал или перекладывает обновление файлов на пользователя.
❌ 5. TRACE.md превращается в стенограмму чата или требование раскрывать скрытые внутренние рассуждения вместо короткой записи источников, находок, решений и проверки.
❌ 6. Память смешивает проверенные факты, предположения и личные предпочтения без маркировки либо сохраняет лишние персональные данные.
❌ 7. Результат объявляется готовым без ссылки на исходные материалы и без проверки, понятной для предметной задачи.
❌ 8. Файлы содержат <placeholder>, обещания «дописать позже», демонстрационный мусор или инструкции, которые нужно вручную адаптировать перед использованием.
❌ 9. Попытка совместимости с полной TFW увеличивает объём или число сущностей TFW Light.

On failure: исправлять содержание в пределах тех же четырёх файлов; не добавлять новые уровни, шаблоны и процессы. Если дисциплина не помещается в лимит, сначала упростить формулировки и объединить дублирующие правила.

7. Principles¶

След важнее разового ответа — работа неполна, пока цель, источники, решения и проверка существуют только в чате.
Просто снаружи, серьёзно внутри — короткий ритуал не оправдывает поверхностный анализ; глубина проявляется в качестве источников, находок и результата.
Память создаётся работой — знания не документируют отдельно «когда-нибудь»; долговечные факты и решения переносятся в память при закрытии задачи.
Файл раньше сообщения — существенные находки и результаты сначала сохраняются в проекте, затем кратко сообщаются в чат.
Честность источников — факт, вывод и предположение различаются; неизвестное обозначается; отсутствующий материал не симулируется.
Человек задаёт смысл — агент выясняет, кто пользователь, для кого результат, какова цель и какую профессиональную роль нужно взять.
Один след на одну задачу — без разрастания типов артефактов; TRACE.md объединяет рабочий контекст, решения, проверку и передачу следующему агенту.
Любая предметная область — правила одинаково естественны для документов, финансов, аналитики, образования, исследований, управления и контента.
Полная готовность — результат должен быть пригоден к использованию без ручного дописывания.
TFW Light — отдельный вход — он передаёт философское ядро полной TFW, но не обязан воспроизводить её терминологию, стадии и инфраструктуру.

7.2 Knowledge Citations¶

#	Source	Item	How it applies
1	[`.tfw/README.md`](../../concepts/philosophy.md)	Knowledge Evaporates; Traces; Values and Principles	Философское ядро Light: дисциплина вместо инструмента, след как память проекта, честность, переносимость
2	`README.md`	Self-aware product; Resume; Knowledge compounds; One ritual, any domain	Определяет результат: новый человек или чат продолжает работу, а знания накапливаются как побочный продукт
3	`KNOWLEDGE.md`	D28, D31, D36, D40, D49; Legacy TFW-48/49	Точные названия и структура создают поведение; ранний onboarding должен быть самодостаточным; отклоняется повторное усложнение
4	[`knowledge/philosophy.md`](../../knowledge/philosophy.md)	F4, F11–F14, F21–F24, F27	Структура важнее чек-листов, не нужно плодить сущности, метод доменно-нейтрален, шаблоны должны быть минимальны, прогресс должен быть видимым
5	[`knowledge/convention.md`](../../knowledge/convention.md)	F7, F10, F13, F19	Самодостаточный промпт, ясная структура, правильные названия и минимум верхнеуровневых принципов
6	[`knowledge/process.md`](../../knowledge/process.md)	F3–F5, F10, F12, F16, F22	Короткий алгоритм и запись в файл раньше чата; реальный старт через естественное описание; защита не-кодовых задач от недостоверных источников и лишней формальности
7	[`knowledge/constraint.md`](../../knowledge/constraint.md)	F1–F3, F7	Ограничение объёма инструкций, защита от шумной памяти и универсальная проверка не-кодовых результатов
8	[`knowledge/stakeholder.md`](../../knowledge/stakeholder.md)	F1–F3	Бизнес-ценность и работа с документами первичны; состояние должно быть видно по структуре; «сказано, что готово» недостаточно без проверки
9	[`tasks/TFW-31__quick_start_agent_first/HL-TFW-31__quick_start_agent_first.md`](../TFW-31__quick_start_agent_first/HL-TFW-31__quick_start_agent_first.md)	Bootstrap paradox; self-contained quick start	Новый агент не должен знать метод заранее; обучение и выполнение должны начинаться с понятной точки входа

8. Dependencies¶

Dependency	Status
Пользователь задал аудиторию, язык, срок, число файлов, основные сущности и примеры задач	✅
Философское ядро `.tfw/README.md` прочитано и отражено	✅
Ранние commits `45fd1b0` и `e3a9591` изучены как компактные рабочие предшественники	✅
Откат TFW-48/49 `bc6779e` учтён как граница против усложнения	✅
Целевая папка для поставки принята по умолчанию: `tfw-light-ru/`	✅ default
Исследование внешних методологий	N/A — для срочной поставки достаточно пользовательского брифа, истории репозитория и проверенных Project Values

9. Risks¶

Risk	Probability	Impact	Mitigation
Light окажется просто красивым README без реальной дисциплины	Medium	High	Обязательное автоматическое создание `TRACE.md`, обновление задач и перенос знаний встроены в короткий цикл агента
Инструкции снова разрастутся	High	High	Жёсткие лимиты слов и четырёх файлов; новый смысл допускается только через замену или сжатие существующего
Новичок не поймёт разницу между задачей, памятью и следом	Medium	Medium	Четыре бытовых названия, дерево результата в README и один пример первого цикла
Память станет свалкой переписки	Medium	High	В память попадает только проектно-релевантное и долговечное; факты, решения и предположения маркируются
Пустая папка `work/` потеряется при переносе четырёх файлов	High	Low	Агент создаёт `work/` и папку задачи автоматически при первой задаче; пятый служебный файл не нужен
Анализ документов будет звучать убедительно, но окажется недоказуемым	Medium	High	В `TRACE.md` обязательны источники и локаторы; факты отделены от интерпретаций; пробелы показываются явно
Попытка сделать Light совместимым со всем полным TFW вернёт церемонию	Medium	High	Комплект объявлен самостоятельной точкой входа; совместимость и миграция не входят в эту задачу
Из-за срочности не будет полевой проверки на реальных файлах семинара	Medium	Medium	В рамках выполнения провести три коротких сценария на нейтральных материалах; реальные материалы можно подставить без изменения структуры

10. RESEARCH Case¶

Достаточно ли одного TRACE.md на задачу для возобновления после нескольких сложных итераций.
Насколько стабильно разные ИИ-инструменты выполняют правило «сначала записать в файл» без специальных адаптеров.
Потребуется ли после семинара отдельная англоязычная версия; для текущей поставки она не нужна.

Hypotheses¶

#	Hypothesis	Status
H1	Четыре стартовых файла достаточно, чтобы новичок понял структуру и начал работу без изучения полной TFW	confirmed by user direction + commits `45fd1b0`, `e3a9591`
H2	Один task-local `TRACE.md` вместе с `TASKS.md` и `memory/PROJECT.md` позволяет новому чату продолжить работу без отдельного ONB/RF/REVIEW-цикла	validate during execution
H3	Пакет из максимум трёх стартовых вопросов даёт достаточно контекста для первых типовых задач семинара	validate during execution
H4	Доменно-нейтральные правила источников и проверки одинаково применимы к анализу документов, упрощению методички и созданию раздаточного материала	supported by Project Values; validate on three scenarios

Risks of Not Researching¶

Главный риск — поведенческие правила могут оказаться слишком мягкими для отдельных ИИ-инструментов. Однако отдельный исследовательский цикл не соответствует сроку 20–30 минут и повторит нежелательную церемонию. Риск пропорционально снижается прямой проверкой трёх сценариев и нового чата в ходе выполнения.

Proposed RESEARCH Focus¶

Если после семинара появится реальный сбой, исследование запускается только по конкретному триггеру:

Gather: в каком месте агент перестал обновлять задачи, след или память.
Extract: какое минимальное структурное правило исправляет сбой без нового файла.
Challenge: работает ли исправление в нескольких ИИ-инструментах и предметных областях.

Для текущей срочной поставки рекомендация координатора: пропустить отдельный /tfw-research. Обоснование — пользователь уже задал решение и ограничения, ранние commits дают рабочий исторический прототип, а неизвестные проверяются непосредственно на трёх целевых сценариях.

Why Not Just...?¶

Почему не взять файлы из первого commit без изменений? — там есть ручное копирование Summary, язык разработки, нет явной памяти о людях и нет task-local папки с результатами.
Почему не «урезать» полную TFW? — даже сокращённый полный цикл сохраняет термины и ментальную модель, которые новичку сначала придётся изучить.
Почему не сделать один большой файл? — философия, инструкции агента, живой список задач и накапливаемая память имеют разные жизненные циклы; их смешение быстро создаст длинный и устаревающий документ.
Почему не добавить шаблоны для каждого вида результата? — это сразу вернёт разрастание; формат результата определяется конкретной задачей, а универсальным остаётся только TRACE.md.

11. Strategic Insights (Planning)¶

#	Insight	Category	Source
S1	Полная методология стала слишком тяжёлой именно для незнакомых новичков; нужна отдельная «лайт» точка входа, похожая по ощущению на первые commits	stakeholder	User, постановка TFW-51
S2	Демонстрация проходит сегодня, а окно подготовки — 20–30 минут; ценность измеряется готовыми файлами, которые можно сразу бросить в новый проект	constraint	User, постановка TFW-51
S3	Целевая работа принципиально не про программирование: анализ массивов документов и противоречий, упрощение методичек, визуализации и раздаточные материалы	philosophy	User, постановка TFW-51
S4	Агент должен выяснить и запомнить, кто пользователь, кто участвует в проекте, какова цель и какую роль агент берёт в текущей задаче	stakeholder	User, постановка TFW-51
S5	Минимальная видимая структура уже определена пользователем: список задач с простыми статусами, память/знания и папка работы с результатами	convention	User, постановка TFW-51
S6	Смысл и чувство `.tfw/README.md` важнее переноса формальной механики полной TFW	philosophy	User, постановка TFW-51
S7	TFW-48/49 — явная отрицательная граница: нельзя превращать компактную идею в архитектурную и процессную систему	risk	User, постановка TFW-51
S8	Упрощение не должно стать примитивизацией: короткий внешний ритуал обязан сохранять цели, источники, решения, проверку и долговечное знание	philosophy	User, «не упрощай главное»

fact-candidates: processed 2026-08-08

HL — TFW-51: TFW Light RU — четыре файла для дисциплинированной работы с ИИ | 2026-08-06