maggy
Turn Claude Code into a self-reviewing, test-enforced engineering system that remembers context across sessions — then route work across 13 models from a single dashboard.
Turn Claude Code into a self-reviewing, test-enforced engineering system that remembers context across sessions — then route work across 13 models from a single dashboard.
$ npx -y skills add alinaqi/claude-bootstrap --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Repo: alinaqi/claude-bootstrap
What's inside
Turn Claude Code into a self-reviewing, test-enforced engineering system that remembers context across sessions — then route work across 13 models from a single dashboard.
Claude Bootstrap is an installable config pack (skills, hooks, rules, templates) for Claude Code. Maggy is the optional local server that adds multi-model routing, a web dashboard, intent-driven protocols, and plugin orchestration. Both live in this repo. Start with Bootstrap; add Maggy when you need the harness.
1100+ tests. 67 skills. 15 MCP tools. Used daily across production codebases.
| Claude Bootstrap | Maggy Harness | |
|---|---|---|
| What it is | Skills, hooks, rules installed into ~/.claude/ | Local FastAPI server + web dashboard |
| Install time | ~30 seconds | ~5 minutes (Python 3.11+, API keys) |
| Requires | Claude Code (also works with Codex, Kimi, Gemini CLI) | Everything in Bootstrap + Python + optional Docker |
| You get | TDD enforcement, 67 skills, quality gates, ADR reviews, iCPG, Mnemos memory | All of Bootstrap + 13-tier routing, skill protocols, Telos testing, Cortex MCP, plugins, dashboard |
git clone https://github.com/alinaqi/maggy.git
cd maggy && ./install.sh
Your next Claude Code session picks it up automatically.
pipx install maggy-harness # or: pip install maggy-harness
maggy bootstrap # installs skills, hooks, ~/bin model wrappers, plugins
maggy serve # auto-configures from your local repos,
# then opens the dashboard at localhost:8080
(or from source: cd maggy && ./install.sh && maggy serve)
No API keys required to start — Maggy runs in local mode and, on first launch,
discovers your local git repos and opens the dashboard pointed at them. Add
GITHUB_TOKEN / ANTHROPIC_API_KEY later only if you want GitHub sync or
API-model features. See GETTING_STARTED.md for details.
Routing a task:
You: "review the auth middleware for timing attacks"
→ Blast score: 8/10 (security + architecture)
→ Routed to: Claude (Tier 11)
→ ADR gate: found docs/adr/0003-jwt-strategy.md → injected as context
→ Review runs with full architectural context
Skill Protocol execution:
You: "push to git"
→ Intent matched: git-push protocol
→ ✅ lint (2.1s)
→ ✅ typecheck (4.3s)
→ ✅ tests (11.2s)
→ ✅ stage
→ ✅ commit [AI-generated: "fix: resolve token refresh race condition"]
→ ✅ push
Fatigue-aware memory:
Session fatigue: 0.61 (PRE-SLEEP)
→ Mnemos: auto-checkpoint written
→ Micro-consolidation: 3 ResultNodes compressed
→ iCPG context injected: 2 ReasonNodes, 1 constraint
→ Context freed: ~18k tokens
You're using Claude Code. It's impressive — but:
| Layer | What it does |
|---|---|
| 67 skills | Python, TypeScript, React, React Native, Flutter, Supabase, Firebase, Stripe, Playwright, security, ADRs, cross-agent delegation |
| TDD enforcement | Stop hooks — tests must pass before Claude considers a task done |
| Quality gates | Max 20 lines/function, 3 params, 2 nesting levels. Enforced per file |
| iCPG | Intent-Augmented Code Property Graph. Stores why code exists. 6-dimension drift detection. Prevents duplicate implementations |
| Mnemos | Task-scoped memory with 4-dimension fatigue model. Survives context compaction with typed checkpoints |
| ADR enforcement | Non-trivial changes require an Architectural Decision Record. Missing one? Reverse-engineered from git history |
| Agent teams | 6 agents: Lead, Quality, Security, Review, Merger, Feature |
| System | What it does |
|---|---|
| 13-Tier Routing | Semantic blast score (1–10) routes to cheapest capable model. Local Qwen3 classifier → DeepSeek (~80% of tasks) → Kimi → Gemini → Grok → Codex → Claude. Budget-capped with auto-demotion. Routing details |
| Skill Protocols | YAML-defined workflows in maggy/skills/protocols/. "Push to git" → lint → test → stage → commit → push. Drop a .yaml to add your own |
| Telos | Testing beyond TDD. Three planes: Conformance × Validation × Integrity. A zero in any plane collapses the total score. Details |
| Cortex MCP | Code intelligence: 10 edge types, cyclomatic complexity, FTS5 search, bidirectional traversal. 15 tools, single SQLite DB. Benchmarks |
| Polyphony | Docker-isolated parallel agent execution. Second session auto-provisions a workspace. Spec |
| Engram | Cross-session memory. 7 amnesia types. Persists architectural knowledge across weeks |
| Council PR Review | Multi-model council reviews a GitHub PR from the dashboard — deterministic mega-PR chunking, a static gate (tsc/ruff) as ground truth, and an adversarial refute pass that kills false positives. Extensible per-language skills (Python/TS/Go/Rust/Java/C#/Ruby/PHP + drop-in more). pip install maggy-harness[review] |
| Plugins | Drop-in system. Ships with: Build-in-Public (auto-posts to LinkedIn/X), Telos, GitHub/Asana/Monday providers |
Every message is scored 1–10 for complexity and classified by task type. The cheapest capable model wins.
| Tier | Model | Role |
|---|---|---|
| T0 | Qwen3 (local) | Classification, triage, free bulk ops |
| T1 | Gemini Flash-Lite | Bulk extraction, CIG pipelines |
| T2 | DeepSeek Flash | Docs, tests, scaffolding |
| T3 | Gemini Flash | Multimodal, vision, audio |
| T4 | DeepSeek Pro | Complex coding, multi-file refactors |
| T5 | Gemini CLI | Multi-file agentic coding |
| T6 | AGY | End-to-end implementation (git + code + test) |
| T7 | Kimi | Long-context analysis, routing alt |
| T8 | Gemini Pro Search | Deep research, Google grounding, 2M context |
| T9 | Grok | Competitor intel, deep reasoning |
| T10 | Codex | Bulk generation, security-sensitive tasks |
| T11 | Claude Sonnet | Quality-critical code, complex debugging |
| T12 | Claude Opus | Architecture, security review, ADR decisions |
Routing is semantic (Qwen3 as local classifier), fatigue-aware, budget-capped, and cascading.
We've added first-class support for srooter, an Anthropic/OpenAI-compatible LLM gateway that routes your requests across models (Claude, MiniMax, DeepSeek, Kimi, Gemini, Grok, local Qwen) transparently — intent-based routing, budget caps, fallbacks, and a usage dashboard, without changing your tools.
Recommended with Maggy, Claude Code, or Codex. Point any of them at the gateway and your traffic is routed for you — no per-tool config:
# Claude Code (or Codex) → srooter
export ANTHROPIC_BASE_URL="https://www.srooter.ai/anthropic" # or your local gateway
export ANTHROPIC_API_KEY="<your-srooter-key>"
claude # now routed through srooter
Pick the model you "follow" once with /model-config — Maggy, the route-task hooks, and srooter all honor the same choice. Trivial asks stay on the cheap/local tier; real coding goes to your primary model (e.g. MiniMax-M2.5).
Run several agents at once — each in its own Docker/OrbStack container with a full git clone on its own branch, so concurrent work never collides on files or branches.
polyphony-auto-isolate hook). No setup./spawn-team — spawns a coordinated TDD agent team; container-isolated by default when Docker + the polyphony CLI are present, with a graceful fallback to native parallel agents.polyphony init # one-time: create ~/.polyphony/ config
polyphony spawn "add auth" # create + route a task to an agent
polyphony status # running agents / task states
polyphony cleanup # remove completed workspaces
From Claude Code: /polyphony-init, /polyphony-spawn, /polyphony-status. Requires Docker or OrbStack. Full design: Polyphony spec.
Standard TDD tells you if your code passes tests. Telos tells you if your code fulfills its intent.
IFS (Intent Fidelity Scale) = F1 × F2 × F3
F1 — Conformance: passed / total tests (pytest / vitest)
F2 — Validation: drift severity (Cortex drift_events)
F3 — Integrity: IF-3 orphan symbols (no reason edges)
IF-4 empty contracts (no pre/post/invariants)
IF-6 stale reasons (proposed >7d, never fulfilled)
IF-7 scope sprawl (reason scopes >10 files)
A zero in any plane collapses IFS to zero. 100% test pass rate with severe architectural drift = score of 0. This is intentional. See the Telos RFC.
.claude/
skills/ # 67 skills — Python, TS, React, security, mobile, databases
hooks/ # TDD enforcement, quality gates, Mnemos lifecycle
rules/ # Conditional rules by file glob
templates/ # settings.json, CLAUDE.md, ADR template, PR template
maggy/
maggy/
pipeline/ # Unified ChatPipeline orchestrator
skills/ # Skill injection + YAML protocol engine
api/ # REST API (chat, routing, plugins, pipeline logs)
static/ # Web dashboard (vanilla JS, no build step)
services/ # Routing, memory, execution, Mnemos
cortex-mcp/ # Code intelligence MCP server
src/cortex/
structure/ # AST extraction, edge types, complexity
storage/ # SQLite graph store, FTS5 index
plugins/ # Drop-in plugins (build-in-public, telos, providers)
cd maggy && python3 -m pytest tests/ -x -q # 900+ tests
cd cortex-mcp && python3 -m pytest tests/ -q # 207 tests
See CHANGELOG.md for full history.
| Getting Started | Installation, prerequisites, first session walkthrough |
| Architecture v5 | System design, routing, dashboard |
| CLI Reference | REPL commands, slash commands, routing |
| Telos RFC | Intent-grounded testing spec |
| Cortex docs | Code intelligence, edge types, MCP tools |
| Cortex benchmarks | Performance vs codebase-memory-mcp |
| Changelog | Version history (current: v6.37.0) |
Skill PRs welcome. All skills run through the linter before merge:
PYTHONPATH=scripts python3 -m skill_lint --fail-on error skills/your-skill/
See CONTRIBUTING.md for the quality gate checklist.
MIT — See LICENSE
Need help scaling AI engineering in your org? LeanAI Ventures — Claude Code & MCP specialists
_project_specs/
00-autonomous-engineering-roadmap.md
01-runtime-observability.md
02-rollback-and-recovery.md
03-verifiable-contracts.md
04-multi-agent-coordination.md
05-confidence-calibration.md
06-cost-budget-awareness.md
07-human-escalation-protocol.md
08-auto-code-index.md
09-multimodal-ingestion.md
phases/
phase-01-pi-adapter.md
phase-02-model-routing.md
phase-03-mnemos-multimodel.md
phase-04-cikg-extract.md
phase-05-maggy-v2-ui.md
phase-06-dual-model-planning.md
phase-07-vercel-containers.md
phase-08-process-intelligence.md
phase-09-mcp-forge.md
phase-10-integration-testing.md
phase-11-maggy-mesh.md
phase-12-engram.md
phase-13-lexon.md
phase-14-event-spine.md
.github/
workflows/
publish.yml
skill-lint.yml
skill-review.yml
.gitignore
agents/
explore.md
bin/
build-in-public-status
deepseek
gemini-api
gemini-cli
glm
grok
groq
kimi
maggy-usage
ollama-coder
qwen3
reddit-auth-setup
research
review
together
validate-plan
CHANGELOG.md
CLAUDE.md
commands/
analyze-repo.md
analyze-workspace.md
build-in-public.md
check-contributors.md
icpg-bootstrap.md
icpg-drift.md
icpg-impact.md
icpg-intent.md
icpg-why.md
initialize-project.md
maggy-init.md
maggy.md
mnemos-checkpoint.md
mnemos-status.md
model-config.md
polyphony-init.md
polyphony-spawn.md
polyphony-status.md
route-eval.md
set-tracker.md
spawn-team.md
sync-agents.md
sync-contracts.md
update-code-index.md
usage-summary.md
comparision.md
CONTRIBUTING.md
cortex-mcp/
.coverage
docs/
cortex-vs-codebase-memory.md
images/
cortex-benchmark-1.png
cortex-benchmark-2.png
cortex-benchmark-3.png
cortex-benchmark-4.png
pyproject.toml
src/
cortex/
__init__.py
__main__.py
config.py
intent/
__init__.py
memory/
__init__.py
server.py
storage/
__init__.py
db.py
graph.py
schema.py
structure/
__init__.py
complexity.py
edge_extractor.py
fallback_parser.py
git_edges.py
indexer.py
models.py
python_edges.py
snippets.py
ts_edges.py
tools/
__init__.py
intent_impl.py
intent_tools.py
memory_impl.py
memory_tools.py
structure_tools.py
unified_tools.py
tests/
conftest.py
test_benchmark/
__init__.py
test_parity.py
test_intent/
__init__.py
test_memory/
__init__.py
test_storage/
__init__.py
test_db.py
test_graph.py
test_structure/
__init__.py
test_edge_extractor.py
test_fallback_parser.py
test_indexer.py
test_tools/
__init__.py
test_cross_layer.py
test_intent_memory.py
docs/
architecture-v5.md
benchmark-results.md
claude-bootstrap-reference.md
maggy-rfc.md
mnemos-implementation.md
mwp.md
polyphony-spec.md
evals/
agent-teams/
scenario-1/
criteria.json
task.md
base/
scenario-1/
criteria.json
task.md
scenario-2/
criteria.json
task.md
code-review/
scenario-1/
criteria.json
task.md
commit-hygiene/
scenario-1/
criteria.json
task.md
credentials/
scenario-1/
criteria.json
task.md
database-schema/
scenario-1/
criteria.json
task.md
existing-repo/
scenario-1/
criteria.json
task.md
llm-patterns/
scenario-1/
criteria.json
task.md
project-tooling/
scenario-1/
criteria.json
task.md
python/
scenario-1/
criteria.json
task.md
react-web/
scenario-1/
criteria.json
task.md
README.md
run-evals.sh
security/
scenario-1/
criteria.json
task.md
scenario-2/
criteria.json
task.md
session-management/
scenario-1/
criteria.json
task.md
supabase/
scenario-1/
criteria.json
task.md
typescript/
scenario-1/
criteria.json
task.md
GETTING_STARTED.md
hooks/
auto-review-hook
icpg-inject-context
icpg-record-intent
mid-task-escalation
mnemos-session-start.sh
plugin-trigger
polyphony-auto-isolate
post-commit-graph
pre-push
route-task-hook
usage-summary-hook
workspace/
check-contract-freshness.sh
check-graph-freshness.sh
post-commit-contracts.sh
pre-push-contracts.sh
install.sh
LICENSE
maggy/
_project_specs/
todos/
architecture-hardening.md
.github/
workflows/
integration.yml
.gitignore
CHANGELOG.md
config.example.yaml
docs/
architecture-v5.md
assets/
parallel-chats.png
benchmark-results.md
maggy-reference.md
maggy-rfc.md
mnemos-implementation.md
plan.md
polyphony-spec.md
sidebar-navigation-design.md
visual-validation.md
install.sh
maggy/
__init__.py
adapters/
__init__.py
cli_discovery.py
cli_manifests.py
pi.py
api/
__init__.py
auth.py
routes_aggregator.py
routes_approval.py
routes_blueprints.py
routes_budget.py
routes_chat_sessions.py
routes_chat.py
routes_cikg.py
routes_competitors.py
routes_deploy.py
routes_editor.py
routes_engram.py
routes_escalation.py
routes_events.py
routes_forge.py
routes_heartbeat.py
routes_history.py
routes_icpg.py
routes_improve.py
routes_keys.py
routes_lexon.py
routes_mesh_admin.py
routes_mesh.py
routes_models.py
routes_monitor.py
routes_observability.py
routes_orchestrator.py
routes_pipeline.py
routes_planning.py
routes_plugins.py
routes_pr_review.py
routes_process.py
routes_projects.py
routes_provider_config.py
routes_refresh.py
routes_review.py
routes_routing.py
routes_setup.py
routes_shell.py
routes_skills.py
routes_srooter.py
routes_system.py
routes_testing.py
routes_usage.py
routes_users.py
routes.py
blueprint_extract.py
blueprint_store.py
budget.py
calibration/
__init__.py
tracker.py
checkpoint.py
cikg/
__init__.py
graph.py
models.py
queries.py
storage.py
cli_analytics.py
cli_bg_task.py
cli_blueprints.py
cli_chat.py
cli_client.py
cli_context.py
cli_output.py
cli_repl_cmds.py
cli_repl_info.py
cli_rules.py
cli_sessions.py
cli_stream.py
cli_welcome.py
cli.py
config.py
contracts/
__init__.py
generator.py
coordination/
__init__.py
lock_manager.py
council/
__init__.py
audit_log.py
blast_analyzer.py
deliberation.py
executor_gate.py
models.py
deploy.py
discovery.py
engram/
__init__.py
diagnostics.py
record.py
retrieval.py
seed.py
store.py
escalation/
__init__.py
protocol.py
event_spine/
__init__.py
emitter.py
events.py
header.py
store.py
fatigue.py
forge/
__init__.py
connector.py
detector.py
registry.py
heartbeat/
__init__.py
jobs_extra.py
jobs.py
scheduler.py
history/
__init__.py
analyzer.py
models.py
parsers/
__init__.py
base.py
claude.py
... 846 moreTurn Claude Code into a self-reviewing, test-enforced engineering system that remembers context across sessions — then route work across 13 models from a single dashboard.
FAQ
maggy is a Claude Code plugin with 68 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes aeo-optimization, agent-teams, agentic-development. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.