Raven MD

Two modes: create/update (default) and review — when the user asks for an assessment of an instructions file. In review mode follow the review procedure: five checks (length, code/config snippets, precision, redundant knowledge, ordering), a scorecard with path:line and Top 3 actions in chat, with no edits to the file except an approved reordering. Do not copy private global instructions into the repo.

Talk to the user in their language. Keep the language of the existing document; for a new one use the user's language. Title of a new AGENTS.md: # Repository Guidelines.

Both formats

Project instructions support AGENTS.md and CLAUDE.md together:

• AGENTS.md holds the shared content: project, commands, conventions, links. Other agents read it directly.
• CLAUDE.md next to it starts with the line @AGENTS.md, so Claude Code loads the same content. Below the import it may hold only Claude Code–specific additions (e.g. notes on skills, hooks or MCP); do not duplicate AGENTS.md content there.

Depending on the existing state:

• Neither file → create AGENTS.md and CLAUDE.md with the import.
• Only AGENTS.md → update it and add CLAUDE.md with the import.
• Only CLAUDE.md with content → keep it. Propose moving the shared content to AGENTS.md and leaving the import plus Claude-specific additions in CLAUDE.md; do the move after the user's consent, otherwise update CLAUDE.md in place.
• Both files → make sure CLAUDE.md imports AGENTS.md, and move content duplicated in CLAUDE.md into AGENTS.md without losing anything.