---

name: init-override description: Create a symlink from AGENTS.md to CLAUDE.md in the current project directory. Use when the user wants to initialise a project to use AGENTS.md as the memory file instead of CLAUDE.md.

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

1. Check if CLAUDE.md already 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

2. Create AGENTS.md if it doesn't exist, using the template below

3. Create the symlink: ln -s AGENTS.md CLAUDE.md

4. Ask the user if they want to run /init to auto-discover project settings

   • If yes, run /init and then proceed to step 5
   • If no, confirm success and finish

5. Sanitise the AGENTS.md file by removing or replacing:

   • Any line containing "Claude Code" or "claude.ai"
   • References to CLAUDE.md (replace with AGENTS.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

6. Ensure the file header is # AGENTS.md (not # CLAUDE.md or # Project guidance)

7. 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):

Copy# AGENTS.md

This file provides guidance for AI agents working with code in this repository.