Дата: 2026-03-30 Автор: Coordinator (AI) Статус: 🔬 RES — В процессе Parent HL: HL-TFW-13 Режим: Pipeline
Проектируем tfw-init — workflow, через который AI-агент инициализирует TFW в любом проекте. Нужно определить: что агент делает автономно vs что спрашивает, как обнаруживает стек, как обучает пользователя по ходу, как обрабатывает разные адаптеры, что делать с “How to Write a New Adapter”, и как именно init становится {PREFIX}-1.
| # | Решение | Обоснование |
|---|---|---|
| D1 | Discover: агент читает любые файлы + спрашивает пользователя | Проект может быть сложным, маркеров недостаточно |
| D2 | Порядок: Discover → Interview → Knowledge → Setup → Verify | Сначала знания, потом файлы — создаются сразу заполненными |
| D3 | Обучение: агент спрашивает “новичок ли?” в начале, подсказывает по ходу как туториал | Не замедляет опытных, помогает новичкам |
| D4 | Interview + Mini-Setup объединены: опрос → сразу создать скелет (папку, Task Board, CONFIG) | Нужна папка для RES-артефакта до Knowledge phase |
| D5 | Adapter docs → .tfw/adapters/README.md |
Адаптерная документация рядом с адаптерами |
| D6 | Knowledge = полноценный /tfw-research с RES-артефактом |
Init — первое знакомство с TFW, показать RESEARCH в действии |
| D7 | Knowledge вызывает /tfw-research формально, агент объявляет вызов |
Явный переход, пользователь видит как workflows связаны |
| D8 | RF для init — полноценный (файлы, решения, результаты) | Init = задача как любая другая, полный trace |
| D9 | Пустой проект: нет отдельной ветки, агент разбирается сам | Меньше формализма, агент задаёт вопросы по ситуации |
| # | Вопрос | Статус | Ответ |
|---|---|---|---|
| Q1 | Глубина Discover | ✅ | Любые файлы + вопросы к пользователю |
| Q2 | Порядок Knowledge vs Setup | ✅ | Knowledge → Setup (сначала знания) |
| Q3 | Обучение по ходу | ✅ | Спросить в начале, подсказывать как туториал |
| Q4 | Mini-Setup: объединить с Interview? | ✅ | Да, Interview + Mini-Setup = одна фаза |
| Q5 | Куда Adapter docs | ✅ | .tfw/adapters/README.md |
| Q6 | Knowledge: полный RESEARCH или упрощённый? | ✅ | Полноценный /tfw-research |
| Q7 | Вызов research из init | ✅ | Формальный вызов /tfw-research, агент объявляет |
| Q8 | RF для init-задачи | ✅ | Полноценный RF |
| Q9 | Пустой проект | ✅ | Агент разбирается сам, задаёт вопросы |
.tfw/adapters/README.md/tfw-research формально в Phase 3 — workflow внутри workflow| Этап | Статус | Ключевые находки |
|---|---|---|
| Сбор | ✅ | Порядок фаз, глубина Discover, обучение как туториал |
| Извлечение | ✅ | Mini-Setup необходим, adapter docs → adapters/README.md |
| Вызов | ✅ | Формальный вызов /tfw-research, полный RF, нет ветки для пустого проекта |
Вопрос: Соразмерно ли решение задаче? Что можно убрать без потери ценности? Оценка агента: 5 фаз для init — это много на первый взгляд. Но Discover — автономный скан (компактный), Interview+Mini-Setup — один разговор + создание скелета, Knowledge — формальный вызов research.md (не дублирует), Full Setup — механика создания файлов, Verify — чеклист. Каждая фаза маленькая. Сложность адекватна. Единственный риск: workflow может быть >200 строк из-за 5 фаз + обучающих подсказок. Mitigation: подсказки conditional (только для новичков).
Вердикт: Достаточно для TS.
За 3 этапа определена архитектура tfw-init: 5 фаз (Discover → Interview+Mini-Setup → Knowledge via /tfw-research → Full Setup → Verify), init как {PREFIX}-1, формальный вызов research, полный RF, адаптивное поведение для пустых проектов. RESEARCH вскрыл проблему с порядком фаз (Knowledge до Setup ломает папку задачи — решено Mini-Setup) и определил судьбу adapter docs. Без RESEARCH мы бы пропустили конфликт Knowledge↔Setup и не формализовали вызов research из init.