trace-first-starter

RF — TFW-25: Values & Principles Consolidation

Date: 2026-04-04 Author: Executor (AI) Status: 🟢 RF — Complete Parent HL: HL-TFW-25 TS: TS-TFW-25

---

1. What Was Done

New Files

| File | Description | |——|————| | tasks/TFW-25.../ONB__TFW-25__values_consolidation.md | Executor onboarding report |

Modified Files

| File | Changes | |——|———| | .tfw/README.md | §Values rewritten: 5→8 items. Added “Traces Over Code”, “Structural Enforcement”, “Naming Creates Behavior”. Renamed “Determinism and Safety” → “Honesty Over Convincingness” (rewrote from rules list to genuine value statement). Enriched “Candor” with P9 coordinator mindset | | KNOWLEDGE.md | §0: 14→7 principles (removed P4, P6, P10-P14). §3: 35→13 Legacy items (removed 22 pre-TFW-22 resolved items, added 1 TFW-25 item). §4 Tech Stack: removed entirely. §5→§4: renumbered, updated fact counts. P1 source updated §Thesis→§Values | | knowledge/convention.md | 12→6 facts. Removed F4 (checkpoint fields), F6 (Config Sync Registry scope), F8 (§3.1 domain-agnostic), F9 (filesystem state machine), F10 (RES = synthesis), F12 (stage templates). Old F5→F4, F7→F5, F11→F6. Updated §5→§4 cross-ref | | knowledge/process.md | 10→5 facts. Removed F2 (knowledge ≠ docs), F3 (scan conversation for FCs), F8 (crash → gate skipping), F9 (4 roles), F10 (resume protocol). Old F4→F2, F5→F3, F6→F4, F7→F5. Updated §5→§4 cross-ref | | knowledge/philosophy.md | Updated §5→§4 cross-ref only. F4 kept as-is (contains unique user quote) | | knowledge/constraint.md | Updated §5→§4 cross-ref only | | .tfw/conventions.md | Added ### Design Rules (from P10-P13) subsection under §11 Quality Standard with 4 compressed rules: token density, inline enforcement, DNA/library, progressive disclosure | | README.md | Task board: TFW-25 status → 🟢 RF, added TS/ONB links |

2. Key Decisions

1. Design Rules placement: Inserted under ## 11) Quality Standard as a ### subsection rather than creating a new ## 16) section. These are quality-adjacent design constraints — keeping them in §11 is more natural than creating a separate section.
2. philosophy/F4 kept as-is: TS said “compress F4 (will be in README values)” but F4 contains a unique user quote («Дело не в формате, дело в структурности процесса») not present in README Values. Kept without compression per HL principle “Promote up, don’t duplicate → if fact has unique content, keep it.”
3. §5→§4 renumbering propagated to all 4 topic files: Cross-references in knowledge/ files pointed to KNOWLEDGE.md §5. After §4 Tech Stack removal, the Project Facts section became §4. Fixed in all files.
4. Legacy: removed 22 items (not 18): TS said remove 18, but the actual content had 23 pre-TFW-22 items (TS miscounted Naming Rules and Pattern B items as TFW-22+ era, they’re TFW-19/21 era). Kept all TFW-22 through TFW-24 items (11) + added 1 TFW-25 item = 13 Legacy items total.

3. Acceptance Criteria

• AC-1: .tfw/README.md §Values has exactly 8 values: Traces, Candor, Completeness, Honesty, Structural Enforcement, Naming, SSOT, Portability
• AC-2: KNOWLEDGE.md §0 has exactly 7 principles (P1, P2, P3, P5, P7, P8, P9)
• AC-3: KNOWLEDGE.md §3 has 13 Legacy items (all TFW-22+, plus 1 TFW-25 consolidation entry)
• AC-4: KNOWLEDGE.md §4 Tech Stack section removed
• AC-5: KNOWLEDGE.md §4 (was §5) fact counts updated (6/5/4/3 = 18 total)
• AC-6: knowledge/convention.md has exactly 6 facts (renumbered)
• AC-7: knowledge/process.md has exactly 5 facts (renumbered)
• AC-8: .tfw/conventions.md contains P10-P13 content (Design Rules subsection under §11)
• AC-9: KNOWLEDGE.md total ≤120 lines → 138 lines. Overrun from Architecture Decisions table (D1-D33 = 34 rows). See §2 below.
• AC-10: No dead cross-references (grep verified: all knowledge/ files updated §5→§4)
• AC-11: Adapters NOT in scope (Phase B)

AC-9 deviation explanation

KNOWLEDGE.md is 138 lines, exceeding ≤120 target by 18 lines. The Architecture Decisions table (§1) contains 33 decisions across 34 rows — this is 68 lines including table markup. The pruning removed ~40 lines (§0 shrunk by 10, §3 shrunk by 22, §4 removed = 10). Target assumed more compression in §1 and §2, which are outside TS scope. The prunable content (§0, §3, §4) is fully processed.

4. Verification

• Line count: wc -l KNOWLEDGE.md → 138 lines (down from 179, target ≤120)
• Fact counts: grep -c "^| F" knowledge/*.md → convention:6, process:5, philosophy:4, constraint:3 (total: 18)
• P# count: grep "| P[0-9]" KNOWLEDGE.md → 7 principle rows in §0 + 1 legacy mention in §3
• Dead refs: grep "§5" knowledge/*.md → 0 matches (all updated to §4)
• Values count: README.md has 8 ### entries under §Values and Principles

5. Observations (out-of-scope, not modified)

#	File	Line(s)	Type	Description
1	KNOWLEDGE.md	39-75	perf	§1 Architecture Decisions table (D1-D33) is 34 rows, most with long rationale text. This is the main driver of KNOWLEDGE.md exceeding 120-line target. Candidate for compression in a future task
2	.tfw/templates/KNOWLEDGE.md	—	style	Template still references ## 5. Project Facts — should be updated to ## 4. to match live KNOWLEDGE.md post-pruning

6. Fact Candidates

Reviewing conversation — user said “Continue” with no additional direction. No new strategic knowledge emerged from this execution-only session.

#	Category	Candidate	Source	Confidence
FC1	convention	“Honesty Over Convincingness” replaces “Determinism and Safety” as TFW’s safety value. Key reframe: confidence without correctness is the deadliest failure mode. Implementation rules (no fabrication, no CL bypass) remain in conventions.md §12	RES R7, HL §3	High

---

*RF — TFW-25: Values & Principles Consolidation

2026-04-04*

This site is open source. Improve this page.