Maverick

My personal AI coding configuration with MCPs, skills, commands, and workflows for Claude Code and Codex.

Structure

maverick/
├── claude/                   # Claude Code configuration assets
│   ├── mcp-servers/          # Claude MCP server JSON snippets
│   │   ├── global.json       # Global MCPs (serena, figma)
│   │   └── project.json      # Per-project MCPs
│   ├── skills/               # Claude Code custom skills
│   │   └── maverick/
│   │       └── SKILL.md
│   ├── commands/             # Claude Code slash commands
│   │   ├── maverick.md
│   │   ├── maverick-single.md
│   │   ├── review-resolver.md
│   │   ├── senior-architect.md
│   │   ├── senior-frontend.md
│   │   ├── senior-backend.md
│   │   ├── senior-security.md
│   │   └── senior-qa.md
│   └── templates/
│       └── linear-figma.md
├── codex/                    # Codex configuration assets
│   ├── AGENTS.md             # Project instruction template
│   ├── config/
│   │   └── config.toml.example
│   └── skills/
│       └── maverick/
│           └── SKILL.md
├── setup.sh                  # Claude Code/Codex installation script
└── test_setup.sh             # Test suite for setup scripts

MCP Servers

Global

• serena - Intelligent code agent
• figma - Figma integration (design)

Per Project

• linear - Linear integration (tasks)
• github - GitHub API (PRs, issues, repos)
• chrome-devtools - Chrome DevTools
• basic-memory - Persistent memory

Installation

Claude Code

./setup.sh claude

Codex

./setup.sh codex

This installs the Maverick skill into ~/.codex/skills/maverick, creates ~/.codex/config.toml if needed, and points you to the MCP snippets in codex/config/config.toml.example.

To install both:

./setup.sh all

Running ./setup.sh without arguments opens an interactive selector.

For each project that should use Maverick with Codex:

cp codex/AGENTS.md /path/to/your/project/AGENTS.md

Manual Claude Code Setup

1. Copy global MCPs:

# Add to your ~/.claude/settings.json under "mcpServers"
cat claude/mcp-servers/global.json

2. For specific projects, add to project settings:

cat claude/mcp-servers/project.json

3. Copy the project instruction template:

cp claude/templates/linear-figma.md /path/to/your/project/CLAUDE.md

Manual Codex Setup

1. Copy the Codex skill:

mkdir -p ~/.codex/skills
cp -r codex/skills/maverick ~/.codex/skills/

2. Copy or merge the MCP snippets you need:

cat codex/config/config.toml.example

3. Copy the project guide:

cp codex/AGENTS.md /path/to/your/project/AGENTS.md

MCPs Used

MCP	Type	Use
Figma	HTTP	Design to code
Linear	HTTP	Task management
GitHub	stdio	GitHub API (PRs, issues, repos)
Serena	stdio	Code agent
Chrome DevTools	stdio	Browser debugging
Basic Memory	stdio	Persistent memory

Skills & Commands

Maverick - Autonomous Development

Maverick is a workflow that coordinates senior agents to complete tasks end-to-end. Works with Linear tickets or standalone local tasks.

# Single Linear ticket
/maverick AP-552

# Multiple Linear tickets (parallel worktrees)
/maverick AP-552,AP-553,AP-554

# Local mode - no Linear needed
/maverick --local "Add dark mode toggle to settings page"

# Multiple local tasks
/maverick --local "Fix login validation" "Add loading spinner"

Flow

Senior Agents

Command	Description
/senior-architect	Architectural analysis and system design
/senior-frontend	React/Next.js frontend development
/senior-backend	Go/microservices development
/senior-security	Vulnerability scanning, dependency audit, secrets detection
/senior-qa	Testing, visual QA (Figma + Chrome DevTools)

Review Tools

Command	Description
/review-resolver	Interactive PR review comment handler with regression protection

Installing Commands

For Claude Code, copy the claude/commands/ and claude/skills/ folders to your project's .claude/:

cp -r claude/commands/ /path/to/project/.claude/
cp -r claude/skills/ /path/to/project/.claude/

For Codex, install the skill globally and add AGENTS.md to each project:

./setup.sh codex
cp codex/AGENTS.md /path/to/project/AGENTS.md

Critical Rules

No Regressions Policy

All agents follow a strict NO REGRESSIONS policy:

1. Never remove or modify existing functionality without explicit user authorization
2. Always preserve existing tests - never delete or skip tests
3. Review changes for side effects - check if changes affect other parts of the codebase
4. QA phase must verify - no regressions in existing features before delivery
5. When in doubt, ask - if a change might cause regression, stop and ask for authorization

Before Any Delivery

The QA phase includes mandatory regression checks:

• Run existing test suites
• Verify unchanged functionality still works
• Check for unintended side effects
• Compare before/after behavior

Ralph Loop (Plugin)

Maverick works best with the ralph-loop plugin for autonomous execution:

/ralph-loop:ralph-loop "/maverick AP-552" --max-iterations 30 --completion-promise "MAVERICK_COMPLETE"

The plugin is available in the official Claude Code marketplace.

Requirements

• Claude Code CLI installed for Claude setup
• Codex CLI installed for Codex setup
• Node.js (for stdio MCPs)
• Python/uvx (for serena and basic-memory)

License

MIT