Claude Code Starter

Стартовый шаблон для любого проекта с Claude Code. Клонируй → открой в VS Code → напиши одну фразу → через 90-120 минут у тебя настроенная среда: заполненный бизнес-контекст, правила работы с агентом, библиотека готовых промптов, первый план и ретроспектива.

👀 Хочешь увидеть что получится? Открой пример заполненного проекта — examples/coffeeshop/. Это вымышленная сеть кофеен с полностью заполненной .business/, реальным планом (подписка на напитки) и одной ретроспективой. По нему видно что у тебя окажется через 90-120 минут после клонирования.

TL;DR

1. Клонируй → открой в VS Code → открой Claude Code → напиши «привет»
2. Клод сам проведёт тебя через 10 шагов онбординга (~90-120 мин)
3. Получишь настроенную среду под твой проект + 16 готовых промптов

---

Что ты получаешь после онбординга

• 📁 Папка .business/ - второй мозг проекта, заполненный по твоим ответам на интервью (7 блоков: company, products, audience, goals, economics, marketing, assets)
• 📋 CLAUDE.md - правила работы с агентом под твой стек и тип проекта
• 🗂 plans/ и retrospectives/ с готовыми шаблонами и первыми рабочими примерами
• 🔒 Безопасность: звуковые хуки, 4 запрета опасных команд, правильный .gitignore
• 📚 Библиотека промптов - 16 готовых промптов под любые задачи (установка скилов, Playwright, деплой, критика плана, «10 причин обосраться»)

Прежде чем начать

Убедись, что у тебя есть:

• VS Code установлен (скачать)
• Claude Code (расширение в VS Code) установлен (инструкция)
• Подписка Claude оплачена (Pro $20 или Max $100+)
• Авторизация в Claude Code пройдена
• (Если ты из РФ) VPN одной страны включён - не переключай между странами

Если какой-то пункт не получается - открой TROUBLESHOOTING.md, там решения на все типовые проблемы.

Как запустить

Вариант A - через кнопку GitHub:

1. Нажми «Use this template» вверху этой страницы
2. Дай имя своему проекту (например, moy-magazin-obuvi)
3. Склонируй к себе: git clone https://github.com/твой-логин/moy-magazin-obuvi

Вариант B - через терминал:

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

Что делать дальше

1. Открой папку в VS Code
2. Открой Claude Code (иконка в левой панели)
3. Напиши любую фразу - привет, начинаем, проведи меня
4. Клод сам начнёт онбординг и проведёт тебя через 10 шагов

Длительность: 90-120 минут. Можно разбить на 2 сессии (технические настройки + интервью про бизнес) - Клод сам предложит паузу.

Структура репо

claude-code-starter/
├── README.md              ← ты сейчас здесь
├── CLAUDE.md              ← правила работы с Клодом
├── AUTOPILOT.md           ← сценарий первого запуска (удалится после онбординга)
├── TROUBLESHOOTING.md     ← решения типовых проблем
├── CONTRIBUTING.md        ← если хочешь предложить правку в шаблон
├── CHANGELOG.md           ← история версий
├── LICENSE                ← MIT
├── .vscode/settings.json  ← настройки VS Code (видимость .business/ и др.)
├── .github/
│   ├── workflows/         ← CI: security-audit при push
│   └── hooks/             ← pre-commit hook против утечки секретов (sample)
├── scripts/               ← локальный security-audit.sh
├── .business/             ← скрытая папка: бизнес-контекст твоего проекта
├── plans/                 ← технические планы реализации
├── retrospectives/        ← рефлексии после каждой сессии
├── prompts/               ← библиотека готовых промптов
│   ├── INDEX.md           ← оглавление: «если надо X - возьми Y»
│   ├── setup/             ← настройка: hooks, security, скиллы, Playwright
│   ├── launch/            ← запуск: GitHub, деплой, платежи
│   └── methodology/       ← методология: критика плана, планирование недели
└── templates/             ← шаблоны для генерации файлов

Что этот шаблон НЕ делает

• Не устанавливает VS Code, Claude Code, Node.js (это до клонирования)
• Не оплачивает подписку Claude
• Не настраивает VPN / Google country (решай сам)
• Не отвечает за тебя в интервью про бизнес - вся ценность в твоих ответах

Безопасность

• .env в .gitignore из коробки - секреты не попадут в публичный репозиторий
• .business/ в исходном шаблоне содержит плейсхолдеры и tracked в git намеренно. Клод добавит .business/ в .gitignore и снимет с tracking автоматически на последнем шаге онбординга (10a). До этого шага не делай git commit вручную, иначе промежуточные данные окажутся в истории
• Клод настраивает 4 запрета опасных команд (rm -rf, curl+export, .env, wget) в settings.json
• Bypass Permissions не включается автоматически - включаешь сам, когда почувствуешь уверенность

Рекомендуем включить pre-commit hook для защиты от случайной утечки секретов:

cp .github/hooks/pre-commit.sample .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit

После этого каждая попытка git commit будет проверять staged файлы на API-ключи, .env, приватные ключи. Если найдёт - заблокирует коммит.

Обновления шаблона

Когда выйдет новая версия - загляни в CHANGELOG.md исходного репо и скопируй к себе то, что полезно.

Что можно безопасно обновлять:

• prompts/ - новые готовые промпты под задачи
• TROUBLESHOOTING.md - новые решения типовых проблем
• scripts/security-audit.sh - обновлённые проверки
• .github/hooks/pre-commit.sample - улучшения защиты

Что НЕ трогать при обновлении:

• .business/ - там твои данные, не перезаписывай
• CLAUDE.md - он уже под твой проект, не откатывай
• plans/, retrospectives/ - твоя история работы
• AUTOPILOT.md - с флагом completed: true не нужен больше

Способ обновления - просто скачай нужные файлы вручную. Автоматический npx-апдейтер появится в v1.1.0+.

FAQ

Почему этот шаблон, а не пустой CLAUDE.md?

Пустой CLAUDE.md — это «напиши туда правила сам». Ты не знаешь что туда писать, пока не набил шишки. Этот шаблон — выжимка методологии после 3 потоков практикума: .business/ как второй мозг, plans/ с критикой через субагентов, retrospectives/ для памяти между сессиями, 16 готовых промптов под типовые задачи. Ты получаешь результат которого иначе достигнешь через 3-4 месяца работы.

Это бесплатно?

Шаблон — полностью бесплатно (MIT). Подписка Claude ($20-200/мес) — отдельно, это продукт Anthropic. Платный практикум Школы Смысло-кодинга — опционально, для тех кому нужна методология на 2-3 уровне и обратная связь.

У меня уже есть проект — как его интегрировать?

Используй промпт prompts/methodology/import-existing-project.md — Клод прочитает твой код, структуру папок, README и сам заполнит .business/ на основе того что найдёт. Вопросов зададёт 5-7 чтобы закрыть пробелы.

Я не из России. Часть документации русская. Это проблема?

Сейчас шаблон только на русском. Английская версия — в roadmap v2.0.0. Пока что — всё работает, просто тебе нужно знать русский или готов использовать Google Translate на файлы-подсказки. Промпты внутри ты пишешь на том языке который выберешь на шаге 8 онбординга.

Сколько токенов Claude сожрёт в месяц?

Сама работа по методологии (план → реализация → ретро) — среднее потребление у предпринимателя с активным проектом: ~15-30 млн токенов/мес. Это укладывается в Claude Max $100. Если работаешь меньше 2 часов/день — хватит Pro $20. Главный расход — интенсивная разработка, а не сам шаблон.

Что если я закрою ноут посреди онбординга?

Без паники. AUTOPILOT ведёт файл прогресса. Откроешь проект через день → напишешь любую фразу → Клод скажет «вижу мы остановились на шаге N, продолжаем?». Сценарий протестирован.

Что если AUTOPILOT ошибётся или задаст странный вопрос?

Напиши Issue через кнопку выше — шаблон «bug-report» попросит нужные детали. Или запусти более узкий промпт вручную: вместо AUTOPILOT целиком — промпты из prompts/setup/ по отдельности.

Это работает только с Claude Code? А Cursor / Cody / Windsurf?

Рассчитан на VS Code + Claude Code. Частично работает в Cursor (структура .business/, plans/, retrospectives/ универсальна, промпты тоже). AUTOPILOT заточен под Claude Code и в других IDE может сбиться. Для Codex — читай блок в TROUBLESHOOTING.md.

Могу ли я использовать шаблон для коммерческого проекта?

Да. Лицензия MIT. Используй как хочешь, включая закрытый коммерческий софт. Атрибуция в footer README желательна, но не требуется юридически.

Куда писать если не работает что-то не из этого списка?

• Bug → Issues с шаблоном «🐛 Bug report»
• Идея → Issues с шаблоном «💡 Feature request»
• Вопрос → Discussions или «❓ Question» issue
• Утечка данных / safety → Security Advisory приватно

Лицензия

MIT. Используй как хочешь, включая коммерческие проекты.

---

_{Методология разработана в Школе Смысло-кодинга.}