Here is Claude's plan:
╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌
 Plan: Discoveries — Persistent Micro-Learning Capture System
Context
Today's session surfaced a gap in the capture system. The user learned
dozens of things — w3m for man pages, /usr/share/doc inventory, find -exec
 sh -c patterns, man -Hcat | w3m, git section 7 man pages, pacman
interrogation commands — but the existing systems don't have a clean home
for them:

  • Codex = permanent syntax reference (generic, undated — "the library")

  • Pattern Journal = dated problem→fix→rule (requires a real problem solved — "the lab notebook")

  • Commands Learned = project-scoped appendices (dies with the project)

  • Worklogs = daily capture (buried in chronological pages, hard to find later)

  • Lessons Learned = monthly synthesis (too infrequent, loses detail)

    What's missing: a topic-organized, append-only, dated discovery log where
micro-learnings land immediately and stay findable forever. Not a full
codex page. Not a full pattern entry. Just: "I discovered X works, here's
the command, here's when, here's why it matters."
    The key insight: discoveries graduate. A discovery that proves useful
repeatedly graduates to the Codex. A discovery that solves a recurring
problem graduates to the Pattern Journal. Discoveries are the intake
funnel for the entire knowledge system.
    Architecture: discoveries/
    Partials (content)
    partials/discoveries/
├── tools/
│   ├── w3m.adoc              # w3m tips, tricks, HTML rendering
│   ├── pacman.adoc           # Package interrogation patterns
│   ├── man.adoc              # man page navigation, sections, w3m
rendering
│   ├── info.adoc             # GNU info pages, navigation
│   ├── find.adoc             # find patterns, -exec sh -c, xargs
│   ├── git.adoc              # git discoveries (section 7, log tricks)
│   ├── virsh.adoc            # KVM/libvirt management
│   └── ...                   # Grows over time
├── system/
│   ├── arch-docs.adoc        # /usr/share/doc, /usr/share/info,
/usr/share/man
│   ├── zsh-completions.adoc  # Completion files as documentation
│   └── ...
├── workflow/
│   ├── claude-code.adoc      # Claude Code tips, config patterns
│   ├── antora.adoc           # Antora/AsciiDoc discoveries
│   └── ...
└── _index.adoc               # Master table: all discoveries, sortable by
 date/topic
    Pages (container shells)
    pages/discoveries/
├── index.adoc                # Shell → includes _index.adoc (master list)
├── tools.adoc                # Shell → includes all tools/*.adoc
├── system.adoc               # Shell → includes all system/*.adoc
└── workflow.adoc             # Shell → includes all workflow/*.adoc
    Nav entry

    • Knowledge Base

      • Discoveries

        • All Discoveries

        • Tools

        • System

        • Workflow

          Entry Format (Per Discovery)
          Each partial is a growing file — one file per tool/topic, entries appended
 chronologically:
          // w3m Discoveries
// Usage: include::partial$discoveries/tools/w3m.adoc[]
          == w3m
          === 2026-04-05: Man pages as HTML in terminal
          `man -Hcat` renders man pages as HTML. Pipe to w3m for hyperlinks and
proper formatting:
          [source,bash]
----
man -Hcat journalctl | w3m -T text/html
----
          Renders with clickable section links, proper tables, and navigation.
Better than default pager for deep reading sessions.
          **Worklog:** WRKLOG-2026-04-05
          === 2026-04-05: Kitty image support
          w3m on kitty can render inline images. Useful for Antora pages with
D2/Kroki diagrams:
          [source,bash]
----
w3m -version | grep image
# Should show: image in options list
----
          **Worklog:** WRKLOG-2026-04-05
          // Next discovery gets appended here
          Why This Format

  • One file per tool/topic — grows for years, stays navigable

  • Dated entries — temporal context without being buried in worklogs

  • Worklog link — traceability back to the session

  • Horizontal rule separator — clean visual separation

  • Append-only — never edit old entries, just add new ones below

    Graduation Rules
    Discoveries don't stay here forever:
    Trigger: Used 3+ times
Destination: partials/codex/
Action: Extract to quick-reference table, add xref back
────────────────────────────────────────
Trigger: Solves recurring problem
Destination: pages/patterns/
Action: Write full pattern entry (Problem → Context → Fix → Rule)
────────────────────────────────────────
Trigger: Becomes project-standard
Destination: partials/projects/*/appendix-commands-learned.adoc
Action: Copy to project scope
    When a discovery graduates, keep the original entry but add a note:
    === 2026-04-05: Man pages as HTML in terminal
    NOTE: Graduated to xref:codex/linux/man-pages.adoc[Codex: Man Pages]
    ...original content stays...
    Seed Content (Today's Discoveries)
    tools/w3m.adoc

  • Man pages as HTML: man -Hcat <cmd> | w3m -T text/html

  • Kitty image support: w3m -version | grep image

  • Reading local HTML docs: w3m /usr/share/doc/bash/bashref.html

  • w3m navigation keys (Space, b, Tab, Enter, /, q)

    tools/find.adoc

  • find -exec sh -c with _ {} pattern for multi-command execution

  • find . -type d -name 'claude' for directory search

  • find . -type d -name examples -exec sh -c 'echo "=== $1 ===" && ls -1 "$1"' _ {} \;

    tools/man.adoc

  • man -k '^git' | grep '(7)' — filter by section

  • man -k '^git' | awk '{print $1}' | sort -u | wc -l — count pages

  • Man section 5 = config file formats (man 5 sudoers, man 5 sshd_config)

    tools/pacman.adoc

  • pacman -Ss '^git' | grep -i doc — search for doc packages

  • pacman -Qi git | awk '/Optional/,/^$/' — show optional deps

  • pacman -Ql systemd | grep -E 'doc|example|share' — list installed files

  • pacman -Qo /path/to/file — who owns this file

  • pacman -Fi <filename> — search ALL packages (even uninstalled)

    tools/git.adoc

  • 241 git man pages on Arch

  • Section 7 = conceptual docs (gitdatamodel, gitrevisions, gitworkflows)

  • /usr/share/doc/git-doc/ does NOT exist on Arch (Debian/Fedora only)

    system/arch-docs.adoc

  • /usr/share/doc/ — 178 packages, HTML guides

  • /usr/share/man/ — 20,905 pages across 8 sections

  • /usr/share/info/ — 95+ GNU tutorial-style entries (deeper than man)

  • /usr/share/zsh/functions/Completion/Unix/ — 461 completion files

  • info coreutils — biggest untapped resource

  • Arch strips docs by default, some packages have -docs companions

    workflow/claude-code.adoc

  • Context configs: purpose-built CLAUDE.md files for different work modes

  • Community config collection in examples/claude/community/

  • Workshop partial for building/analyzing configs

    Files to Create
    ┌─────────────────────────────────────────────┬──────────┬────────────┐
│                    File                     │   Type   │  Content   │
├─────────────────────────────────────────────┼──────────┼────────────┤
│ partials/discoveries/tools/w3m.adoc         │ Partial  │ 4 entries  │
│                                             │          │ from today │
├─────────────────────────────────────────────┼──────────┼────────────┤
│ partials/discoveries/tools/find.adoc        │ Partial  │ 3 entries  │
│                                             │          │ from today │
├─────────────────────────────────────────────┼──────────┼────────────┤
│ partials/discoveries/tools/man.adoc         │ Partial  │ 3 entries  │
│                                             │          │ from today │
├─────────────────────────────────────────────┼──────────┼────────────┤
│ partials/discoveries/tools/pacman.adoc      │ Partial  │ 5 entries  │
│                                             │          │ from today │
├─────────────────────────────────────────────┼──────────┼────────────┤
│ partials/discoveries/tools/git.adoc         │ Partial  │ 3 entries  │
│                                             │          │ from today │
├─────────────────────────────────────────────┼──────────┼────────────┤
│ partials/discoveries/system/arch-docs.adoc  │ Partial  │ 6 entries  │
│                                             │          │ from today │
├─────────────────────────────────────────────┼──────────┼────────────┤
│ partials/discoveries/workflow/claude-code.a │ Partial  │ 3 entries  │
│ doc                                         │          │ from today │
├─────────────────────────────────────────────┼──────────┼────────────┤
│                                             │          │ Master     │
│ partials/discoveries/_index.adoc            │ Partial  │ table of   │
│                                             │          │ all discov │
│                                             │          │ eries      │
├─────────────────────────────────────────────┼──────────┼────────────┤
│ pages/discoveries/index.adoc                │ Containe │ Shell → _i │
│                                             │ r        │ ndex.adoc  │
├─────────────────────────────────────────────┼──────────┼────────────┤
│                                             │ Containe │ Shell →    │
│ pages/discoveries/tools.adoc                │ r        │ all tools  │
│                                             │          │ partials   │
├─────────────────────────────────────────────┼──────────┼────────────┤
│                                             │ Containe │ Shell →    │
│ pages/discoveries/system.adoc               │ r        │ all system │
│                                             │          │  partials  │
├─────────────────────────────────────────────┼──────────┼────────────┤
│                                             │          │ Shell →    │
│ pages/discoveries/workflow.adoc             │ Containe │ all        │
│                                             │ r        │ workflow   │
│                                             │          │ partials   │
├─────────────────────────────────────────────┼──────────┼────────────┤
│                                             │          │ Add Discov │
│ partials/nav/knowledge-base.adoc            │ Edit     │ eries      │
│                                             │          │ section    │
└─────────────────────────────────────────────┴──────────┴────────────┘
    Total: 12 new files + 1 nav edit
    Verification

  • make 2>&1 | grep -E 'WARN|ERROR' — zero warnings on new files

  • Nav xrefs resolve

  • Container pages are shells (header + includes)

  • All entries have dates and worklog links

  • Master index lists all discoveries with date, topic, one-line summary