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-prompt-maturity.md — the 0–3 maturity rubric for the prompt protocol, and how to score it.

Canonical Files

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

• 00-pattern-of-interaction.md
• 01-async-worktree.md
• 02-tool-universe.md
• 03-conversation-summary.md
• 04-lessons-from-homelab.md
• 05-lessons-from-MI25.md
• 06-project-pages.md
• 07-prompt-maturity.md

How this project does it

• 08-pkpass-format.md — the Apple Wallet .pkpass format: the container, pass.json, the field model, the colours, the barcode formats, localization, and what this project does and does not yet do with them.
• 09-mime-type-association.md — how a Linux desktop resolves a file type to an application, and exactly what this project writes to handle the two Wallet types.
• 10-pkpass-knowns-and-unknowns.md — what is documented, observed, and only conventional about the format, what is genuinely unknown, and which decisions this project made where the format is silent.
• Documents 00 through 07 are the skeleton’s, kept as they are.