motspilot
A 6-phase AI pipeline for shipping features into existing codebases — without the "the agent confidently broke prod" failure mode.
Each phase has a hard-constraint block the AI reads before any creative work, every verification finding quotes file:line evidence from your code, and a multi-model consensus (Claude + GPT-4o + Gemini) runs before the first design decision. Ships as a Claude Code plugin.
What you write: a 2–3 line feature description.
What it produces: consensus synthesis → architecture plan with blast-radius analysis → code → tests (security-first) → verification report with confidence-scored findings → executed smoke tests → deployment plan. Each artifact is a file in your repo, so the full decision trail is committable.
See it before installing: docs/example-task/ walks through one feature end-to-end — every artifact from requirements through delivery, including the consensus synthesis, an architecture decomposition, a verification finding with file:line evidence, and executed smoke tests with side-effect checks.
motspilot is built for engineers integrating into production codebases — not for greenfield prototyping. If your codebase is younger than its first incident, a single-model agent is probably fine.
How It Works
Two components:
-
motspilot.sh — Shell utility. Manages named tasks, requirements, state, and artifacts. Does not invoke AI directly.
-
Claude Code — The AI orchestrator. Reads the work order and runs each phase as a Task subagent. You approve each phase before it proceeds. Tasks auto-archive on completion.
Claude Code is the engine. motspilot.sh is the filing system.
Requirements
- Claude Code — the AI orchestrator that runs the pipeline phases
- Bash 4.0+ — the shell script uses associative arrays
- Linux: you almost certainly have bash 4+ already
- macOS: ships with bash 3.2 — install a newer version with
brew install bash
- Windows: use Git Bash, WSL, or any bash 4+ environment
yq v4.52+ — parses YAML frontmatter from phase prompts
- Install:
wget https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 -O ~/.local/bin/yq && chmod +x ~/.local/bin/yq
- macOS:
brew install yq
Installation
As a Claude Code Plugin (recommended)
From any Claude Code session:
/plugin marketplace add motsmanish/motspilot
/plugin install mots
Then in your target project:
/mots:init # One-time setup
/mots:pilot add login throttling # Run the pipeline
/mots:status # Check progress
/mots:view verify # Read verification report
/mots:archive --task=add-login-throttling # Archive when done
Requires: WSL, macOS, or Linux (bash). Consensus phase optionally requires PHP 8+ and API keys for Claude, GPT-4o, and Gemini.
Clone (for development/contribution)
git clone https://github.com/motsmanish/motspilot.git
See CONTRIBUTING.md for development setup. Alternative integration methods (symlink, submodule) are documented there.
Quick Start
# 1. Initialize (first time only)
./motspilot/motspilot.sh init
# Edit .motspilot/config with your project's language, framework, and test command
# 2. Create a task and prepare the pipeline
./motspilot/motspilot.sh go --task=csv-export "Add CSV export to the reports page"
# 3. In Claude Code chat:
run motspilot pipeline
Claude Code orchestrates all 6 phases (consensus → architecture → development → testing → verification → delivery) and archives the task automatically when delivery is approved. By default, phases run without pausing (AUTO_APPROVE="all"). Set AUTO_APPROVE="none" in .motspilot/config to approve each phase before it proceeds.
Framework Support
motspilot works with any framework. Framework-specific knowledge lives in prompts/frameworks/:
| Guide | Framework | Status |
|---|
cakephp.md | CakePHP 4.x | Shipped |
plain-php.md | Plain PHP (no framework) | Shipped |
laravel.md | Laravel 11.x+ | Shipped |
