Session driven by Tasks/KB-OS-next-upgrades.md (Talbot Response of 2026-07-09). Full review of the KB-OS project docs + vault survey, then implementation.
| Area | Change |
|---|
| 09_Logs retired | Rate-scanner ops report (~/projects/mbr) repointed MBR/09_Logs/Ops → MBR/Logs/Ops (ops_report.py default + config.yaml + README; committed 1c8ecbc). 43 log files git-mv’d; 85 ops logs now unified; folder deleted. New path verified via live import. |
| Biggest Rocks | Curated 5-rock cross-business table at top of Core/DASHBOARD.md (executes the prepped vault-wide-biggest-rocks task). MBR keeps Filter+Focus.md as-is; vault list is a roll-up. All link targets verified unique. |
| Agent layer v1 | /task-start + /task-continue now auto-load the dept charter chain (JOB_DESCRIPTION → Staff file → project STATUS) derived from the task file’s path. New Agent-Team.md roster (org chart, autonomy levels, expand-the-team checklist), linked from Core/DASHBOARD + KB-OS portal. |
| Skill fixes (task-continue) | Was missing the KB-native Core/*/Projects/*/Tasks/ search glob (silently unable to find KB-OS tasks by name); still used “AI/Human Response” instead of “Claude/Talbot Response”. Both fixed in ai-config SSOT + deployed (WSL + Windows). task-start’s _tmp cross-reference (“Skip Step 5”) pointed at the wrong step — fixed during renumber. |
| Folder-note cleanup | MBR/Strategy/02_Strategy.md + SDC/Strategy/02_Strategy.md (pre-restructure remnants) renamed to Strategy.md with all ambiguous bare links path-qualified (Vision/Mission/Strategic Plan/ICP/USP exist in both MBR and SDC). MBR’s note had linked “Brand Voice and Tone Guidelines” — an SDC file. |
| Stray-folder cleanup | Empty MBR/Clippings/, MBR/Misc/ removed. Vault-root Clippings/ (Web Clipper stray, 1 file) merged into Core/Misc/Clippings/. Vault-root Glossary/ (one empty accidental F.A.S.T..md, zero inbound links) removed. |
| KB_Structure refresh | Stale legacy-Business snapshots deleted; folder_structure util config updated (output → KB_Structure/ subfolder, dead kb-business preset dropped; committed 5e02642); KB/MBR/SDC snapshots regenerated fresh (verified: no 09_Logs/02_Strategy remnants). Util doc updated with the WSL→cmd.exe run pattern. |
| Doc refresh | KB-OS STATUS.md (3 weeks stale), ROADMAP.md (M2/M3 closed; new M3.5 “Agent layer v1”; M4 additions), UPGRADES.md, KB-OS-Usage.md (task routing was pre-v5.2; wikilink rule now includes the path-qualify exception). _active.md tracker updated. |
| Spin-offs | Tasks/mbr-content-consolidation.md (origin-story-safe, inventory-first, archive-with-wikilinks — status: ready) and Tasks/idea-capture-workflow.md (Web Clipper single-intake + /triage-inbox design — status: ready). |
- KB-OS LESSONS: curated dashboard rows go stale when a source task closes — cross-check
_active.md in the same pass (caught live: first rocks draft listed the already-closed ai-config-rules-upgrade as active).
- folder_structure LESSONS: never
uv run a Windows-venv D:-drive project from WSL (Linux venv bricks Windows uv); wrap in cmd.exe.
| Decision / change | Detail |
|---|
| Active Depts → Agent-Team consolidation (Talbot: redundant, approved) | Agent-Team.md gained Inbox columns (Core + MBR tables, all inbox files verified); Core/DASHBOARD.md and MBR/DASHBOARD.md dept tables replaced by roster link + quick-inbox line. Commits e20ba98, c0b046f. |
| Ideas-Workflow → Capture-Routing (Talbot: consolidate, approved) | Core/Ideas-Workflow.md → Core/Processes/Capture-Routing.md (the Processes charter’s “to be authored” doc). Unique Save-criteria content migrated in from the older superseded SMTM/Ideas Workflow.md first; both old files now pointers; full ref sweep (KB-OS-Usage, Processes JD, MBR pointer, idea-capture task, UPGRADES). |
| filter-focus-refresh latent bug (found by the sweep) | Step 3 read Business-Ideas-Workflow.md “for ranking criteria” — a 7-line pointer since before the unified vault’s first commit. Criteria SSOT is Filter+Focus.md’s own header. Fixed in ai-config e4666a5, deployed. |
| Fresh-session gate (Talbot’s standing rule) | /task-start (step 4) + /project-start (step 0) now hard-stop and require /clear + re-run when the session holds any unrelated prior context. |
| KB_Structure confirmed current | All 3 presets regenerated post-consolidation. Caveat: folder_levels: 4 — deep folder interiors (e.g. KB-OS/) listed as folder only. |
git add with one bad pathspec stages NOTHING — a single fatal: pathspec ... did not match aborts the entire multi-path staging silently (renames staged earlier by git mv masked it). Hit twice this session. → After any multi-pathspec git add that errors, re-run git status before committing. [→ KB-OS LESSONS.md — or global CLAUDE.md git section]- Pointer-target rot: consolidations must sweep skills that read the old target, not just wikilinks —
/filter-focus-refresh read a doc that had been a pointer for the vault’s entire git history; only the Ideas-Workflow consolidation sweep exposed it. → When consolidating/moving a doc, grep skills/commands for the superseded filenames too. [→ KB-OS LESSONS.md]
- Vault-wide
/rocks-refresh skill — deferred (UPGRADES), manual curation wins at 5 rows.
- ~12 skills exist only in
~/.claude/commands/ and not in ~/ai-config/claude/commands/ SSOT (incl. task-start) — AI-dept drift item.
SMTM_System.md rewrite still pending (pre-restructure paths; long-standing UPGRADES item).- AGENTS.md dept→charter map could link
Agent-Team.md — escalates to CEO (rules-system change).