Claude Bootstrap и Maggy — набор настроек и сервер маршрутизации
Claude Bootstrap + Maggy
Набор скиллов, хуков и правил для Claude Code с обязательными тестами и памятью между сессиями, плюс локальный сервер маршрутизации по моделям
- 711 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Установщик удаляет и пересоздает `~/.claude/skills` и `~/.claude/rules`, а хуки и скрипты делегирования получают доступ к вашим командам и файлам
- Сервер Maggy отправляет запросы разным поставщикам моделей, и вместе с ними уходит контекст проекта и ключи API из окружения
- Polyphony запускает агентов в контейнерах Docker с полным клоном репозитория, а автоматическая публикация постов и пуш в git требуют вашей проверки
Установка
- Работает в
Ручная установка
git clone https://github.com/alinaqi/maggy.git && cd maggy && ./install.shУстанавливает Claude Bootstrap за полминуты. Скрипт пересоздает `~/.claude/skills` и `~/.claude/rules`, поэтому заранее сохраните свои.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Установщик удаляет и пересоздает `~/.claude/skills` и `~/.claude/rules`, а хуки и скрипты делегирования получают доступ к вашим командам и файлам
- Сервер Maggy отправляет запросы разным поставщикам моделей, и вместе с ними уходит контекст проекта и ключи API из окружения
- Polyphony запускает агентов в контейнерах Docker с полным клоном репозитория, а автоматическая публикация постов и пуш в git требуют вашей проверки
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий состоит из двух частей. Claude Bootstrap ставится скриптом `install.sh` и кладет в `~/.claude` команды, 73 скилла, условные правила, хуки и шаблоны для Python, TypeScript, React, мобильной разработки, баз данных и безопасности. Stop-хуки не дают Claude Code считать задачу законченной при падающих тестах. Проверки качества ограничивают функции двадцатью строками, тремя параметрами и двумя уровнями вложенности. Для веб-проектов по умолчанию подключена визуальная проверка: скилл записывает комментированный прогон Playwright в видео, которое заодно служит сквозным тестом. Память между сессиями устроена в два слоя: Mnemos ведет контрольные точки с учетом усталости сессии, iCPG хранит, зачем написан код, и ловит дрейф от замысла. Для архитектурных изменений нужна запись ADR, а если ее нет, ее восстанавливают из истории git. Maggy ставится отдельно, как пакет `maggy-harness` из PyPI. Это локальный сервер на FastAPI с панелью на `localhost:8080`: он оценивает сложность каждого сообщения по шкале от 1 до 10 и направляет его на самую дешевую способную модель из 13 уровней, от локальной Qwen3 до Claude Opus. Рядом лежит Cortex MCP — сервер анализа кода с 15 инструментами на одной базе SQLite, и Polyphony для параллельных агентов в Docker.
Для кого. Для инженеров и небольших команд, которые работают в Claude Code каждый день и хотят закрепить тесты, архитектурные записи и экономию на моделях правилами в конфигурации.
Подходит, если
- Нужно, чтобы Claude Code не считал задачу готовой при красных тестах: за это отвечают stop-хуки
- Контекст сессии переполняется и теряется, а вам нужны контрольные точки Mnemos и восстановление смысла кода через iCPG
- Простые запросы стоит отдавать дешевым моделям, а сложные Claude: для этого есть маршрутизатор Maggy с лимитом бюджета
- Несколько агентов работают в одном репозитории и мешают друг другу, поэтому вам нужна изоляция по контейнерам из Polyphony
- Большие файлы засоряют контекст: хук `context-shunt-gate` отдает их дешевой модели и возвращает краткую сводку
Не подходит, если
- В `~/.claude` уже лежат ваши скиллы и правила: установщик удаляет папки `skills` и `rules` и копирует свои, поэтому сначала сохраните копию
- Вам нужен один небольшой скилл: набор тянет с собой 73 скилла, хуки и шаблоны, а это много поверхности для проверки
- Команда не готова к жестким правилам: ограничения на длину функций и параметры, обязательные тесты и ADR будут мешать на прототипах
- Маршрутизация нужна, но запускать локальный сервер и держать ключи нескольких поставщиков моделей вы не собираетесь
Пример запроса к агенту
Проверь авторизационное middleware на атаки по времени: определи уровень сложности и маршрут, найди ADR в docs/adr, затем запусти ревью с этим контекстомОграничения
Установка `install.sh` меняет домашнюю папку Claude Code: копирует туда хуки, команды и шаблоны, а скрипты делегирования кладет в `~/bin`. Для Kimi CLI и Codex CLI скрипт при обнаружении добавляет скиллы и в их папки.
Maggy требует Python 3.11 и новее, а для Polyphony нужны Docker или OrbStack. Ключи API не обязательны для старта, но маршрутизация по облачным моделям работает только при ключах поставщиков: DeepSeek, Kimi, Gemini, Grok, OpenAI и Anthropic. Режим Codex использует либо подписку ChatGPT через `codex login` только для делегирования, либо ключ OpenAI API.
Контекстный перехват `context-shunt-gate` по умолчанию лишь подсказывает и не блокирует чтение. Набор растет быстро: номера версий в описании проекта и в самом установщике расходятся, а список моделей и уровней маршрутизатора меняется от версии к версии.
Как отключить. Верните сохраненные копии `~/.claude/skills`, `~/.claude/rules` и `~/.claude/settings.json`, удалите хуки и шаблоны, которые положил установщик, и снимите пакет Maggy командой `pipx uninstall maggy-harness`. Скрипты делегирования лежат в `~/bin`.
Частые вопросы
Как установить Claude Bootstrap?
Клонируйте репозиторий и запустите скрипт: `git clone https://github.com/alinaqi/maggy.git`, затем `cd maggy && ./install.sh`. Следующая сессия Claude Code подхватит скиллы и хуки сама. Перед запуском сохраните свои `~/.claude/skills` и `~/.claude/rules`: скрипт их пересоздает.
Чем Maggy отличается от Claude Bootstrap?
Bootstrap — это скиллы, хуки и правила в `~/.claude`, он ставится за полминуты. Maggy — отдельный локальный сервер с панелью: маршрутизация по 13 уровням моделей, протоколы навыков, плагины и Cortex MCP. Ему нужны Python и, по желанию, Docker.
Как запустить сервер Maggy?
Выполните `pipx install maggy-harness`, затем `maggy bootstrap` и `maggy serve`. Сервер сам находит локальные репозитории и открывает панель по адресу `localhost:8080`. Ключи API на старте не нужны, `GITHUB_TOKEN` и `ANTHROPIC_API_KEY` добавляют позже.
Работает ли набор с Codex и Kimi?
Да, по описанию автора скиллы подходят для Claude Code, Codex, Kimi и Gemini CLI. Установщик при обнаружении Kimi CLI и Codex CLI копирует скиллы в `~/.kimi/skills` и `~/.codex/skills`.
Что делает Cortex MCP?
Это встроенный в репозиторий MCP-сервер для анализа кода. Он строит граф с десятью типами связей, считает цикломатическую сложность, ищет по полнотекстовому индексу FTS5 и отдает 15 инструментов поверх одной базы SQLite.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыРабочая папка для Claude Code: хуки с локальной Ollama определяют тип проекта, подбирают скиллы и напоминают вести документацию
Рабочие процессы для Claude Code: команды /do, /omo, /bmad-pilot и другие, а код пишут Codex, Gemini или OpenCode через codeagent-wrapper
Набор слеш-команд /sc, агентов и поведенческих режимов для Claude Code: от брейншторма и исследования до реализации и тестов
Учебный набор для Claude Code: разбор возможностей и готовые для копирования шаблоны команд, скиллов, памяти, хуков и субагентов
Русскоязычный курс по Claude Code на 12 модулей и 8 лабораторных с готовым набором скиллов, субагентов и хуков для проекта
Маркетплейс плагинов Claude Code с готовыми наборами агентов, слэш-команд, хуков и скиллов плюс сайт для поиска
Коротко о README
Таблица выбора сравнивает быстрый путь Bootstrap и полную установку Maggy. Далее идут примеры маршрутизации и протокола «push to git», тезисы о проблемах, которые решает проект, и список возможностей с тестами. Внизу собраны заметки об изменениях по версиям и ссылки на документацию.
Бейдж для README
Исходный SKILL.md
--- name: base description: Universal coding patterns, constraints, TDD workflow, atomic todos when-to-use: Always loaded as foundation for all projects - TDD workflow, simplicity rules, atomic todos user-invocable: false effort: medium --- # Base Skill - Universal Patterns ## Core Principle Complexity is the enemy. Every line of code is a liability. The goal is software simple enough that any engineer (or AI) can understand the entire system in one session. --- ## Simplicity Rules These limits apply to every file created or modified. ### Function Level - **Maximum 20 lines per function** - if longer, decompose IMMEDIATELY - **Maximum 3 parameters per function** - if more, use an options object or decompose - **Maximum 2 levels of nesting** - flatten with early returns or extract functions - **Single responsibility** - each function does exactly one thing - **Descriptive names over comments** - if you need a comment to explain what, rename it ### File Level - **Maximum 200 lines per file** - if longer, split by responsibility BEFORE continuing - **Maximum 10 functions per file** - keeps cognitive load manageable - **One export focus per file** - a file should have one primary purpose ### Module Level - **Maximum 3 levels of directory nesting** - flat is better than nested - **Clear boundaries** - each module has a single public interface - **No circular dependencies** - ever ### Enforcement Protocol **Before completing ANY file:** 1. Count total lines - if > 200, STOP and split 2. Count functions - if > 10, STOP and split 3. Check each function length - if any > 20 lines, STOP and decompose 4. Check parameter counts - if any > 3, STOP and refactor **If limits are exceeded during development:** ``` ⚠️ FILE SIZE VIOLATION DETECTED [filename] has [X] lines (limit: 200)