scaffold-project — bootstrap нового проекта

Когда пользователь говорит «новый проект» — этот скилл разворачивает полный скелет за один диалог. После scaffold все задачи в проекте идут через dev-workflow.

Шаг 0 — определить режим

Скилл различает три режима по триггер-фразе пользователя:

Если триггер двусмысленный (например, просто /scaffold-project в каталоге с CLAUDE.md) — спросить пользователя один раз: «у проекта уже есть CLAUDE.md. Это fresh-init где-то ещё, или back-fill сюда?».

Шаг 1 — pre-checks (fresh / extension режим)

Перед стартом скилл проверяет целевой каталог:

Шаг 2 — диалог

Скилл задаёт пять вопросов. Не больше, не меньше.

1. Имя проекта (kebab-case). Валидация: ^[a-z][a-z0-9-]{1,40}$. Не проходит — спрашиваем заново.
2. Однострочное описание — 1 предложение, чем проект полезен. Если пользователь хочет дать развёрнутый scope — приветствуется, уйдёт в {{SCOPE_DESCRIPTION}} as-is.
3. Стек:
   • node-cli — Node 20+ CLI или библиотека, тесты через node --test.
   • python-mcp — Python MCP-сервер или скрипт, тесты через pytest.
   • both — оба extension'а.
   • none — только base, никакого языкового скелета.
4. Внешние сервисы, которые предполагаются сразу (Notion / Gmail / Stripe / Sentry / другое). Список справочный — попадёт в .env.example и в комментарий к BL-001. Если ничего — none.
5. Работа с user data? — yes / no. Это любые пользовательские данные: профили, контент пользователя, сообщения, email/telegram-чаты, транзакции. Если yes — обязательно подключаем extension multi-user-base (см. секцию «Identity & PII rules»). Это не «потом докрутим» — потом стоит недели работы.

Шаг 3 — preview + approve

Перед записью — плоский список файлов, которые скилл создаст:

<project-root>/
├── CLAUDE.md
├── README.md
├── DEVELOPMENT.md
├── CHANGELOG.md
├── incidents.md
├── .gitignore
├── .env.example
├── rfc/_README.md
├── docs/decisions/_README.md
├── private/backlog.base                  # Obsidian Bases view
├── private/backlog/_README.md            # конвенции: frontmatter, статусы, теги версий
├── private/backlog/BL-1.md               # первый таск (scaffold), in_progress
├── package.json                          (если node-cli)
├── engine/index.js                       (если node-cli)
├── engine/index.test.js                  (если node-cli)
├── pyproject.toml                        (если python-mcp)
├── server.py                             (если python-mcp)
└── tests/test_smoke.py                   (если python-mcp)

Жду явного «ok» от пользователя.

Шаг 4 — запись

По approve:

0. Pre-flight check. До любых mkdir / write:
   • git --version отвечает (git установлен).
   • git config --get user.name и git config --get user.email оба возвращают значение. Если что-то из этого не выполнено — отказ с понятным сообщением («настрой git config --global user.email … и попробуй заново»). Никаких файлов не создаём, пока pre-flight красный — иначе получим скаффолд без коммита и тупик в следующем запуске («есть CLAUDE.md, отказ»).
1. mkdir -p <project-root> если не существует. Запомним флаг created_root = (true | false) — пригодится для отката.
2. Для каждого файла из templates/base/ (и выбранных templates/extensions/<name>/):
   • читаем шаблон,
   • подменяем плейсхолдеры (см. ниже),
   • пишем в <project-root>/<relative-path> без .tpl в имени.
   • исключение: файл README.md в корне каждого templates/extensions/<name>/ — это документация самого extension'а (для скилла, не для проекта). Не копируется в проект.
   • запоминаем список записанных файлов (created_files[]) — для отката.
3. Sanity-check: grep -l '{{' <created_files[]> (только по только-что-записанным файлам, не по всему каталогу — иначе ловим ложные срабатывания на _README.md-примерах). Если что-то осталось — error и откат:
   • fresh-mode (created_root = true): rm -rf всего каталога.
   • extension-mode (created_root = false): удаляем только created_files[], не трогая ничего другого. Никогда не удаляем целиком чужой каталог.
4. cd <project-root> → git init → git add . → git commit -m "scaffold from scaffold-project v{{SCAFFOLD_VERSION}}".
5. Спросить про push в origin (по правилу из workspace-CLAUDE.md «после каждого коммита спрашивать про push»). Если remote ещё нет — предложить gh repo create (с подтверждением).

Плейсхолдеры

Подмена — простой текстовый replaceAll по содержимому файла.

Шаг 5 — после scaffold

После первого коммита Claude:

1. Резюмирует что создано (файлы, какие extensions подключены).
2. Указывает на private/backlog/BL-1.md как первую задачу (in_progress, scaffold). Открыть private/backlog.base в Obsidian — увидишь backlog как таблицу с view'ми Active / Archived / Cards.
3. Напоминает: «дальше работаем через dev-workflow. Все M/L задачи — через RFC, тесты, code-review».

Back-fill mode — добавить дев-обвязку в существующий проект

Режим для проектов, у которых уже есть CLAUDE.md и свой контент, но нет (или есть не вся) дев-обвязка: private/backlog/, backlog.base, rfc/, incidents.md, CHANGELOG.md. Скилл добавляет недостающее из тех же templates/base/, чтобы формат был один к одному с тем, что получают свежие проекты.

Зачем: раньше Claude в таких проектах делал обвязку руками, сочинял собственные поля в frontmatter, нарушал конвенции и потом приходилось переделывать. Back-fill mode закрывает эту дыру — формат всегда из templates, ничего не сочиняется.

Когда триггерится

• Триггер-фраза: «причеши проект», «оформи как dev-проект», «back-fill бэклог», «добавь дев-обвязку», /scaffold-project --backfill.
• Каталог: CLAUDE.md уже существует (иначе это fresh-init, не back-fill).

Что back-fill делает (scope)