V-Songbird Coordinate plugin READMEs
This skill coordinates Claude/Codex edition pages and their shared main overview. Main retains the shared product story, branding, animation, benefits, mechanism, usage examples and general limitations, with a clear edition choice. Keep native install commands, compatibility details and measured tables in their editions. Use scripts/build-main-readmes.js to regenerate common content and validate main with check-main-frontpage.js --claude-ref Claude --codex-ref Codex. Common edition changes also update main before release. Flint is excluded from this main policy.
Locate both platform checkouts before editing. Use git worktree list or inspect
the other branch read-only; preserve uncommitted work and stay off main.
This is a Foundry development skill, not a skill shipped inside each plugin.
Use the same product narrative, headings, section order, common outcomes and
decorative branding in both editions. Read the current Foundry README template
and readme-parity rule. Preserve only the six named exception blocks:
identity, install, commands, compatibility, benchmarks, links.
Each difference needs a real platform or edition reason. Do not hide a rewrite
of the shared product story inside an exception or remove a supported feature
just because the other edition lacks it; identify that availability difference.
Use the same questions and table columns for benchmarks. Check original evidence
for the actual host, model, comparison, source date and metric. Keep limitations
and negative results. A benchmark's source date is distinct from the day someone
reviewed it. Never relabel another host's measurements or turn functional tests
into performance claims. Keep the table and mark missing values Not measured.
Paid runs and installs need their own authorization; an evidence gap is not it.
Run Foundry's scripts/git-hooks/check-readme-parity.js --pair <Claude-README> <Codex-README> and the README navigation check. For a committed pair, use
--git-pair <plugin-repo> <Claude-ref> <Codex-ref>. Each plugin also carries the
single-edition checker. Review benchmark sources independently of the parser;
passing a structural check does not establish experimental validity.
Report the common change, the justified exceptions, the exact pair checked and
any missing evidence. Carry shared edits to both working copies. Do not commit,
push or change repository protection settings unless that action is authorized.
For coordinated PRs, follow Foundry's .github/README_COORDINATION.md (also
present in each edition). Declare the opposite PR number and full head SHA in
both descriptions; rerun both checks after any head change. Candidate-pair
success is separate from the final integrated-branch comparison. Do not publish
selectors or pins until the integrated pair passes.
Apply the approved Ember art direction in docs/shared/launch/tinta-y-oficio.md. Match the name pill and decorative README accents to Hush blue, Foreman green and Razor red in both themes; preserve semantic data colors, original text and benchmark evidence.
Use the approved C layout in .github/PLUGIN_README_TEMPLATE.md: example-led introduction with mascot, benefits, mechanism, practical usage, installation, limits, evidence, references and license. Do not duplicate the promise in a TL;DR. Put measured graphics with evidence. Main keeps the shared story and offers an edition choice.