project-launcher

Простым языком

Скачал чужой проект или вернулся к своему после перерыва — и не помнишь как его запустить? Этот скилл разбирается за тебя. Он читает все файлы проекта и сам выполняет нужные команды по порядку.

Скажи Claude: «Я в папке проекта, помоги запустить» — и он установит все нужные программы, запустит базу данных и откроет сайт. Никакого гугла, никаких ошибок.

Что делает

Скилл project-launcher запускает существующий проект в локальной среде или на сервере: устанавливает зависимости, поднимает Docker-контейнеры, применяет миграции, запускает dev-сервер.

Отличается от new-project: там создаём с нуля, здесь — поднимаем уже написанный проект. Claude читает README.md, docker-compose.yml, package.json и определяет правильный порядок команд.

Когда использовать

• Клонировал репозиторий и не знаешь с чего начать
• Возвращаешься к проекту после долгого перерыва
• Поднимаешь проект на новом сервере или VPS
• После git pull нужно применить миграции и перезапустить сервисы
• Настраиваешь dev-окружение для нового разработчика в команде

Как работает — пошагово

1. Claude читает README.md, docker-compose.yml, package.json / pyproject.toml
2. Определяет стек и порядок запуска (БД → бэкенд → фронтенд)
3. Проверяет .env — если нет, создаёт из .env.example и просит заполнить
4. Выполняет установку зависимостей: npm install, pip install, go mod download
5. Поднимает Docker-контейнеры через docker compose up -d
6. Применяет миграции: prisma migrate deploy, alembic upgrade head
7. Запускает dev-сервер и выводит URL для проверки

Промпты для Claude

Я склонировал проект stackovervibe. Помоги запустить локально.
ОС: macOS, Docker установлен, Node.js 20.
Порты 3000 и 5432 свободны.

Поднимаю проект на новом VPS (Ubuntu 22.04).
Всё уже склонировано в ~/myproject.
Нужно: установить зависимости, настроить .env, запустить через Docker.

Пример сессии запуска

$ claude "Запусти проект, я в папке /home/claude/myproject"

[Claude читает файлы...]

1. Найден docker-compose.yml (app + postgres)
2. .env отсутствует → создаю из .env.example
   ! Заполни: DATABASE_URL, SECRET_KEY, BOT_TOKEN
3. docker compose up -d --build
4. Жду готовности postgres...
5. npx prisma migrate deploy
6. npm run dev

✅ Проект запущен: http://localhost:3000

Автоматизация

Создай скрипт launch.sh в корне проекта:

#!/bin/bash
# launch.sh — быстрый запуск проекта
set -e

echo "Проверяю .env..."
[ ! -f .env ] && cp .env.example .env && echo "Заполни .env!" && exit 1

echo "Запускаю контейнеры..."
docker compose up -d --build

echo "Применяю миграции..."
docker compose exec app npx prisma migrate deploy

echo "✅ Готово: http://localhost:3000"

Частые вопросы

Что если не хватает .env переменных?

Claude остановится и явно укажет, какие переменные нужно заполнить, и объяснит как их получить (например, токен бота — через @BotFather).

Работает ли без Docker?

Да. Если Docker не нужен, Claude запустит сервисы нативно через npm run dev или python main.py. Просто укажи "без Docker" в задаче.