FAQ & troubleshooting

Which file should I generate — AGENTS.md, CLAUDE.md or .cursorrules?

Whatever your assistant reads: AGENTS.md (the emerging cross-tool standard), CLAUDE.md (Claude Code), or .cursorrules (Cursor). You can generate more than one — run init once per --target.

Does re-running overwrite my file?

Yes — init overwrites the target. Keep any project-specific rules in a separate file or a clearly-marked block you re-append, so they survive regeneration.

How do I add project-specific rules?

Generate the base file, then append your repo's specifics (architecture, commands, conventions) below the generated sections. Or add a new pack — see Writing your own pack.

Can I use just some packs?

Yes: --packs core,testing. Run agent-rules-kit list to see them all; --packs all (the default) includes everything.

Does it need to be installed?

No — npx agent-rules-kit ... works without installing. You can also add it as a dev dependency and script it.

The rules are opinionated — can I disagree?

Absolutely; they're plain markdown in rules/. Fork, edit, or open a PR. The goal is a sane default, not dogma.