Intent Layer Clean

Remove the Intent Layer infrastructure from a repository completely.

When to Use

• •Removing Intent Layer from a project entirely
• •Starting fresh after Intent Layer has drifted beyond repair
• •Cleaning up before a major architectural overhaul
• •Removing experimental Intent Layer setup

Process

1. Find All Intent Layer Files

# Find child AGENTS.md files (excluding root)
find . -name "AGENTS.md" -not -path "./AGENTS.md" -type f 2>/dev/null

# Check for root AGENTS.md symlink
ls -la ./AGENTS.md 2>/dev/null

2. Detect Intent Layer Section in Root

Check if CLAUDE.md has an Intent Layer section:

grep -n "^## Intent Layer" ./CLAUDE.md 2>/dev/null

3. Show What Will Be Changed

Present the full scope to the user:

## Intent Layer Removal Plan

### Files to Delete
| Path | Size |
|------|------|
| src/api/AGENTS.md | 2.1k |
| src/core/AGENTS.md | 1.8k |
| ./AGENTS.md (symlink) | - |

### Root CLAUDE.md Changes
- Remove "## Intent Layer" section (lines 45-89)

**Preserved:** ./CLAUDE.md (without Intent Layer section)

Total: 3 files deleted, 1 section removed

4. Confirm with User

Ask: "Remove Intent Layer completely? This will delete X files and remove the Intent Layer section from CLAUDE.md."

• •If user confirms: proceed
• •If user declines: abort

5. Execute Removal

Delete Child AGENTS.md Files

rm [path/to/AGENTS.md]

Remove Root AGENTS.md Symlink (if exists)

rm ./AGENTS.md  # Only if it's a symlink to CLAUDE.md

Remove Intent Layer Section from CLAUDE.md

Remove the ## Intent Layer section and everything until the next ## heading (or end of file).

Pattern to match and remove:

• •Starts with ## Intent Layer (with optional text after)
• •Ends at next ## heading or EOF
• •Include any blank lines before the next section

6. Report Results

## Intent Layer Removed

### Deleted Files
- src/api/AGENTS.md
- src/core/AGENTS.md
- ./AGENTS.md (symlink)

### Modified Files
- ./CLAUDE.md (Intent Layer section removed)

To restore Intent Layer: /intent-layer

Safety

• •Root CLAUDE.md preserved - Only the Intent Layer section is removed, other content stays
• •Requires confirmation - Shows full plan before any changes
• •Section detection - Only removes if ## Intent Layer heading exists
• •Symlink-aware - Only removes root AGENTS.md if it's a symlink

What Happens

Edge Cases

No Intent Layer Section in CLAUDE.md

If the root has no ## Intent Layer section, skip that step and only delete AGENTS.md files.

No Child AGENTS.md Files

If no child files exist, only remove the section from CLAUDE.md.

AGENTS.md is Not a Symlink

If root AGENTS.md is a real file (not symlink), warn user and ask whether to delete it.

Output

Confirmation of all deleted files and modified sections, with reminder of how to restore.