book-compilerlisted

# Book Compiler A book is written to be **read**. A skill is written to be **run**. The job is to convert one into the other, so that every method the book teaches becomes something the agent does — with a trigger, a diagnostic, an action, and a check. Two rules bind the whole build: - **Provenance** — every runtime rule traces to a source unit or is labeled an adaptation. Facts, numbers, and uncertainty survive; nothing invented is presented as sourced. - **Theatre** — file counts, chapter titles, unrun model claims, and green exit codes are not evidence of work. Claim only what you inspected. `$ARGUMENTS` holds source paths, an existing-skill path, or scope instructions. ## Modes The build runs at one of three depths. Pick the shallowest that meets the user's real goal: the full pipeline exists for skills that will be *distributed*, and forcing it on someone who only wants a book's method for their own use is wasted work. - **map** — inventory the source and build the source-method map, then stop and show it. Answers "what's in here, and is it worth building?" (Phases 1–3.) - **draft** — map, then write a working skill with a few smoke evals and a structural validation. The default: it produces something installable and usable today. (Phases 1–6, plus a light Phase 8 and Phase 9.) - **ship** — draft plus the full source-fidelity audit, the four-layer regression suite, and the packaging gate. For a skill going to other people. (All phases.) Before the