trace-first-starter

HL — TFW-11: RESEARCH Stage

Дата: 2026-03-30 Автор: Coordinator (AI) Статус: 🔵 HL — Ожидает ревью

1. Видение

Текущий пайплайн TFW: HL → TS → ONB → RF → REVIEW. Между HL и TS есть разрыв: HL фиксирует видение, но детали для качественного TS часто недостаточно проработаны. Координатор пишет TS “из головы”, пропуская слепые зоны, непроверенные допущения и альтернативные подходы.

RESEARCH — новая стадия между HL и TS, где AI-агент ведёт структурированное исследование: задаёт критические вопросы, вскрывает слепые зоны, изучает проект и внешние источники, помогает пользователю доработать решение до уровня, достаточного для написания TS.

Цель — не критика ради критики, а совместное исследование, из которого рождаются детали.

Дополнительно: tfw-research доступен как самостоятельный воркфлоу/слэш-команда для произвольного исследования в любой момент, в том числе без привязки к задаче.

2. Текущее состояние (As-Is)

Аспект	Состояние
Пайплайн	`⬜ TODO → 🔵 HL → 🟡 TS → 🟠 ONB → 🟢 RF → 🔍 REV → ✅ DONE`
Между HL и TS	Phase 1 plan.md: “ask 3-5 questions” — минимальный Research
Артефакт исследования	Нет. Вопросы и ответы теряются в чате
Standalone research	Нет workflow и слэш-команды
Роли	Coordinator, Executor, User. Нет отдельной “исследовательской” роли
Статусы	7 статусов (TODO, HL, TS, ONB, RF, REV, DONE + BLOCKED)

Что теряется сейчас

Вопросы и ответы из Phase 1 plan.md — не сохраняются
Альтернативные подходы — не фиксируются
Обоснование выбора решения — остаётся только в чате
Слепые зоны — не вскрываются системно
Внешний ресёрч — не предусмотрен

3. Целевое состояние (To-Be)

Аспект	Целевое состояние
Пайплайн	`⬜ TODO → 🔵 HL → 🔬 RES → 🟡 TS → 🟠 ONB → 🟢 RF → 🔍 REV → ✅ DONE`
Между HL и TS	Формальная стадия RESEARCH с циклическим процессом
Артефакт	`RES__*.md` — Research Report: вопросы, ответы, выводы, решения
Standalone	`/tfw-research` — слэш-команда + `.tfw/workflows/research.md`
Роль	Coordinator (research mode) — не новая роль, а режим координатора
Статусы	8 статусов (+🔬 RES)

Процесс RESEARCH (циклический)

┌──────────────────────────────────────────────────────┐
│                   RESEARCH CYCLE                      │
│                                                       │
│  1. Анализ → 2. Вопросы → 3. Ответы → 4. Checkpoint │
│       ↑                                     │         │
│       │          ┌─── Нет ──────────────────┘         │
│       └──────────┘                                    │
│                  └─── Да → Выводы → К TS              │
│                                                       │
│  Checkpoint: "Достаточно ли информации для TS?"       │
└──────────────────────────────────────────────────────┘

Поведение агента в RESEARCH

Критический анализ: что точно есть, чего точно нет, где допущения
Наводящие вопросы: помогает пользователю увидеть то, что он не видит
Слепые зоны: вскрывает неочевидные риски, зависимости, edge cases
Альтернативы: “а что если сделать X вместо Y?”
Автономный ресёрч: изучение проекта, веб-поиск (если нужно)
Тон: здоровая критика + конструктивная помощь, не назойливый критик

Два режима использования

Режим	Контекст	Артефакт	Триггер
Pipeline	После HL, перед TS	`RES__TFW-N__*.md` в папке задачи	Координатор предлагает после HL
Standalone	Любой момент, любая тема	`RES__standalone__*.md` или в папке задачи	`/tfw-research`

Гейт после HL

После написания HL координатор:

Даёт рекомендацию: нужен RESEARCH или нет (с обоснованием)
Спрашивает пользователя
Никогда не пропускает без подтверждения пользователя

4. Фазы

Phase A: Core — Артефакт, статус, воркфлоу 🔴

Шаблон RES.md (.tfw/templates/RES.md)
Воркфлоу research.md (.tfw/workflows/research.md)
Обновление conventions.md — новый статус 🔬 RES, новый артефакт, обновлённый пайплайн
Обновление glossary.md — новые термины

Phase B: Интеграция — plan.md, адаптеры, слэш-команда 🟡

Обновление plan.md — RESEARCH гейт после HL
Адаптер Claude Code: новая слэш-команда /tfw-research
Обновление CLAUDE.md.template — таблица команд
Обновление README.md — пайплайн, Task Board

Phase C: Валидация — проверка на живой задаче 🟢

Запуск /tfw-research на текущей задаче (TFW-11) как proof-of-concept
Корректировка шаблона/воркфлоу по результатам

5. Definition of Done (DoD)

✅ 1. Новый статус 🔬 RES в conventions.md и glossary.md
✅ 2. Шаблон RES.md в .tfw/templates/
✅ 3. Воркфлоу research.md в .tfw/workflows/
✅ 4. plan.md содержит RESEARCH гейт после HL
✅ 5. /tfw-research работает как standalone слэш-команда
✅ 6. Пайплайн во всех файлах обновлён (conventions, glossary, README, adapters)
✅ 7. Proof-of-concept: минимум один RES-артефакт создан через /tfw-research

6. Definition of Failure (DoF)

❌ 1. RESEARCH становится обязательной бюрократией для тривиальных задач (должен быть skip-path)
❌ 2. Агент деградирует в “20 вопросов” без конвергенции (цикл без выхода)
❌ 3. RES-артефакт дублирует HL или TS вместо дополнения

При провале: пересмотреть дизайн цикла и критерии конвергенции.

7. Принципы

Research ≠ допрос — это совместное исследование, а не серия вопросов. Агент привносит свои наблюдения, а не только спрашивает.
Конвергенция обязательна — каждый цикл заканчивается checkpoint: “Достаточно для TS?”. Нет бесконечных исследований.
Артефакт = память — всё, что выяснено в RESEARCH, фиксируется в RES-файле. Чат может исчезнуть, артефакт остаётся.
Лёгкий skip — для простых задач координатор рекомендует пропуск, пользователь подтверждает одним словом.
Standalone first — /tfw-research должен работать без контекста задачи. Pipeline-mode = надстройка.

8. Зависимости

Зависимость	Статус
conventions.md актуальна	✅
glossary.md актуальна	✅
plan.md актуален	✅
Adapter templates (Claude Code)	✅

9. Риски

Риск	Вероятность	Влияние	Mitigation
Пользователи пропускают RESEARCH всегда	Средняя	Среднее	Координатор даёт обоснованную рекомендацию; RES показывает ценность на практике
Цикл не конвергирует	Низкая	Высокое	Жёсткий checkpoint с явным вопросом; лимит циклов (рекомендательный)
RES-артефакт становится слишком большим	Средняя	Низкое	Секционная структура: выводы отдельно от полного лога
Путаница Pipeline vs Standalone	Низкая	Среднее	Чёткое разделение в воркфлоу: режим определяется при запуске

*HL — TFW-11: RESEARCH Stage

2026-03-30*

This site is open source. Improve this page.