init-override
Create a symlink from AGENTS.md to CLAUDE.md in the current project directory, then optionally run /init and sanitise the output.
Instructions
-
Check if
CLAUDE.mdalready exists in the current working directory- If it exists and is a symlink pointing to AGENTS.md, inform the user it's already configured and skip to step 4
- If it exists and is a regular file, warn the user and ask if they want to replace it
-
Create
AGENTS.mdif it doesn't exist, using the template below -
Create the symlink:
ln -s AGENTS.md CLAUDE.md -
Ask the user if they want to run
/initto auto-discover project settings- If yes, run
/initand then proceed to step 5 - If no, confirm success and finish
- If yes, run
-
Sanitise the AGENTS.md file by removing or replacing:
- Any line containing "Claude Code" or "claude.ai"
- References to
CLAUDE.md(replace withAGENTS.md) - References to
.claude/paths - The boilerplate phrase "This file provides guidance to Claude Code"
- Replace "Claude" with "AI agents" where it refers to the assistant
-
Ensure the file header is
# AGENTS.md(not# CLAUDE.mdor# Project guidance) -
Confirm success and show the user the sanitised content
AGENTS.md template
Use this content when creating a new AGENTS.md file (before /init runs):
# AGENTS.md
This file provides guidance for AI agents working with code in this repository.