claude-code-bootstrapper
Analyze any project and generate a complete .claude/ automation structure: agents, pipelines, skills, memory, hooks, and settings. Supports
Open source Repository Open in the app JSON README (API)
About
Analyze any project and generate a complete .claude/ automation structure: agents, pipelines, skills, memory, hooks, and settings. Supports fresh generation and validation modes.
Details
- Kind
- Plugins
- Topic
- AI, RAG & memory
- Publisher
- bemyslavedarlin
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 15
- Forks
- 1
- Last push
- 2026-09-03T15:44:07Z
- Repository state
- ativo
- Language
- Shell
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
bemyslavedarlin/cc-bootstrapper/claude-code-bootstrapper
README
# cc-bootstrapper
[English](README.en.md)
Генератор системы автоматизации Claude Code. Запускаешь `/cc-bootstrapper:bootstrap` в любом проекте — получаешь полную `.claude/` структуру: агенты, пайплайны, скиллы, memory, hooks, settings. Дальше работаешь через `/pipeline`.
## Требования
- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code)
- Bash 4+
- `jq`
- macOS, Linux или Windows (WSL)
## Установка
### Как плагин Claude Code (рекомендуется)
В Claude Code CLI:
```
/plugin marketplace add BeMySlaveDarlin/cc-bootstrapper
/plugin install cc-bootstrapper@bemyslavedarlin-cc-bootstrapper
```
### Локальная установка (для разработки)
```
/plugin marketplace add /path/to/cc-bootstrapper
/plugin install cc-bootstrapper@bemyslavedarlin-cc-bootstrapper
```
## Запуск
```
/cc-bootstrapper:bootstrap
```
Режим выполнения выбирается автоматически: **Team** (параллельные агенты) если Agent Teams доступны, иначе **Sequential** (последовательный, стабильнее).
Автоопределение режима:
- Пустой проект → генерирует шаблон спецификации, останавливается
- Нет `.claude/` → полная генерация (fresh)
- Есть `.claude/` v8.x → patch (mini-upgrade) или upgrade
- Есть state → resume с последнего шага
Поддерживаемые стеки: PHP, Node.js/TypeScript, Python, Go, Rust, Java, C#, Ruby. Мульти-язычные проекты — набор агентов для каждого языка.
## Процесс bootstrap (10 шагов)
| Шаг | Название | Что делает |
|-----|----------|------------|
| 1 | Сканирование | Light scan: манифесты, структура, стек, git remote |
| 2 | Определение режима | empty / fresh / patch / upgrade / resume |
| 3 | Настройка | permissions, git, глубина анализа, custom agents/skills/pipelines |
| 4 | Settings.json | Базовые permissions + hooks |
| 5 | Плагины и MCP | Playwright, Context7, LSP, GitLab/GitHub/Docker MCP |
| 6 | План и превью | Dry-run preview, оценка токенов, **pause point** |
| 7 | Глубокий анализ | Per-lang паттерны, архитектура, API (опционально) |
| 8 | Генерация | Per-domain параллельно: per-lang + common + infra |
| 9 | CLAUDE.md | Генерация с таблицами агентов/скиллов/пайплайнов |
| 10 | Финализация | Верификация, .bootstrap-manifest.json, cleanup |
**Team mode:** фазы A(scan∥) → B(config) → C(preview) → D(gen∥) → E(finalize∥). Генерация per-lang параллельно через Agent Teams (имплицитная команда: именованные агенты + SendMessage).
Каждый шаг — изолированный субагент. Данные передаются через `.claude/.cache/state.json`. При crash — resume с последнего шага.
---
# Сгенерированная система
Всё ниже — описание того, что появляется в целевом проекте после bootstrap и как с этим работать.
## Routing
CLAUDE.md содержит ЖЁСТКОЕ ПРАВИЛО: любой запрос связанный с кодом маршрутизируется через `/pipeline`.
```
/pipeline review → ревью кода
/p fix баг в авторизации → fix-code pipeline
/p новый эндпоинт users → new-code pipeline
/p → определит тип по контексту
```
## Пайплайны
8 базовых + кастомные. v9 frontmatter: phases[] array, agents{}, modes, structured error_routing.
| Pipeline | Когда | Ключевые фазы | Agent Teams |
|----------|-------|---------------|-------------|
| `new-code` | Новый модуль, сервис, эндпоинт | Analysis → Architecture → Storage → Code → Tests → Review | developer + test-developer + reviewer |
| `fix-code` | Баг, ошибка, regression | Diagnosis → Fix → Tests → Review | developer + test-developer + reviewer |
| `review` | Ревью кода | Per-lang Review → Report | reviewers per-lang ∥ |
| `tests` | Написание тестов | Analyze → Generate → Verify → Review | test-developer + reviewer |
| `brainstorm` | Обсуждение идеи, подхода | Frame → Perspectives → Capture | analyst ∥ architect ∥ storage ∥ devops |
| `api-docs` | API-контракты | Scan → Generate → Save | — |
| `qa-docs` | Чеклисты, Postman, E2E | Input → Checklist → Automation → Save | — |
| `full-feature` | Полный цикл фичи | 8 inline phases: Analysis→...→QA | — |
4 пайплайна поддерживают **Agent Teams** (new-code, fix-code, tests, brainstorm): спавн именованных агентов + SendMessage-координация, команда имплицитная. Fallback на sequential автоматический.
### Передача данных между фазами
Фазы обмениваются данными через файлы:
```
Analyst → ТЗ в output/plans/{task-slug}-spec.md
Architect → план в output/plans/{task-slug}.md
Developer → код по плану
Tester → тесты по коду (git diff)
Reviewer → отчёт в output/reviews/{task-slug}-{lang}.md
```
Агенты **сначала записывают артефакт в файл, потом возвращают summary**. При crash артефакт не теряется.
### CAPTURE
Каждый пайплайн завершается фазой CAPTURE — обновление memory:
- `facts.md` обновляется посекционно (Stack, Key Paths, Active Decisions, Known Issues)
- Новые решения → `decisions/{date}-{slug}.md`
- Паттерны → `patterns.md`
- Баги → `issues.md`
## Агенты
Для каждого языка — 4 агента:
| Агент | Роль | Режим |
|-------|------|-------|
| `{lang}-architect` | Планирование модулей и архитектуры | PLAN MODE (read-only) |
| `{lang}-developer` | Написание кода по плану | Пишет файлы |
| `{lang}-test-developer` | Написание тестов | Пишет файлы |
| `{lang}-reviewer` | Комплексное ревью: архитектура, логика, безопасность, стат-анализ, оптимизация | READ-ONLY |
Общие агенты:
| Агент | Роль | Условие |
|-------|------|---------|
| `analyst` | Декомпозиция задач, ТЗ | Всегда |
| `storage-architect` | Проектирование хранилищ: SQL, NoSQL, Redis, S3, очереди | Если есть хранилище |
| `devops` | Docker, CI/CD, хост-машина (WSL/Linux/macOS), деплой | Всегда |
| `qa-engineer` | Тест-планы, чеклисты, Postman, Playwright E2E, smoke-тесты | Всегда |
## Скиллы
| Скилл | Что содержит | Условие |
|-------|-------------|---------|
| `code-style/` | Паттерны и антипаттерны кода проекта | всегда |
| `architecture/` | Структура модулей, DI, маршруты | всегда |
| `storage/` | Хранилища: БД, кэш, очереди, object storage | всегда |
| `testing/` | Тест-фреймворк, моки, E2E | всегда |
| `memory/` | Правила работы с memory-системой | всегда |
| `pipeline/` | Роутер `/pipeline` (invocable) | всегда |
| `p/` | Alias `/p` (invocable) | всегда |
| `gitlab/` | MCP-операции GitLab: MR, issues, pipelines, wiki | gitlab MCP |
| `github/` | GitHub CLI: PR, issues, actions, releases | github MCP |
| `playwright/` | Playwright MCP: навигация, формы, скриншоты, E2E | playwright plugin |
## Memory
| Файл | Назначение | Лимиты |
|------|------------|--------|
| `facts.md` | Стек, пути, активные решения, known issues | Секционное обновление, 10 issues max |
| `patterns.md` | Повторяющиеся паттерны кода | — |
| `issues.md` | Known issues из ревью | 30 строк, дедупликация |
| `decisions/*.md` | Архитектурные решения (ADR-lite) | 20 активных max |
| `decisions/archive/` | Устаревшие решения | Авторотация 30 дней |
## Hooks
| Hook | Event | Что делает |
|------|-------|------------|
| `track-agent.sh` | PostToolUse (Task/Agent) | Логирует использование агентов |
| `maintain-memory.sh` | SessionStart | Ротация decisions, компакция memory, cleanup |
| `update-schema.sh` | SessionStart (если DB) | Обновляет `database/schema.sql` из Docker |
## Плагины и MCP (step 5)
Bootstrap предлагает установить релевантные плагины и MCP:
| Тип | Что | Условие |
|-----|-----|---------|
| Plugin | Playwright | Фронтенд или E2E тесты |
| Plugin | Context7 | Популярный фреймворк |
| Plugin | LSP (TypeScript, PHP, Python, Go) | Per-lang |
| MCP | GitLab | git hosting = GitLab |
| MCP | GitHub | git hosting = GitHub |
| MCP | Docker | Docker в стеке |
Каждый предлагается через AskUserQuestion. После установки permissions автоматически добавляются в settings.json.
## Settings.json
Генерируется на step 4 с учётом выбора пользователя:
- **Permissions level**: conservative / balanced / permissive
- **Git permissions**: read / write / push / delete (multiSelect)
- **Lang-specific**: автоматически по стеку (npm, composer, pip, cargo, etc.)
- **MCP permissions**: добавляются на step 5 после установки плагинов
В patch mode: diff-based merge с маркерами `[KEEP]`/`[+ADD]`/`[-DEL]`/`[USER]`.
## Кастомизация
**Агент:** создай `.claude/agents/{name}.md`, добавь в CLAUDE.md, подключи в пайплайн.
**Скилл:** `mkdir -p .claude/skills/{name}`, создай `SKILL.md`. Для invocable — `user-invocable: true`.
**Пайплайн:** создай `.claude/pipelines/{name}.md`, добавь keywords в `skills/pipeline/SKILL.md`.
**Hook:** создай `.claude/scripts/hooks/{name}.sh`, `chmod +x`, добавь в `settings.json`.
## Лицензия
[MIT](LICENSE)