---
name: Project Setup
slug: project-setup
category: DevOps
description: Project Setup installs the Claude Code Starter framework into the current folder and detects whether the project is code, content, or hybrid. Use it when starting a new project or upgrading an existing framework setup.
github: "https://github.com/alexeykrol/claude-code-starter/tree/main/templates/global/skills/setup-project"
language: Shell
stars: 192
forks: 61
install: "npx degit https://github.com/alexeykrol/claude-code-starter/tree/main/templates/global/skills/setup-project ~/.claude/skills/setup-project"
installs_to: ~/.claude/skills/setup-project
source_path: templates/global/skills/setup-project/SKILL.md
collection_size: 16
category_size: 1013
collection_url: "https://dirskills.com/collections/alexeykrol/claude-code-starter"
added: 2026-09-06T05:19:16.975Z
last_synced: 2026-09-06T05:19:16.975Z
canonical_url: "https://dirskills.com/skills/project-setup"
---

# Project Setup

Project Setup installs the Claude Code Starter framework into the current folder and detects whether the project is code, content, or hybrid. Use it when starting a new project or upgrading an existing framework setup.

**Install:**

```bash
npx degit https://github.com/alexeykrol/claude-code-starter/tree/main/templates/global/skills/setup-project ~/.claude/skills/setup-project
```

## README

# Skill: Setup Project (Framework Bootstrap)

## Назначение

Установить Claude Code Starter framework в текущую рабочую папку. Авто-определяет, что это за проект (код, контент, гибрид), создаёт минимально необходимую структуру, не повреждая существующие файлы.

## Когда применяется

- Пользователь сказал `/setup-project`, `setup project`, `bootstrap`, `поставь фреймворк`, `установи фреймворк`, `начать проект`, `инициализировать проект`, `новый проект`
- Пользователь работает в свежесозданной папке без `CLAUDE.md` и `.claude/`, и просит начать работу
- В проекте есть устаревший framework и пользователь хочет обновиться

**НЕ путать** со встроенной командой Claude Code `/setup-project` — та делает совсем другое (генерирует документационный CLAUDE.md). Этот skill — про установку framework инфраструктуры (rules, skills, agents, hooks, manifest).

## Алгоритм

### 1. Найти framework source

Проверь по порядку:

```bash
# Step 1: cached source path
if [ -f ~/.claude/framework-source-path ]; then
    FRAMEWORK_PATH=$(cat ~/.claude/framework-source-path)
fi

# Step 2: common locations
for candidate in "$FRAMEWORK_PATH" "$HOME/Code/Project_init" "$HOME/Code/claude-code-starter" "$HOME/.claude/framework-source"; do
    if [ -n "$candidate" ] && [ -f "$candidate/init-project.sh" ] && [ -f "$candidate/scripts/lib/install_common.sh" ]; then
        FRAMEWORK_PATH="$candidate"
        break
    fi
done

# Step 3: clone if missing
if [ -z "$FRAMEWORK_PATH" ]; then
    git clone https://github.com/alexeykrol/claude-code-starter.git ~/.claude/framework-source/
    FRAMEWORK_PATH=~/.claude/framework-source
fi
```

Запиши найденный путь обратно: `echo "$FRAMEWORK_PATH" > ~/.claude/framework-source-path`.

### 2. Проверить состояние текущей папки

```bash
PROJECT_DIR="$(pwd)"
HAS_FRAMEWORK="no"
[ -d ".claude" ] && [ -d ".claude/rules" ] && HAS_FRAMEWORK="yes"
HAS_CLAUDE_MD="no"
[ -f "CLAUDE.md" ] && HAS_CLAUDE_MD="yes"
TOTAL_FILES=$(find . -maxdepth 2 -type f -not -path './.git/*' 2>/dev/null | wc -l | tr -d ' ')
```

### 3. Запустить установщик

Просто вызови основной installer — он сам делает auto-detect, backup и safe merge:

```bash
bash "$FRAMEWORK_PATH/init-project.sh"
```

Если установка хочет имя проекта (свежая папка) — installer возьмёт имя текущей директории. Тип проекта определит автоматически по содержимому.

### 4. После установки

Прочитай `manifest.md` и сообщи пользователю одной строкой что получилось:

```text
✅ Framework установлен: <project_type> / <content_type>
   Backup в .claude/backup-<TIMESTAMP>/
   Откат: bash init-project.sh --rollback
   Дальше: отредактируй CLAUDE.md под проект и скажи /start
```

## Граничные случаи

### Папка уже с framework

Если `HAS_FRAMEWORK=yes`, не запускай install заново молча. Спроси одним вопросом:
- «В папке уже стоит framework. Обновить аддитивно (migrate)? [Y/n]»
- При Y — запусти `bash "$FRAMEWORK_PATH/scripts/migrate.sh" --template "$FRAMEWORK_PATH"`
- При n — ничего не делай, отчитайся

### Тяжёлый конфликт CLAUDE.md

Если установщик завершился с exit 2 — он уже записал `.claude/CLAUDE.md.merge-proposal.md` и НЕ менял файлы. Покажи пользователю короткое резюме предложения и команду применения:
```text
⚠️ Установка остановлена — конфликт в CLAUDE.md.
Я подготовил решение в .claude/CLAUDE.md.merge-proposal.md.
Применить:  bash init-project.sh --apply-proposal
```

### Не нашли git

Installer сам предлагает `git init` если репо нет. Это OK — пропусти, продолжи.

### Чего НЕ делать

- Не запускай установку молча в большом проекте, где много файлов и нет .git — сначала покажи что собираешься делать
- Не переписывай существующий CLAUDE.md «вручную» — это работа `merge_claude_md.py`
- Не задавай больше одного вопроса. Auto-detect должен покрывать 95% случаев. Если не уверен — выбери сам и скажи пользователю что выбрал

## Output

Всегда коротко: что было до, что добавлено, путь к backup, следующее действие.