docs(skills): teach the shipped skills the bundle command and the prime engine

[drewstone]

What

The README and docs/trace-analysts.md document traces bundle and --analyzer prime. The two skills this package ships did not, and those are what an agent reads.

skills/inspect-agent-traces gains the bundle: when to write one, what it holds, that it spends no model call, and the two failure rules (a missing transcript stops the assembly; an absent optional input is recorded in manifest.absent).

It also carries a warning measured this week: a bundle holds the whole session transcript, so it must not be given to a writer that has to stay blind to an earlier conclusion. A live run found 52% of one report's substantive lines recoverable verbatim from the transcript of the session that wrote it, including the authoring call itself. Checking that the file is absent is not enough.

skills/build-trace-analyst gains the two shipped engines as comparison arms, with the distinction that matters when reading a result: prime inlines the whole span projection into one prompt, while HALO and Hodoscope drill with paged tools. Comparing an inline arm with a paged arm separates the prompt from the navigation.

It also gains the served-model rule. A gateway can answer one id with another model — measured this week — so a panel can report families it never ran. assertServedModel and assertCrossFamilyServed must run before any per-model or cross-family number is trusted.

Proof

pnpm test 644 passed (49 files) · check:source ok · check:package ok (ships dist/cli.js and 2 agent skills) · build clean.

[tangletools]

✅ Auto-approved drewstone PR — ace0cd65

This PR was opened by the trusted drewstone account.
The full PR reviewer audit still runs separately and will publish findings if it detects issues.

_{tangletools · auto-approval · reason: drewstone_author · 2026-08-09T23:21:25Z}