Project Diary — Day 21

March 23, 2026  |  Session Focus: CLI Tools Start Here + resources/index.html review
21Day
1New Page
1Page Patched
0/0Orphans/Broken

Session Summary

Day 21 opened with a clean restart — diary, 2DO list, and reference files dropped for context. Session was interrupted mid-morning by a Spectrum network outage (4AM to 8:30AM reported), resuming around 12:20PM. Despite the gap, full context was recovered immediately and work continued without loss.

Primary deliverable was deep-dive/cli-tools-start-here.html — the "path in" page that ties the eight CLI tool deep-dives together as a toolchain rather than a list. The resources/index.html was reviewed, found to be already well-built from a prior session, and patched with a corrected footer date and AI-NEW.html link.

A new recurring concept was named and added to the parking lot: top nav link rows on individual content pages — anchor links to major sections, giving visitors both a content preview and jump navigation. Deferred to a future session.

Pages Built / Modified This Session

deep-dive/cli-tools-start-here.html — NEW

The "Start Here" hub for the AI for Unix/Linux CLI tools section. Designed for a SysAdmin who arrives at the deep-dive index, sees eight tool cards, and doesn't know where to begin. Seven sections:

Card to be added to deep-dive-index.html at the top of the 🐧 AI for Unix/Linux section, before the Advanced Topics card.

resources/index.html — PATCHED

Page was already well-built from a prior session. Two footer corrections applied:

deep-dive-index.html — Card to Add Day 22

Paste this at the top of the 🐧 AI for Unix/Linux section, before <!-- Advanced Topics -->:

<!-- CLI Tools Start Here --> ## spaces added so ignored byscan <a h r ef="cli-tools-start-here.html" class="hub-link"> <div class="link-title">&#x1F9F0; CLI AI Tools &mdash; Start Here</div> <div class="link-desc">New to AI tooling at the command line? Start here. Eight tools, how they connect, suggested learning order, quick reference table, and a scenario guide &mdash; which tool for which job.</div> <span class="link-status status-live">&#x2705; Live</span> </a>

Parking Lot — Added This Session

Top Nav Link Row — Individual Content Pages

Add a compact anchor-link nav row near the top of each individual tool page (sgpt, fzf, jq, fabric, ollama, aider, gh, github-copilot). Two benefits identified:

Example: [ Installation ] [ Basic Usage ] [ SysAdmin Use Cases ] [ AI Integration ] [ Honest Assessment ]

Deferred — good candidate for a dedicated session after current content sprint completes.

Session Close Protocol

Observations

The CLI tools section now has a proper front door. Eight individual pages are useful; a page that explains how they form a toolchain and gives a SysAdmin a path in is what turns a reference section into something approachable. The "Which Tool For Which Job" scenario table in particular should be immediately useful for someone trying to decide where to start.

The "parking lot" concept was named this session — a place for real ideas that aren't today's work. Better than a trash bin, better than cluttering the active 2DO list. The top nav link row idea goes there first.

Spectrum outage cost the morning but the afternoon was productive. Clean context recovery after the gap — the restart protocol continues to prove its value.


cmh — AI Education Project Day 21 — March 23, 2026
Next session: Day 22 — deep-dive-index.html card update + Day 20 diary card + parking lot review