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.

What Should Go in a CLAUDE.md File

Decide what belongs in CLAUDE.md and what belongs in the README, a path-scoped rule, or a skill. One test per line, applied to a real file.

Claude Code Is Not Following CLAUDE.md — How to Fix It

Diagnose why Claude Code ignores your CLAUDE.md: the file never loaded, the rule is vague, two files contradict, or the rule needs a hook instead.

CLAUDE.md vs .claude/rules vs Skills — Which File Owns What

Route each instruction to the right file: always-loaded CLAUDE.md, path-scoped .claude/rules/, or on-demand skills. One question decides it.

CLAUDE.md Best Practices Checklist — Audit Your File Against 8 Rules

Run your CLAUDE.md through eight checks: size, specificity, exact commands, anti-patterns, structure, contradictions, enforcement, and staleness.

Desk gear for long writing sessions

A few things that help if you write docs, tickets, and specs on a laptop all day.

Dock

Anker 5-in-1 USB-C Hub

One cable turns a laptop into a desk setup. Drives a 4K display, charges at up to 85W, and adds three data ports.

  • 4K HDMI output
  • 85W max power delivery
  • 1x USB-C + 2x USB-A, 5Gbps each
  • MacBook Pro, MacBook Air, Dell
Check price on Amazon →Monitor · I use this

Dell 27" S2725QC 4K

The monitor I write and review documents on. 163 PPI keeps small text sharp, and USB-C carries video and power on one cable.

  • 3840x2160 IPS, 163 PPI
  • 120Hz, 4ms, FreeSync Premium
  • 99% sRGB
  • USB-C, HDMI, DisplayPort
Check price on Amazon →Laptop

Apple MacBook Neo 13" (A18 Pro)

The cheapest way into an Apple-silicon machine that runs local models. Fanless, and the Liquid Retina panel holds small text at a full day of reading.

  • A18 Pro chip, built for Apple Intelligence
  • 8GB unified memory, 256GB SSD
  • 13-inch Liquid Retina display
  • 1080p FaceTime HD camera
Check price on Amazon →

Amazon affiliate links. We earn a commission on qualifying purchases at no extra cost to you.