README for documents

Human-consumption documents live here.

The LLM does not load these files as project rules.

Index

00-pattern-of-interaction.md — how to work with an LLM: work items, episodes, async, and review.
01-async-worktree.md — worked example: run the LLM in its own git worktree and merge when the episode settles.
02-tool-universe.md — a survey of LLM tools through the async and attention lens.
03-conversation-summary.md — a summary of the conversation that produced these documents.
04-lessons-from-homelab.md — lessons from the first real application of the skeleton.
05-lessons-from-MI25.md — lessons from the MI25 fan-service project.
06-project-pages.md — project-pages publishing conventions (summary; canonical version in the homelab).
07-appimage-format.md — the AppImage specification, payload offset algorithm, and SquashFS superblock.
08-desktop-entry-format.md — the *.desktop format: groups, keys, values, locales, actions, and Exec.
09-desktop-file-search-paths.md — where GNOME looks for *.desktop files, and the observed host values.
10-appimage-desktop-integration.md — best practice for using and integrating an AppImage, and what integration writes.
11-desktop-entry-parameters.md — every desktop entry parameter, what it does, and how to inspect it.
12-desktop-loading-and-provenance.md — how to discover where applications, icons, and parameters are loaded from.

The following filenames are canonical and must not be renamed or duplicated without an explicit task: