Make Agent Friendly

A Claude Code plugin that prepares human-developed codebases for agentic development.

What It Does

When you fork a repository or inherit a codebase built by humans, this plugin guides Claude through a systematic process to make it agent-friendly:

• Analyzes the current repository structure
• Asks clarifying questions about your intended workflow
• Restructures folders and files for agent navigability
• Creates CLAUDE.md and /context/ infrastructure
• Updates documentation for agentic development
• Validates changes don't break existing functionality

Installation

Via Plugin Marketplace

If you have the danielrosehill marketplace configured:

/plugin install make-agent-friendly@danielrosehill

Manual Plugin Installation

Clone and add as a local plugin:

git clone https://github.com/danielrosehill/Make-Agent-Friendly.git
/plugin marketplace add ./Make-Agent-Friendly
/plugin install make-agent-friendly

Legacy Slash Command (Deprecated)

For backwards compatibility, you can still copy just the command file:

mkdir -p ~/.claude/commands
curl -o ~/.claude/commands/make-agent-friendly.md \
  https://raw.githubusercontent.com/danielrosehill/Make-Agent-Friendly/main/commands/make-agent-friendly.md

Usage

1. Navigate to the repository you want to prepare for agentic development
2. Start Claude Code
3. Run the command:

/make-agent-friendly

Claude will:

1. Analyze your codebase
2. Ask you a series of intake questions
3. Work through a structured checklist to prepare the repository
4. Create necessary infrastructure (CLAUDE.md, /context/, etc.)
5. Validate changes before committing

What Gets Created

After running the command, your repository will typically include:

your-repo/
├── CLAUDE.md              # Project context for AI agents
├── context/               # External docs, API refs, MCP notes
│   └── ...
├── planning/              # (Optional) Decision records, discussions
│   └── ...
├── app/ or src/           # Application code (if reorganized)
│   └── ...
└── README.md              # Updated with agentic workflow notes

The Agentic Development Model

This plugin prepares repositories for human-guided agentic development:

• Human: Controls planning, provides instructions, supervises
• Agent: Executes code changes, suggests improvements, navigates codebase

The goal is clear separation of concerns and maximum agent efficiency.

Plugin Structure

Make-Agent-Friendly/
├── .claude-plugin/
│   └── plugin.json        # Plugin metadata
├── commands/
│   └── make-agent-friendly.md
├── foundational.md        # Detailed guidance reference
└── README.md

Customization

Fork this repository and modify:

• commands/make-agent-friendly.md - The main command prompt
• foundational.md - Reference documentation for the approach
• .claude-plugin/plugin.json - Plugin metadata

Reference

See foundational.md for the detailed guidance document this command is based on.

License

MIT