Setup для нового проекта
Этот документ — план установки и настройки нового проекта. Этап 1 — глобально на машину (один раз). Этапы 2–4 — на каждый новый проект.
Перед началом: должен быть выполнен .00-SECURITY-GUARDRAILS.md.
К концу плана:
claude --version
Минимум 2.1.7 для MCP Tool Search. Если ниже — обнови:
npm update -g @anthropic-ai/claude-code
MCP Tool Search включён по умолчанию. Это значит: можно ставить много MCP без context-флуда. Активируется автоматически когда tool definitions превышают 10% контекста, экономия ~85% токенов.
~/.claude/settings.json есть с allowed/denied tools.gitleaks установлен.Если что-то из этого нет — стоп, иди в .00-SECURITY-GUARDRAILS.md.
Выполняется один раз. Если уже сделано — пропусти.
claude
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
Что получаешь: docx, pdf, pptx, xlsx, frontend-design, mcp-builder, brand-guidelines. Все < 2000 токенов, оптимизированы Anthropic'ом, source-available.
Эти 5 MCP — фундамент любого современного workflow с Claude Code в 2026.
1.2.1 Context7 — свежая документация библиотек:
claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp
1.2.2 GitHub MCP — управление репо/PR/issues:
claude mcp add --scope user github -- npx -y @modelcontextprotocol/server-github
Установи GITHUB_PERSONAL_ACCESS_TOKEN в env. Минимальные scope: repo, read:org.
Используй fine-grained token, не classic.
1.2.3 Filesystem MCP — надёжные файловые операции:
claude mcp add --scope user filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/projects
~/projects — корневая директория твоих проектов. Filesystem MCP получает
доступ только к ней, не ко всему диску.
1.2.4 Sequential Thinking MCP — для архитектурных решений:
claude mcp add --scope user sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking
Активируется агентом сам когда задача требует структурного мышления (архитектура, debugging, trade-off-анализ). Полезен в discussion-фазе GSD.
1.2.5 Memory Bank MCP — knowledge graph между сессиями:
claude mcp add --scope user memory -- npx -y @modelcontextprotocol/server-memory
Хранит факты о тебе и твоих проектах между сессиями. Альтернатива встроенной памяти Claude.ai для тех, кто работает через CLI.
1.3.1 agent-inbox — disposable email для тестирования auth-флоу:
npx gsd-agent-inbox
Ставь если будешь делать SaaS / любой продукт с email-верификацией.
1.3.2 gsd-browser — браузерная автоматизация через CDP:
curl -fsSL https://raw.githubusercontent.com/gsd-build/gsd-browser/main/install.sh | bash
Альтернатива — Playwright MCP:
claude mcp add --scope user playwright -- npx -y @playwright/mcp
Правило выбора: - gsd-browser — если нужен single-binary без Node.js рантайма (CI, Docker). - Playwright MCP — если нужна экосистема Playwright (test runners, recorder). - Оба сразу не нужно.
См. .04-COST-MONITORING-SETUP.md. Минимум:
npm install -g cc-usage
cc-usage --watch
Покажет per-session расход токенов. Запускай в отдельном терминале во время execute-фаз.
Вариант A — v1 + agent-rules:
npx get-shit-done-cc@latest --claude --global
Останься, если PCAM/GRACE-чекпоинты — твой обязательный workflow.
Вариант B — переход на v2 (gsd-pi):
npm install -g gsd-pi@latest
gsd
/login
Используй API-ключ, не OAuth от Claude Max / Gemini / Copilot. См. SECURITY-GUARDRAILS этап 7.1.
Если не уверен — оставайся на v1. Решение по миграции есть отдельно
в .02-EXISTING-PROJECT-UPGRADE.md.
claude mcp list
Должен показать минимум: context7, github, filesystem, sequential-thinking, memory, agent-inbox (если поставлен), playwright или gsd-browser (если поставлен).
/plugin list
Должен показать установленные skills из anthropic-agent-skills.
Заполни перед запуском GSD. Это вход для discussion-phase и для выбора правильного AGENTS.md шаблона.
Тип продукта (выбери один): - [ ] SaaS / веб-сервис - [ ] Desktop-софт (Electron / Tauri) - [ ] CLI / terminal tool - [ ] Library / SDK / framework - [ ] Plugin / extension (VSCode / Chrome / Figma / Obsidian) - [ ] Mobile app (PWA / React Native / native) - [ ] API-сервис / headless backend - [ ] Internal tool / automation - [ ] Data product (ETL / dashboards) - [ ] AI-агент / skill / prompt-артефакт - [ ] Embedded / on-device
Тип ценности (выбери все применимые): - [ ] Прямая выручка (платящий пользователь) - [ ] Экономия времени оператора - [ ] Снятие риска (security / compliance / надёжность) - [ ] Unlock — новая возможность
Distribution-стратегия: - SaaS → VPS + домен + auto-update. - Desktop / Mobile → подпись, сторы, авто-обновления. - CLI / Library → npm / PyPI / cargo. - Plugin → маркетплейс хост-приложения. - Internal / Automation → своя инфра, обычно высокий fit.
Ограничения (отметь применимые): - [ ] ФЗ-152 (ПДн) - [ ] Маркировка ИИ - [ ] ОФД (онлайн-кассы) - [ ] Open-source-only стек - [ ] Self-hosted only - [ ] Российские провайдеры приоритет
mkdir <project-name>
cd <project-name>
git init
git config core.hooksPath .git/hooks # для pre-commit gitleaks Установи pre-commit (см. SECURITY-GUARDRAILS этап 2.2).
Выбери шаблон из .03-AGENTS-TEMPLATES.md соответствующий классу продукта
из 2.0. Скопируй в корень проекта:
cp ~/.claude/templates/AGENTS-<TYPE>.md ./AGENTS.md
Заполни плейсхолдеры (название проекта, специфичные конвенции).
На v1:
claude
/gsd-new-project
На v2:
gsd
/gsd
GSD сам задаст вопросы. Используй заполненную классификацию из 2.0 как опору. Sequential Thinking MCP активируется автоматически когда агент анализирует архитектурные trade-offs.
Если у тебя установлен skill stack-selector (личный) — упомяни его явно:
«используй stack-selector skill для выбора стека под этот проект».
Skill уже учитывает ограничения соло-фаундера, российскую инфраструктуру,
self-hosted, Go/Python приоритеты.
Если делаешь специфичный AI-продукт (например, маркетплейс LLM-моделей) —
упомяни skill aigate если он у тебя есть.
git add AGENTS.md .planning/ # или .gsd/
git commit -m "chore: initial GSD setup with AGENTS.md and discussion" На v1:
/gsd-research-project
На v2: интегрирован в planning, отдельной команды нет.
Context7 подтянет актуальные доки. Если у тебя стек на момент research — агент сравнит с тем, что в твоей training data, и сообщит про deprecated API.
Milestone = 4–10 slices. Slice = одна demoable vertical capability. Task = context-window-sized unit.
Iron rule v2: task должен влезать в одно контекстное окно. Если не влезает — это две задачи. Декомпозируй до того, как делегируешь.
На v1: /gsd-plan-phase На v2: /gsd plan
В AGENTS.md уже должен быть блок про подключённые MCP (из шаблона).
Если шаблон не использовал — добавь:
## Подключённые MCP-инструменты
ОБЯЗАТЕЛЬНЫЕ (используй проактивно, не жди явного указания):
- **Context7** — ПЕРЕД написанием кода с любой библиотекой проверь
актуальный API. Особенно для быстро меняющихся фреймворков.
- **Sequential Thinking** — ДЛЯ архитектурных решений, debugging
сложных проблем, выбора между альтернативами.
- **Memory Bank** — ДЛЯ запоминания решений, конвенций проекта,
декаких архитектурных фактов между сессиями.
- **GitHub MCP** — ДЛЯ работы с issues, PR, code review без переключения
контекста на веб-интерфейс.
- **Filesystem MCP** — ДЛЯ операций над несколькими файлами одновременно.
ПО КЕЙСУ:
- **agent-inbox** — для email-верификации в тестах auth-флоу.
НЕ проси оператора получать письма.
- **gsd-browser / Playwright** — для UI-тестов, проверки форм,
visual regression. НЕ предлагай альтернативы.
На v1: /gsd-execute-phase На v2:
/gsd # step mode, по одному unit
/gsd auto # autonomous, walk away
Правило для auto mode: только если SECURITY-GUARDRAILS полностью выполнен и pre-commit hooks работают. Иначе step mode.
В отдельном терминале:
cc-usage --watch
Если за один slice тратится больше ожидаемого — стоп, разбирайся с причиной (плохой план, перегруженный AGENTS.md, агент уходит в циклы).
claude mcp list показывает 5+ MCP).API_KEY=sk-test123 — должен заблокировать)..planning/ (v1) или .gsd/ (v2) с PROJECT.md, ROADMAP.md.S01-PLAN.md)./gsd-*) и v2-команды (/gsd ...) в одном проекте.