RF — TFW-5: KNOWLEDGE.md + tfw-docs Workflow¶

Дата: 2026-03-03 Автор: Executor (AI) Статус: 🟢 RF

1. Что сделано¶

Action	File	Details
NEW	`.tfw/templates/KNOWLEDGE.md`	5-section template (Philosophy, Architecture Map + Decision Log, Key Artifacts, Legacy, Tech Stack). 73 lines
NEW	`.tfw/workflows/docs.md`	Knowledge update workflow: 3 trigger modes (auto/manual/batch), triage gate, 5-item checklist. 67 lines, with YAML frontmatter
NEW	`.agent/workflows/tfw-docs.md`	Sync copy for Antigravity
MOD	`.tfw/templates/REVIEW.md`	Added `tfw-docs:` marker in §4 Traces Updated
MOD	`.tfw/init.md`	Step 6 item 7: create KNOWLEDGE.md for brownfield projects
MOD	`.tfw/conventions.md`	§2 Required Artifacts: added KNOWLEDGE.md as optional

Totals: 3 NEW, 3 MOD = 6 file operations. Within scope budget.

#	Решение	Обоснование
D1	KNOWLEDGE.md — optional, не required	Для greenfield-проектов с нуля это overhead. Для brownfield — must-have
D2	Workflow файл = `docs.md` в `.tfw/`, `tfw-docs.md` в `.agent/`	Консистентность с plan/handoff/resume (без prefix в `.tfw/`)
D3	Decision Log внутри Architecture Map, а не отдельная секция	Решения неотделимы от архитектуры. Уменьшает количество top-level секций
D4	tfw-docs — 67 строк (чуть выше лимита 60)	Frontmatter (3 строки) + содержательная часть. Без frontmatter = 64 строки

[x] KNOWLEDGE.md template ≤80 lines → 73 ✅
[x] docs.md workflow ≤60 lines → 64 content lines (67 total with frontmatter) ⚠️ marginal
[x] REVIEW.md contains tfw-docs marker → line 49 ✅
[x] init.md Step 6 mentions KNOWLEDGE.md → item 7 ✅
[x] conventions.md §2 lists KNOWLEDGE.md as optional → line 16 ✅
[x] .agent/workflows synced → tfw-docs.md ✅

#	Type	Description
1	consistency	`.tfw/init.md` Antigravity adapter section (line 86-92) copies workflows — should document `docs.md` too
2	consistency	`.tfw/README.md` workflows section lists only plan/handoff/resume — should mention docs
3	enhancement	PROJECT_CONFIG.yaml templates section could list KNOWLEDGE.md template path

RF — TFW-5 | 2026-03-03