title: "Briefing — "What should we investigate?"" source: "tasks/TFW-52__tfw_light_v1/research/iter1/1_briefing.md"
Briefing — "What should we investigate?"¶
Mindset: Strategist. You're planning an investigation, not doing it. Frame what matters. Resist solving. Test: "Can I explain WHY we're investigating this and what would change our approach?" Parent: HL-TFW-52 Goal: Define a coherent TFW edition spine in which Light and Assisted remain useful products, teach the evolution of the method, and migrate additively toward Team and Full.
Research Plan¶
Gather¶
- Reconstruct early TFW history from Git and compare its smallest working concepts with the current
.tfw/canon and the field-tested TFW-51 prototype. - Decompose the decision into independent factors: semantic invariants, edition selection criteria, source topology, migration contract, and pedagogical sequencing.
- Read HL INNO-6/8/12/13 as required educational evidence and map their claims to H7–H8 without assuming transferability.
- Use external sources to test progressive scaffolding, authentic-task learning, product-line/source-layout patterns, and migration continuity; actively collect evidence against the proposed ladder.
Extract¶
- Build a configuration space that crosses source topology, semantic core, selection model, migration strategy, and learning sequence.
- Derive a minimal invariant set and a Light → Assisted → Team → Full artifact-migration table from repository evidence rather than the current HL proposal alone.
- Compare configurations against typical non-code work in several departments and identify combinations not proposed in the HL.
- Re-check the emerging synthesis against external primary sources and seek counterexamples where staged editions create confusion, duplication, or lock-in.
Challenge¶
- Attack surviving configurations with wrong-root use, live-project migration, terminology drift, edition mis-selection, independent updates, and novice/advanced mixed-audience scenarios.
- Seek counter-evidence in early TFW reversals, current anti-patterns, TFW-51 limitations, and INNO evidence that does not generalize.
- Use external primary research to challenge instructional fading, transfer, and cognitive-load assumptions; reject configurations that depend on unsupported pedagogy.
- Decide the status of H5–H8 and produce bounded recommendations for the coordinator, leaving Assisted enforcement and Team mechanics to later iterations.
Hypotheses (from HL §10)¶
| # | Hypothesis | HL Status |
|---|---|---|
| H5 | A source layout under editions/01-light/, 02-assisted/, then 03-team/ is clearer and safer than root .tfw-light/ / .tfw-assisted/ folders when each edition is copied into the runtime root. |
open |
| H6 | One semantic core — goal → Working Backwards task → trace → knowledge — permits mechanical edition upgrades without loss or manual reconstruction of accumulated project state. | open |
| H7 | Edition choice by work complexity, number of roles, cost of error, and knowledge lifetime is clearer across departments than labels such as beginner/advanced. | open |
| H8 | The sequence do → notice a limit → receive a mechanism → repeat and compare traces teaches TFW evolution better than a lecture that describes all four editions in order. | open |
Scope Intent¶
- In scope: iteration 1 product spine; early Git history; current framework; TFW-51 field prototype; HL INNO-6/8/12/13; H5–H8; edition topology; semantic invariants; department-neutral selection criteria; additive migration; pedagogical sequence; external evidence and counter-evidence at every stage.
- Out of scope: implementation; edits outside this iteration folder; Assisted hook/runtime contracts (H1–H4); Drive or scheduler mechanics; Team session/thread mechanics (H9); changes to HL, README,
iterations.yaml, TS, or product files; commits.
Guiding Questions¶
- Which concepts are genuinely invariant from the earliest useful TFW through TFW-51 and the current canon, and which are later mechanisms that belong only to higher editions?
- Which combination of source topology, edition-selection criteria, and migration mapping minimizes ambiguity while preserving independent usability and compatibility?
- What repository, field, educational, and external evidence would falsify H5–H8 rather than merely confirm the approved HL?
User Direction¶
- Run TFW-52 iteration 1 in
deepmode and test H5–H8. - Required local evidence: early TFW Git history, current
.tfw/, TFW-51, and HL INNO-6/8/12/13 inD:\projects\research\innoforce-ai-first. - Perform external research and seek counter-evidence at briefing, gather, extract, and challenge.
- At every gate, report
[CHECKPOINT: briefing|gather|extract|challenge], findings, only blocking questions (maximum three), and a recommended next action; do not ask the user directly. - Apply working defaults for non-blocking uncertainty. Write only within this iteration folder. Do not commit.
Briefing Evidence Check¶
Required-source inventory¶
- Early TFW history is available: the repository starts at
45fd1b0(2025-09-08) and exposes pre-v3 artifacts through the v2 transition (d297fec) and v3 migration (85e4217). Gather will sample artifacts at semantic transitions rather than treating commit subjects as evidence. - Current canon is available:
.tfw/contains the active conventions, workflows, templates, glossary, configuration, and accumulated decisions loaded for this iteration. - Field prototype is available: TFW-51 contains its approved HL plus the four-file starter (
README.md,AGENTS.md,TASKS.md,memory/PROJECT.md). - Educational HLs are available: HL INNO-6, INNO-8, INNO-12, and INNO-13 resolve in
D:\projects\research\innoforce-ai-first\tasks\...and will be read in Gather.
External framing and counter-evidence¶
- Git's official submodule documentation establishes a real counter-alternative to H5: separate repositories can be mounted under one superproject while retaining independent history and versioning. Therefore,
editions/must win on TFW-specific coupling, copy/install UX, and migration evidence; it cannot be accepted merely because one repository looks simpler. Source: https://git-scm.com/docs/gitsubmodules. - Google's published monorepo case identifies a common source of truth as a benefit but explicitly presents the model as a trade-off supported by specialized tooling. This supports comparing coupled evolution in one repository, not blindly generalizing a monorepo recommendation to tiny starter editions. Source: https://research.google/pubs/why-google-stores-billions-of-lines-of-code-in-a-single-repository/.
- Kapur's randomized studies found that problem solving before instruction can improve conceptual understanding and transfer when it is followed by instruction and consolidation. This is preliminary support for H8's experience-first sequence, but only as a deliberately designed two-phase cycle. Source: https://doi.org/10.1111/cogs.12107.
- Kirschner, Sweller, and Clark synthesize counter-evidence that minimally guided instruction is inefficient for novices. This prevents H8 from being interpreted as "let novices discover TFW alone"; Gather must locate the guidance, bounded task, feedback, and consolidation supplied by each edition. Source: https://doi.org/10.1207/s15326985ep4102_1.
Briefing decisions¶
- BF-D1: Treat H5 as a topology trade-off with three live families — same-repository edition directories, root hidden sibling frameworks, and independently versioned repositories — and require TFW-specific evidence for elimination.
- BF-D2: Test H8 as bounded experience followed by explicit naming, comparison, and consolidation, not as unguided discovery. Evidence for either pure lecture or pure discovery will count as counter-evidence to the HL's simplified wording.
Preliminary hypothesis test¶
- H8 — still open, boundary refined. External evidence supports problem-before-instruction under designed conditions and also warns against minimal guidance for novices. The iteration must test whether TFW-51/INNO materials provide enough structure and consolidation for the sequence to be educationally credible.
Metacognitive check¶
The new result is not confirmation of the HL: both H5 and H8 now have explicit live counter-models. Source topology cannot be inferred from generic monorepo preference, and experience-first pedagogy is only defensible if guidance and consolidation are visible in the actual materials.
Stage complete: YES