[pekral]

What this changes

Update mode brings an existing README to the README standard — header shape, section names and order — while keeping the author's prose and the existing logo. Scenario 5's invariant now expects that, instead of "only the outdated parts change".

Closes #25

Why

#25 recorded a conflict: scenario 5 allowed only outdated commands, links and versions to change, while SKILL.md and the README standard (#17) restructure the header and section names. The maintainer decided the standard wins.

• SKILL.md Update mode: fix what is outdated, unsupported, or duplicated, and bring the structure to the standard in references/readme-structure.md, keeping the author's prose and logo inside it.
• tests/scenarios.md scenario 5: the invariant now requires every outdated item fixed and the structure to follow the standard, with no section invented beyond what the repository evidences.

Checks

• node --test tests/repository.test.mjs passes
• node --test tests/evals/*.test.mjs passes
• CHANGELOG.md updated under the current unreleased heading
• A rule changed in SKILL.md is changed everywhere it appears in references/ — no reference restated the old "only what is outdated" rule
• Behaviour changes exercised against the affected scenario, and the run recorded in its host coverage log — scenario 5 re-run passes

Claims this adds to the documentation

• Scenario 5 passes under Claude Code 2.1.322: the logo and the author's paragraph survive verbatim, all five stale items are fixed, the header and sections follow the standard and each is backed by the repository, and only README.md changed. The quick start's colour values were computed by the agent from the code; spot-checked by hand (#336699 → #668cb3 at the second step).