┌─────────────────────────────────────────────────────────────────┐
│  AI Client (Claude Code · Cursor · Custom GPT · Codex · Gemini) │
└──────────────────────────────┬──────────────────────────────────┘
                               │  MCP / SSE / Custom GPT Actions
                               ▼
┌──────────────────────────────────────────────────────────────────┐
│  PrePilot MCP Server                                             │
│  ─────────────────────────────────────────────────────────────── │
│   • Intent router    →  13 canonical workflows (paid, SEO, ...) │
│   • Skill catalog    →  1,040 skills mapped to taxonomy         │
│   • Swarm compiler   →  agents.py + manifest.json + workflow    │
│   • Engagement engine→  role → artifact → role → artifact ...   │
└──────────────────────────────┬──────────────────────────────────┘
                               │
                               ▼
┌──────────────────────────────────────────────────────────────────┐
│  Compiled Agent Runtime                                          │
│   • 1,700+ pre-built agents  (worker · coordinator · critic)     │
│   • 4 topology modes       (pipeline · parallel · hierarchical) │
│   • Append-only memory     (rules · episodes · agency data)     │
└──────────────────────────────────────────────────────────────────┘

git clone https://github.com/imMamdouhaboammar/PrePilot-oss.git
cd PrePilot-oss
pip install -e ".[dev]"

# Start the sample MCP server
python examples/mcp-server/server.py

# Wire it into Claude Code
claude mcp add prepilot-sample -- python examples/mcp-server/server.py

You: Launch a paid Meta campaign for my DTC skincare brand in Saudi.
PrePilot: I'll run the `launch_paid_ad_campaign` workflow.
           [step 1/6] audience research (geo-fundamentals + market-segments)
           [step 2/6] brand voice capture (brand-voice-guide)
           ...
           [step 6/6] ad creative generation (ad-copy + ad-creative-brief)
           ✓ Plan ready. Estimated cost: SAR 12,000.

PrePilot-oss/
├── README.md                       ← you are here
├── LICENSE                         ← MIT
├── CONTRIBUTING.md                 ← how to add your skill
├── CODE_OF_CONDUCT.md
├── docs/
│   ├── ARCHITECTURE.md             ← how PrePilot works end-to-end
│   ├── MCP_INTEGRATION.md          ← wire into Claude / Cursor / GPT
│   ├── SKILLS_GUIDE.md             ← anatomy of a skill
│   └── ROADMAP.md                  ← what's next
├── examples/
│   ├── mcp-server/                 ← runnable MCP server skeleton
│   ├── chatkit-widgets/            ← sample ChatKit widgets for GPT apps
│   └── skills/                     ← 25 sample skills (canonical taxonomy)
├── src/
│   └── compiled_agents/            ← 25 sample agents (worker + coordinator)
├── templates/
│   ├── SKILL.template.md
│   ├── WORKFLOW.template.md
│   ├── PROMPTS.template.md
│   ├── skill.yaml
│   ├── input.schema.json
│   └── output.schema.json
├── assets/
│   └── (logos, diagrams)
├── pyproject.toml
└── .github/                        ← issue templates + CI workflows