Need AI Training/Help?CloudYeti.io/meet
MarkdownMe
Agent instruction guide

Review CLAUDE.md Before Converting to AGENTS.md

Clean a CLAUDE.md first, then convert it into AGENTS.md, Cursor rules, GitHub Copilot instructions, or Windsurf rules.

Direct answer

Before converting CLAUDE.md to AGENTS.md or other agent formats, review the source file for vague rules, missing commands, repo boundaries, contradictions, and token waste. A converter can change the format, but it cannot make weak source instructions strong. Clean the source first, then generate the target agent config.

Open CLAUDE.md Reviewer

When to use this

  • You want one repo instruction source for Claude Code, Codex, Cursor, Copilot, or Windsurf.
  • The current CLAUDE.md was generated quickly and never reviewed.
  • The target agent needs shorter, more imperative rules.

Steps

  1. Review the CLAUDE.md and apply concrete fixes.
  2. Remove prose that does not affect agent behavior.
  3. Keep commands, boundaries, and do-not-do rules.
  4. Open the CLAUDE.md Converter.
  5. Generate AGENTS.md, Cursor rules, Copilot instructions, or Windsurf rules from the cleaned source.

Example review focus

CLAUDE.md excerpt
# CLAUDE.md

## Scope
- Use apply_patch for edits.
- Run tests before final.

## Commands
- npm run build
- npm run test

Need this to work for Codex, Cursor, and Copilot too.
What to fix
Review first: add missing lint/typecheck commands, clarify when tests are required, and remove vague notes. Then convert the cleaned file to AGENTS.md or Cursor rules so the weaker parts do not spread into every agent config.

Common mistakes

  • Do not convert a messy source file into five messy agent configs.
  • Do not use one format's quirks as rules for every agent.
  • Do not drop commands while making Cursor or Windsurf rules shorter.

FAQ

Should I review before converting?
Yes. Reviewing first prevents vague or stale instructions from spreading across every agent configuration file.
Can AGENTS.md use the same content as CLAUDE.md?
Often yes, but the preamble and emphasis may differ. Keep the concrete commands and behavior rules, then adapt the format.
What should I convert after review?
Generate AGENTS.md for Codex-style agents, Cursor rules for Cursor, Copilot instructions for GitHub Copilot, and Windsurf rules when needed.

Related CLAUDE.md guides

Review CLAUDE.md for Token Waste

Find vague, repeated, or unused CLAUDE.md instructions that cost tokens every Claude Code turn without improving behavior.

CLAUDE.md Missing Commands Checklist

Check whether a CLAUDE.md includes the build, test, lint, dev server, deploy, and verification commands an agent needs before editing.

CLAUDE.md Repo Boundaries and Rules

Write CLAUDE.md rules that tell agents which files to edit, which files to avoid, and how to handle dirty worktrees safely.