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