dev@bfd:~/dev-diary$ git show 2026-01
commit 2026-01-22-overhaul-vibe-code-starter-kit-for-inexperienced-users
Author: MJ
Date: Jan 22, 2026

2026-01-22 - Overhaul Vibe Code Starter Kit for inexperienced users

Timeline

  • (Context) Identified critical gaps for inexperienced users in Vibe-Code Starter Kit (OS basics, destructive testing).
  • (Context) User authorized breaking code freeze to address issues immediately.
  • (Action) Created setup_project.py and setup_project.bat for consistent test environments.
  • (Action) Created terminal-basics.md and updated START_HERE.md for CLI education.
  • (Action) Rewrote context.md and iteration-guide.md for Modules 04-08 using Friendly Guide metaphors.
  • (Action) Updated prompt.txt for all modules with EXPLANATION STYLE block.
  • (Action) Created cleanup_project.py with allowlist logic to preserve core files.
  • (Action) Refactored module-specific reset scripts into _cleanup_tools/.
  • (Observation) Reset/Cleanup system now sanitizes user artifacts without deleting core files.
  • (Open Thread) MJ to execute Testing Sweep using starter-kit testing folders.

Context

  • Identified critical gaps for inexperienced users in Vibe-Code Starter Kit (OS basics, destructive testing).
  • User authorized breaking code freeze to address issues immediately.

Actions

  • Created setup_project.py and setup_project.bat for consistent test environments.
  • Created terminal-basics.md and updated START_HERE.md for CLI education.
  • Rewrote context.md and iteration-guide.md for Modules 04-08 using Friendly Guide metaphors.
  • Updated prompt.txt for all modules with EXPLANATION STYLE block.
  • Created cleanup_project.py with allowlist logic to preserve core files.
  • Refactored module-specific reset scripts into _cleanup_tools/.

Observations

  • Reset/Cleanup system now sanitizes user artifacts without deleting core files.

Open Threads

  • MJ to execute Testing Sweep using starter-kit testing folders.

Boundary Reminder: Seeds. No maintenance. No roadmap.