Claude Code Starter — для Claude Code и Codex

Шаблон смысло-кодинга: небольшой второй мозг проекта, одна архитектура и планы, которые агент доводит до проверенного результата. Подходит, если идеи ещё нет, есть идея, готовая архитектура, работающий код или нужно продолжить вчерашнюю работу. Обязательного интервью и настройки на два часа нет.

Быстрый старт

Нужен установленный и авторизованный Claude Code или Codex. Редактор выбирай сам. Для клонирования нужен Git, для установщика — Python 3. Шаблон не устанавливает агента и не оплачивает доступ к моделям.

Новый проект: клонировать шаблон

Нажми Use this template на GitHub и склонируй созданный репозиторий. Или скачай исходный шаблон:

git clone https://github.com/artemiimillier/claude-code-starter moy-proekt
cd moy-proekt

Открой папку в своём агенте. CLAUDE.md и AGENTS.md ведут к общим правилам в docs/workflow.md. Удалять .git для начала работы не нужно.

Перед заполнением .business/ защити её: в клоне лежат отслеживаемые Git плейсхолдеры, а не приватные данные. Попроси агента проверить tracking, согласовать снятие .business/ с индекса без удаления локальных файлов и добавить ignore. Проверку нужно закончить до, а не после записи реального контекста. Подробности — общий процесс.

Уже есть проект: установить без замены своих файлов

Склонируй starter отдельно, перейди в его папку и укажи путь к своему проекту. Целевая директория должна уже существовать:

git clone https://github.com/artemiimillier/claude-code-starter starter-tools
cd starter-tools
python3 scripts/install.py /path/to/my-project

Это dry-run: сначала посмотри список предполагаемых изменений и пропусков. Чтобы применить:

python3 scripts/install.py /path/to/my-project --apply

Интерфейс: python3 scripts/install.py PATH [--apply] [--agent claude|codex|both]. По умолчанию — оба агента (both) и dry-run. Например, только для Codex:

python3 scripts/install.py /path/to/my-project --agent codex --apply

Установщик размещает общий процесс в .starter/workflow.md, добавляет управляемые ссылки в выбранные CLAUDE.md/AGENTS.md, не заменяя существующие инструкции. Добавляет недостающие планы/шаблоны. Минимальный приватный второй мозг создаёт только при отсутствии существующего контекста идеи, архитектуры или бизнеса; рядом с ним не создаёт второй .business/. Существующие файлы и шаблоны консервативно пропускает; смотри отчёт, не считай пропуск обновлением. При конфликте workflow или управляемого блока останавливается до записи. Смысловые конфликты с местными правилами нужно согласовать отдельно.

Установщик не делает git commit/push, не устанавливает settings, hooks, MCP или skills, не включает bypass и не выдаёт production-права. Перед применением полезна резервная копия; после — просмотр diff и проверка приватности. Существующий .business/ не считается безопасным только потому, что запущен установщик.

Что написать агенту

Агент сначала использует доступный контекст, затем спрашивает только то, что влияет на ближайшее решение. Неизвестное не выдаёт за факт.

Как устроена работа

1. Контекст: существующий бизнес-индекс или, если его нет, минимальный .business/INDEX.md — цель, пользователь, проблема, ограничения, факты, гипотезы и следующий шаг. Остальные разделы появляются по необходимости; второй мозг не дублируется.
2. Архитектура: один канонический документ, желательно уже существующий. В планах — ссылки, не копии.
3. Полный план: продолжай существующий, в том числе план внутри архитектуры; новый нужен только при его отсутствии. Весь результат разбит на фазы с критериями, тестами, лимитами и полномочиями. Независимое ревью → судья проверяет замечания → правки → твоё одобрение.
4. Исполнение: после одобрения агент проходит все фазы без «продолжать?» на каждой: делает, тестирует, получает независимое ревью, разбирает замечания через судью, исправляет и перепроверяет.
5. Память: checkpoint после фаз и перед паузой; в конце — итоговая проверка, результат, ограничения и полезные уроки.

Автономность ограничена планом: при блокере, исчерпании лимита или необходимости новых прав агент останавливается с конкретным вопросом. Саморевью не равно независимой проверке. Метод снижает риск, но не гарантирует отсутствие ошибок. Deploy, миграции и другие production-действия требуют отдельных полномочий.

Где что лежит

• docs/workflow.md — канонический процесс; установщик копирует его в .starter/workflow.md целевого проекта.
• CLAUDE.md, AGENTS.md — короткие входные инструкции.
• AUTOPILOT.md — памятка адаптивного старта, не обязательный мастер настройки.
• .business/ — в исходнике только плейсхолдеры; приватный контекст заполняется после защиты.
• plans/ — планы, критерии, review-решения и checkpoints.
• retrospectives/ — уроки прошлой работы.
• prompts/INDEX.md — необязательные промпты под конкретные задачи.
• templates/ — образцы, не замена локальных правил.
• examples/coffeeshop/ — вымышленный пример, не обязательная структура для каждого проекта.

Безопасность и обновления

Не помещай в контекст пароли, токены, документы и персональные данные клиентов. .gitignore не защищает уже отслеживаемые файлы и не очищает историю. Перед публикацией проверяй staged diff и историю на приватные данные. Hooks и шаблоны настроек не заменяют sandbox, разграничение доступа и проверку текущего формата инструмента.

Повторный запуск установщика не является принудительным обновлением: существующие шаблоны сохраняются. Сравнивай нужные изменения вручную; не заменяй свой мозг, планы и инструкции файлами starter.

Вопросы по окружению — TROUBLESHOOTING.md, изменения — CHANGELOG.md, участие — CONTRIBUTING.md. Шаблон бесплатный, MIT; доступ к моделям оплачивается отдельно по условиям выбранного провайдера.

Методология: СмыслоКод.