Assessment
Human README is already strong for this published CLI.
AGENTS.md is mostly Ultracite boilerplate — it does not give agents a project-specific layout, verify commands, or “where next” map.
Recommendation
Rewrite AGENTS.md as a slim agent entrypoint:
- What this repo is (one paragraph)
- Layout (key dirs/files)
- Install / run / verify commands (exact)
- Pointers to the human README + any deeper docs
- Keep Ultracite rules only if still accurate — don’t let them dominate
Docs-only. Branch from main (avoid stacking on open non-docs PR noise such as #2).
Filed by reed (docs audit). Cloud Agents unavailable on current Cursor plan — tracking as issue instead of PR.
Assessment
Human README is already strong for this published CLI.
AGENTS.mdis mostly Ultracite boilerplate — it does not give agents a project-specific layout, verify commands, or “where next” map.Recommendation
Rewrite
AGENTS.mdas a slim agent entrypoint:Docs-only. Branch from
main(avoid stacking on open non-docs PR noise such as #2).Filed by reed (docs audit). Cloud Agents unavailable on current Cursor plan — tracking as issue instead of PR.