Meta-documentation framework for AI-assisted development with Claude Code
curl -fsSL https://cookapps.net/api/skills/install?skills=••••••• | nodeClaude Code Starter — это готовая управляющая среда для проектов, в которых основной рабочий агент — Claude Code.
Он нужен не для генерации приложения, а для того, чтобы быстро добавить в любой проект:
CLAUDE.md вместо мегадокумента;rules, skills, agents, hooks;ARCHITECTURE.md, INVARIANTS.md, methodology/) и state (SNAPSHOT.md, BACKLOG.md, dialogs/);.claude/dialogs/ до того, как Claude Code сделает retention cleanup;Новое в v6.3.0: фреймворк переходит на оркестраторскую модель. Владелец — продукт/методолог над производством: даёт цель, границы полномочий, ревьюит результат и решает на стоп-точках. Агент — оркестратор и главный девелопер: сам режет работу на потоки, сам поднимает воркеров (субагенты / изолированные worktree / детерминированные workflows), интегрирует, независимо верифицирует и коммитит — не дёргая владельца на подтверждение каждого шага. Handoff эволюционирует из ручного «моста», который владелец переносил между сессиями, во внутренний charter, который оркестратор выдаёт воркерам; непрерывность контекста между сессиями держит ограниченная двух-осевая память + тонкий указатель, а не разрастающийся мегафайл. Модель поставляется как переносимый свод правил orchestration-model.md (принципы O1–O12), правила autonomy/delegation эволюционированы под неё, скилл /handoff теперь входит в поставку. См. release-notes/v6.3.0.md.
Новое в v6.2.1: /start skill переписан — убран кэп «доложи 3-5 строк» (он читался моделью как потолок глубины, а не пол краткости), добавлен обязательный шаг заземления карты в территорию (git log + wc + grep против заявлений метафайлов), пометка «карта ≠ территория». В шапке CLAUDE.md — новая секция «Назначение этого файла» с тремя видами ограничений (действия / внимание / глубина): первые два — нормальны, кэп на глубину — структурный баг. В validate-release.sh — запрет на параллельный ONBOARDING.md (конституция только в CLAUDE.md). См. release-notes/v6.2.1.md.
Новое в v6.2.0: восстановлены слои памяти ARCHITECTURE.md и BACKLOG.md, добавлены INVARIANTS.md и каталог methodology/ с лестницей зрелости (draft → pattern → mature → crystallized). Добавлен механизм dialog preservation (scripts/save-dialogs.sh, skill /save-dialog, авто-сохранение при /finish).
Новое в v6.0–6.1: автоматическое определение типа проекта (code / content / hybrid). Контентные проекты — книги, курсы, базы знаний, документы, транскрипты — получают свой набор правил, навыков и агентов (writer, editor, content-reviewer). Опциональный глобальный слой ~/.claude/ с /setup-project skill. Установка без флагов: bash init-project.sh сам поймёт, где находится, и поставит подходящий слой.
Обычно при работе с агентом проект быстро расползается:
CLAUDE.md;Claude Code Starter решает эти проблемы:
.claude/;skills;hooks;repo_access, чтобы память агента не утекала туда, где ей не место.После установки в хост-проекте появляется такая база:
.claude/
rules/ # операционные правила (autonomy, delegation, dialog-preservation, ...)
# autonomy + delegation несут оркестраторскую модель (v6.3.0+):
# владелец над производством, агент сам поднимает воркеров
skills/ # /start, /finish, /save-dialog, /testing, ...
agents/ # researcher, implementer, reviewer (+ writer/editor для content)
hooks/ # фоновые guardrails (pre-compact, post-compact, ...)
logs/ # сессии, миграции, ошибки (gitignored)
dialogs/ # архив JSONL сессий (по умолчанию gitignored)
SNAPSHOT.md # state: текущая точка работы
BACKLOG.md # state: Next / Soon / Later / Won't do
ARCHITECTURE.md # contract: карта системы
INVARIANTS.md # contract: жёсткие правила, нарушение = баг
settings.json
methodology/ # contract: методологии для пайплайнов
_HOW-THIS-GROWS.md
templates/ # draft / pattern / mature / crystallized
draft/ patterns/ mature/
00-example-llm-as-component.md
scripts/
framework-state-mode.sh
switch-repo-access.sh
save-dialogs.sh
CLAUDE.md
manifest.md
.gitignoreДвух-осевая память (см. CLAUDE.md секция «Слои памяти»):
ARCHITECTURE.md, INVARIANTS.md, methodology/SNAPSHOT.md, BACKLOG.md, dialogs/Ключевые файлы:
CLAUDE.md — паспорт проекта;manifest.md — project_name, repo_access, project_type, content_type;.claude/SNAPSHOT.md — что в работе прямо сейчас;.claude/BACKLOG.md — план: Next / Soon / Later / Won't do;.claude/ARCHITECTURE.md — карта модулей, контрактов, зависимостей;.claude/INVARIANTS.md — правила, нарушение которых — баг, не предпочтение;.claude/dialogs/ — архив сессионных JSONL для последующего анализа;methodology/ — методологии с лестницей зрелости (draft → pattern → mature → crystallized);.claude/rules/, .claude/skills/, .claude/agents/, .claude/hooks/ — operational слой;scripts/save-dialogs.sh — идемпотентное сохранение JSONL сессии;scripts/switch-repo-access.sh — безопасное переключение между private-solo, private-shared, public.Обязательно:
bashgit.claude/rules/.claude/skills/.claude/agents/.claude/hooks/Рекомендуется:
python3Опционально:
node / npmpytestsqlite3psqlsupabasepython3 нужен не для bootstrap, а для безопасного merge settings.json в migration flow.
Возьми 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 пишется конкретное предложение разрешения.
cd /path/to/your/project bash /absolute/path/to/claude-code-starter/init-project.sh
/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 — перезаписать существующие файлы (для разработчиков фреймворка).CLAUDE.md под конкретный проект.manifest.md.scripts/switch-repo-access.sh public --commit
или
scripts/switch-repo-access.sh private-shared --commit
/start.repo_access задаётся в manifest.md.
Режимы:
private-solo — framework files можно хранить в git;private-shared — framework files должны оставаться локальными;public — framework files должны оставаться локальными.Практический смысл:
Если framework state уже успел попасть в remote history, одного .gitignore недостаточно. Для таких случаев и существует scripts/switch-repo-access.sh.
Публичный вход:
Внутренний payload:
repo_accessДокументация:
Архив:
v4v4switch-repo-access.sh не переписывает git history.migrate.sh зависит от python3, если нужен безопасный merge .claude/settings.json.| Тема | v5 | v6.0–6.1 | v6.2.0 | v6.2.1 | v6.3.0 |
|---|---|---|---|---|---|
| Модель работы | агент-менеджер + субагенты | то же | то же | то же | оркестраторская модель: владелец над производством, агент сам поднимает воркеров (orchestration-model.md, O1–O12) |
| Роль владельца | даёт ТЗ, сам клеит сессии | то же | то же | то же | продукт/методолог: цель + границы + ревью + стоп-точки; поднятие воркеров и интеграция — у агента |
| Handoff / континуитет | нет | нет | SNAPSHOT + hooks | то же | /handoff в поставке; charter для воркеров; ограниченная память вместо мегафайла |
| Тип проекта | только code | code / content / hybrid с автодетектом | + явная двух-осевая модель памяти | то же | то же |
| Слои памяти | SNAPSHOT.md (всё в одном) | SNAPSHOT.md | SNAPSHOT.md + BACKLOG.md (state) + ARCHITECTURE.md + INVARIANTS.md (contracts) | то же | то же |
| Контентные проекты | нет | книги, курсы, KB, документы, транскрипты | + content-flavored memory layers | то же | то же |
| Methodology layer | нет | нет | methodology/ с лестницей зрелости draft → pattern → mature → crystallized | + canonical draft про onboarding-cap | то же |
| Dialog preservation | TypeScript-стек в v4, выкинут в v5 | нет | bash-скрипт + /save-dialog skill + auto-save при /finish | то же | то же |
/start skill | базовый | базовый | читает обе оси памяти | + grounding (git log/wc/grep против метафайлов), масштабируемый доклад, «карта ≠ территория» | то же |
CLAUDE.md шапка | passport-only | passport-only | + «Слои памяти» | + «Назначение» с тремя видами ограничений (действия / внимание / глубина), кэп глубины запрещён | то же |
CLAUDE.md при миграции | merge только settings.json hooks | полный аддитивный merge секций через Python helper | + документация двух-осевой памяти | то же | то же |
| Конфликты | overwrite или skip | детектятся, останавливают установку, пишут конкретное предложение | то же | то же | то же |
| Backup | нет | автоматический .claude/backup-TIMESTAMP/ | + backup новых memory files | то же | то же |
| Откат | manual | init-project.sh --rollback | + восстанавливает новые memory files | то же | то же |
| Глобальный слой | нет | опциональный ~/.claude/ через install-global.sh | + глобальный methodology/, /save-dialog skill | то же | + orchestration-model.md, /handoff skill |
| Drift guards | нет | нет | нет | validate-release.sh проверяет README badge + release-notes link + script headers, запрещает ONBOARDING.md | то же |
| Шаблоны контента | нет | chapter.md, lesson.md, transcript.md, article.md, document.md | то же | то же | то же |
Подробности по эволюции версий смотри в CHANGELOG.md.
A curated list of resources for distributed teams - remote work policies, asynchronous communication frameworks, and global talent platforms.
Clear Given-When-Then BDD scenario writing standards, step definition mapping, and business-facing acceptance criteria rules.
Get instant access to complete setup guides, repository source code, and integration assets.