dev@bfd:~/dev-diary$ git show 2026-01
commit 2026-01-23-adopt-instructional-standard-and-pivot-to-dual-window-navigator
Author: MJ
Date: Jan 23, 2026

2026-01-23 - Adopt instructional standard and pivot to dual-window navigator

Timeline

  • (Context) Current language in docs was found to be “developer-adjacent” and not beginner-friendly.
  • (Context) “Save and run” abstraction identified as a failure point for true beginners.
  • (Action) Created Dual-Window Navigator files to enforce “Determinate Viability” (Atomic Steps, Context Anchoring).
  • (Action) Refactored platform-setup-guide.md, how-to-use-this-kit.md, and START_HERE.md to meet the new standard.
  • (Action) Conducted a full sweep of terminal-basics.md and all 8 module context.md files to ensure compliance.
  • (Observation) The “Instructional Standard” successfully eliminated ambiguity in the setup process during the pilot test.
  • (Context) Identified risk of “context pollution” if users ask the coding AI for guidance.
  • (Action) Pivoted project strategy to “Dual-Window Learning Model” (Window 1: Navigator/Teacher, Window 2: Engine/Builder).
  • (Action) Created Dual-Window Navigator files to execute the new features (ROADMAP.md and course-navigator-prompt.txt).
  • (Open Thread) Execution of the Navigator Implementation Plan is the next immediate task.

Context

  • Current language in docs was found to be “developer-adjacent” and not beginner-friendly.
  • “Save and run” abstraction identified as a failure point for true beginners.
  • Identified risk of “context pollution” if users ask the coding AI for guidance.

Actions

  • Created Dual-Window Navigator files to enforce “Determinate Viability” (Atomic Steps, Context Anchoring).
  • Refactored platform-setup-guide.md, how-to-use-this-kit.md, and START_HERE.md to meet the new standard.
  • Conducted a full sweep of terminal-basics.md and all 8 module context.md files to ensure compliance.
  • Pivoted project strategy to “Dual-Window Learning Model” (Window 1: Navigator/Teacher, Window 2: Engine/Builder).
  • Created Dual-Window Navigator files to execute the new features (ROADMAP.md and course-navigator-prompt.txt).

Observations

  • The “Instructional Standard” successfully eliminated ambiguity in the setup process during the pilot test.

Open Threads

  • Execution of the Navigator Implementation Plan is the next immediate task.

Boundary Reminder: Seeds. No maintenance. No roadmap.