Claude Code Starter v6

Claude Code Starter — это готовая управляющая среда для проектов, в которых основной рабочий агент — Claude Code.

Он нужен не для генерации приложения, а для того, чтобы быстро добавить в любой проект:

• понятный CLAUDE.md вместо мегадокумента;
• модульные rules, skills, agents, hooks;
• устойчивую проектную память через .claude/SNAPSHOT.md;
• единый installer для нового, существующего и legacy-проекта;
• явный контроль над тем, что framework state делает с git-историей.

Новое в v6: автоматическое определение типа проекта (code / content / hybrid). Контентные проекты — книги, курсы, базы знаний, документы, транскрипты — получают свой набор правил, навыков и агентов (writer, editor, content-reviewer). Установка без флагов: bash init-project.sh сам поймёт, где находится, и поставит подходящий слой.

Зачем Это Нужно

Обычно при работе с агентом проект быстро расползается:

• инструкции живут в одном длинном CLAUDE.md;
• правила смешаны с контекстом проекта;
• старт нового проекта и миграция старого проекта делаются по-разному;
• агентная память теряется между сессиями;
• внутренние framework-файлы случайно попадают в shared/public git history.

Claude Code Starter решает эти проблемы:

• отделяет проектный паспорт от operational logic;
• даёт стандартную структуру .claude/;
• добавляет reusable workflows через skills;
• добавляет background guardrails через hooks;
• поддерживает single-file installation;
• вводит repo_access, чтобы память агента не утекала туда, где ей не место.

Что Устанавливается В Проект

После установки в хост-проекте появляется такая база:

.claude/
  rules/
  skills/
  agents/
  hooks/
  logs/
  SNAPSHOT.md
  settings.json
scripts/
  framework-state-mode.sh
  switch-repo-access.sh
CLAUDE.md
manifest.md
.gitignore

Ключевые файлы:

• CLAUDE.md — паспорт проекта;
• manifest.md — project_name и repo_access;
• .claude/SNAPSHOT.md — текущая память проекта;
• .claude/rules/ — постоянные operational правила;
• .claude/skills/ — стандартные workflows;
• .claude/agents/ — типовые subagent roles;
• .claude/hooks/ — фоновые guardrails;
• scripts/switch-repo-access.sh — безопасное переключение между private-solo, private-shared, public.

Требования

Обязательно:

• bash
• git
• Claude Code с поддержкой:
  • .claude/rules/
  • .claude/skills/
  • .claude/agents/
  • .claude/hooks/

Рекомендуется:

• python3

Опционально:

• node / npm
• pytest
• sqlite3
• psql
• supabase

python3 нужен не для bootstrap, а для безопасного merge settings.json в migration flow.

Установка

Вариант 1. Один файл

Возьми root installer init-project.sh, положи его в корень целевого проекта и запусти:

chmod +x init-project.sh
./init-project.sh

Никаких флагов не нужно. Launcher сам определит:

Сценарий установки:

• new — новый проект;
• existing — существующий без framework;
• legacy — старый framework;
• upgrade — частично установленный.

Тип проекта (по содержимому файлов и папок):

• code — обычный software-проект;
• content — книги, курсы, KB, документы, транскрипты;
• hybrid — и код, и контент.

Тип контента для контентных проектов:

• book — папки chapters/, briefs/, bible/;
• course — папки modules/, lessons/;
• knowledge-base — articles/, INDEX.md;
• documents — docs/;
• transcripts — Section-*/, *-Lecture-*;
• mixed — несколько сразу.

Если установка затрагивает существующий CLAUDE.md, он мержится аддитивно через scripts/lib/merge_claude_md.py — кастомные секции пользователя сохраняются, фреймворк добавляет только недостающее. При жёстком конфликте установка останавливается и в .claude/CLAUDE.md.merge-proposal.md пишется конкретное предложение разрешения.

Вариант 2. Из локального checkout

cd /path/to/your/project
bash /absolute/path/to/claude-code-starter/init-project.sh

Вариант 3. Глобальный слой + skill /setup-project

Если хочешь, чтобы framework был доступен в любой папке без скачивания каждый раз — поставь его в ~/.claude/:

bash /path/to/claude-code-starter/scripts/install-global.sh

Это аддитивно копирует rules / skills / agents в ~/.claude/, не трогая существующие настройки. Делает backup в ~/.claude/.backup-TIMESTAMP/. После этого:

mkdir my-new-project && cd my-new-project
# Открой Claude Code в этой папке и скажи:
# /setup-project   — или просто: «новый проект» / «поставь фреймворк»

Skill /setup-project сам найдёт checkout, определит тип проекта и поставит framework. Никакой ручной загрузки init-project.sh не требуется.

Откат: bash scripts/install-global.sh --rollback.

Полезные параметры

./init-project.sh --name "My Project"
./init-project.sh --type content --content-type book
./init-project.sh --mode init
./init-project.sh --mode migrate
./init-project.sh --template /path/to/local/framework
./init-project.sh --rollback
./init-project.sh --apply-proposal
./init-project.sh --force

Поддерживаются:

• --name — имя проекта для свежего bootstrap;
• --type code|content|hybrid|auto — override автодетекта типа проекта;
• --content-type book|course|knowledge-base|documents|transcripts|mixed — override автодетекта типа контента;
• --mode init — принудительный bootstrap;
• --mode migrate — принудительная migration/integration;
• --template — использовать локальный checkout framework вместо download;
• --rollback — восстановить файлы из последнего .claude/backup-*/ snapshot;
• --apply-proposal — применить предложение из .claude/CLAUDE.md.merge-proposal.md;
• --force — перезаписать существующие файлы (для разработчиков фреймворка).

Что Делать После Установки

1. Заполнить CLAUDE.md под конкретный проект.
2. Проверить manifest.md.
3. Если проект shared/public, переключить режим до первого framework commit:

scripts/switch-repo-access.sh public --commit

или

scripts/switch-repo-access.sh private-shared --commit

4. Открыть проект в Claude Code и запустить /start.

Repo Access

repo_access задаётся в manifest.md.

Режимы:

• private-solo — framework files можно хранить в git;
• private-shared — framework files должны оставаться локальными;
• public — framework files должны оставаться локальными.

Практический смысл:

• если репозиторий личный, можно хранить framework state в истории;
• если репозиторий общий или публичный, память агента не должна попадать в branch history.

Если framework state уже успел попасть в remote history, одного .gitignore недостаточно. Для таких случаев и существует scripts/switch-repo-access.sh.

Как Устроен Этот Репозиторий

Публичный вход:

• init-project.sh — единственный installer entrypoint

Внутренний payload:

• scripts/init-project.sh — bootstrap payload
• scripts/migrate.sh — migration payload
• scripts/framework-state-mode.sh — логика repo_access
• scripts/switch-repo-access.sh — safe mode switch

Документация:

• CHANGELOG.md — история версий и изменений
• RELEASING.md — как собирать и публиковать релиз
• release-notes/v5.0.0.md — notes для текущего release
• release-notes/GITHUB_RELEASE_v5.0.0.md — готовый body для GitHub Release

Архив:

• archive/V4_ARCHIVE_NOTE.md — что именно сохранено от v4
• archive/v4-working-tree — архивное дерево v4

Ограничения

1. switch-repo-access.sh не переписывает git history.
2. migrate.sh зависит от python3, если нужен безопасный merge .claude/settings.json.
3. Standalone installer лучше всего работает через GitHub Release assets.
4. Hooks здесь — это guardrails, а не абсолютный enforcement layer.

Быстрые Ссылки

• Установить framework: init-project.sh
• Прочитать историю версий: CHANGELOG.md
• Собрать release: RELEASING.md
• Посмотреть notes текущего релиза: release-notes/v5.0.0.md
• Взять текст GitHub Release: release-notes/GITHUB_RELEASE_v5.0.0.md

v5 vs v6

| Тема | v5 | v6 | |------|----|----| | Тип проекта | только code | code / content / hybrid с автодетектом | | Контентные проекты | нет | книги, курсы, KB, документы, транскрипты | | CLAUDE.md при миграции | merge только settings.json hooks | полный аддитивный merge секций через Python helper | | Конфликты | overwrite или skip | детектятся, останавливают установку, записывают конкретное предложение | | Backup | нет | автоматический .claude/backup-TIMESTAMP/ перед каждым изменением | | Откат | manual | init-project.sh --rollback | | Шаблоны контента | нет | templates/chapter.md, lesson.md, transcript.md, article.md, document.md |

Подробности по эволюции версий смотри в CHANGELOG.md.