[coisa]

Align the README with the actual package/CLI/configuration contract and the now verified published0.1.0 installation. Add source-backed badges, features, API summary, layout, versioning, FAQ and contribution guidance. Preserve check/fix/no-write/trust/cache limitations; no coverage site, metrics or stable-product claim is invented.

Closes #30.

This PR now targets main independently and contains only README.md plus its explicit PR34 patch fragment. The former skills33 dependency was unnecessary and has been removed through official unstack and a guarded ref update. No skills installation, image generation or Sphinx migration is inherited. The separate33 banner addition must be preserved when the two README edits are reconciled; after29 migrates docs, update current source links to the RST destinations rather than restoring deleted Markdown.

Verified baseline: published v0.1.0 and Composer source/distd28de6cd19733b9f34c781644c4fda899c6fe3b8. A fresh Composer consumer installed21runtime packages, actual installed binary check returned2 without source/lock writes, explicit fix0 then check0/fix0 was stable with lock unchanged. Read-only authoring skill reference is DevTools package-readme at84e154046e07cafa6ac09a9e12434b1ff5dcb5e0; it was never imported. Current native Changelog contribution check and local links/whitespace pass. Independent review approved the main-only candidate and real installation examples.

Current HEAD15a17b3e9cb35a1fc3bbbf5a3fa8e70875315b49, based on published main d28de6c. Previous2267a216 retained in codex/checkpoint-pr34-20261026 and a verified full-history local bundle; ref update was atomic with exact expected-OID leases. Current-head hosted CI and both external reviews still govern readiness. Publication remains the user's action.

[coderabbitai]

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 28 seconds.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

Run configuration

• Source mode: Auto
• Repository: Unavailable
• Branch: Unavailable
• File: No configuration file from this repository applied
• Commit: Unavailable
• Layers: Organization UI
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: d050a3eb-0809-4f16-940a-86b150ea7180

Commits

Reviewing files that changed from the base of the PR and between d28de6c and 15a17b3.

Files selected for processing: 2

• .changelog/package-readme.md
• README.md

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-10-26T22:15:52.758903Z	15a17b3	New commits
🔒 Security Review	✅ Completed 2026-10-26T22:14:34.372745Z	15a17b3	New commits

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[github-actions]

Changelog

✅ Contribution check passed.

Head: 15a17b3e9cb35a1fc3bbbf5a3fa8e70875315b49

Base: d28de6cd19733b9f34c781644c4fda899c6fe3b8

Contribution: 1 new valid fragment(s). Policy: ordinary.

• package-readme.md — changed, patch

  Organize the README around verified installation, commands, configuration, integration and compatibility, with source-backed badges, API summary and contributor guidance.