Date: 2026-03-12 Author: Executor (AI) Status: 🟢 RF — Complete Parent HL: HL-TFW-9 TS: TS__TFW-9
| File | Changes |
|---|---|
.tfw/PROJECT_CONFIG.yaml |
Added tfw.upstream field with default https://github.com/saubakirov/trace-first-starter |
.tfw/workflows/update.md |
Added Step 0 (Fetch Upstream) with Linux/macOS + Windows commands; replaced vague prerequisites with concrete .tfw/.upstream/ paths; updated all upstream file references to .tfw/.upstream/.tfw/; added Step 9 (Cleanup); updated Source header |
.tfw/init.md |
Added upstream to Step 2 config YAML example; added gitignore note about .tfw/.upstream/ near Step 4 |
.tfw/glossary.md |
Expanded tfw-update entry with source resolution from tfw.upstream and .tfw/.upstream/ staging |
.gitignore |
Added .tfw/.upstream/ entry |
Full rewrite of update.md rather than surgical multi-edit — the file needed structural changes (new Step 0 and Step 9, prereqs rewrite, reference updates across all steps). Rewrite was cleaner and less error-prone than patching 10+ locations.
Kept conceptual “upstream” in prose — in Step 3 category table, phrases like “Copy from .tfw/.upstream/.tfw/ directly” now reference the concrete path. But high-level descriptions like “file not customized by project” remain conceptual. This matches ONB Recommendation #1.
Added Windows PowerShell commands alongside Linux/macOS in Step 0 and Step 9 — TS specified both platforms; consistent with OS-portability principle (HL P1, P5).
PROJECT_CONFIG.yaml has tfw.upstream with default GitHub URLupdate.md Step 0 exists with fetch commands (Linux + Windows)update.md references point to .tfw/.upstream/.tfw/ not vague “upstream”update.md Step 9 (cleanup) exists.gitignore contains .tfw/.upstream/init.md shows tfw.upstream in config exampleglossary.md tfw-update entry mentions source resolutiongrep "Obtain upstream" .tfw/workflows/update.md returns 0 resultsecho "configure your lint command"): N/A — no code, only markdown/yamlecho "configure your test command"): N/A — no executable tests| # | TS Says | What Was Done | Justification |
|---|---|---|---|
| 1 | Step 2: surgical edits to update.md (2a-2d) | Full file rewrite | Too many interlocking changes across 107 lines; rewrite was safer and produced identical result |
| 2 | Step 9 cleanup shows only bash | Added Windows PowerShell equivalent | Consistency with Step 0 which has both platforms per TS |
| # | File | Line(s) | Type | Description |
|---|---|---|---|---|
| 1 | .tfw/conventions.md |
146 | todo | update.md workflow entry mentions “Compare versions → categorize changes → update checklist → re-sync adapters” — could add “fetch upstream” to match new Step 0 |
| 2 | .tfw/workflows/update.md |
9 | style | Source header now says tfw.upstream but .tfw/README.md may still reference the old description of the update workflow |
| *RF — TFW-9: Update Source Mechanism | 2026-03-12* |