Skip to content

docs: write every README with the readme-generator skill - #2

Merged
eskokoivula merged 2 commits into
mainfrom
docs/readme-rule
Oct 13, 2026
Merged

eskokoivula merged 2 commits into
mainfrom
docs/readme-rule

Conversation

@eskokoivula

Copy link
Copy Markdown
Contributor

What and why

Makes the readme-generator skill the organization's README rule. Every README.md is written with
the skill, in its sections for the project type plus the template's five (Run it locally, Deploy,
Media and large files, First-time setup, Owner). Every command is run before it goes in, and Codex
reviews the README before main.

  • CONTRIBUTING.md: a new README section; step 3 of "New repositories" points to it.
  • src/agents-block.md and this repository's AGENTS.md copy: one README bullet.
  • DECISIONS.md: the decision, dated 2026-10-13.
  • README.md: rewritten with the skill. It now says that CI runs the current check from this
    repository's main, while the hooks run each repository's copy.

BuildexLabsAI/repo-template gets the same block in its own pull request. Merge this one first, so
repo-template's drift check compares against the new block.

How it was tested

  • bash tests/check-standard.test.sh: 59 passed, 0 failed.
  • bash .github/scripts/check-standard.sh and bash src/check-standard.sh --canonical src: OK, 0 warnings.
  • Every command in README.md was run from fresh clones named .github and repo-template, side
    by side. The block-update commands turned repo-template's drift warning into 0 warnings.
  • Review: an independent Claude agent, on the owner's call instead of Codex this time. It reviewed
    the whole change twice; the second round found no blocking issue.

Checklist

  • The title follows Conventional Commits, e.g. feat(api): add athlete height endpoint
  • No secrets, media or files over 5 MB
  • README.md and AGENTS.md still match how to install, run and test
  • DECISIONS.md has a line for any decision made here

🤖 Generated with Claude Code

eskokoivula and others added 2 commits October 13, 2026 13:34
README.md is written with the readme-generator skill, in its sections for
the project type plus the template's five; every command is run first and
Codex reviews it before main. CONTRIBUTING.md gets a README section, the
agents block and this repository's copy get one bullet, DECISIONS.md the
decision. README.md is rewritten with the skill and now says that CI runs
the current check from main, while the hooks run each repository's copy.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@eskokoivula
eskokoivula merged commit 33f9626 into main Oct 13, 2026
2 checks passed
@eskokoivula
eskokoivula deleted the docs/readme-rule branch October 13, 2026 10:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant