Задача: что решает этот промпт

В 2026 году vibe coding стал повседневной практикой: разработчики описывают задачи на естественном языке, а Claude, Cursor или Codex пишут код. Но AI-агент без контекста — как новый разработчик в первый день без онбординга: он будет задавать очевидные вопросы, нарушать конвенции и генерировать «чужой» код.

Решение — файл CLAUDE.md (или AGENTS.md, GEMINI.md в зависимости от агента). Это текстовый файл в корне проекта, который агент читает автоматически при каждой сессии. Правильно написанный CLAUDE.md сокращает количество правок на 30–40% и убирает необходимость объяснять одно и то же снова и снова.

Проблема: написать хороший CLAUDE.md с нуля сложно. Этот промпт делает это за вас.

ℹ Что такое CLAUDE.md?
CLAUDE.md — файл инструкций для Claude Code и других AI-агентов. Он читается автоматически в начале каждой сессии и задаёт контекст: технологический стек, соглашения, запреты, архитектуру. Аналоги: AGENTS.md (OpenAI Codex), GEMINI.md, .cursorrules (Cursor).

Для кого

АудиторияЗачем нужен промпт
Разработчики-одиночкиНастроить агента под свой стиль и стек один раз
КомандыЕдиный контекст для всех, кто работает с AI-агентами
Vibe codersУбрать лишние итерации и объяснения агенту
Tech leadsЗафиксировать архитектурные решения и запреты
No-code / low-codeПонять, как объяснить агенту структуру проекта

Как это работает


graph TD
    A[Ты описываешь проект агенту] --> B[Агент задаёт уточняющие вопросы]
    B --> C[Агент генерирует CLAUDE.md]
    C --> D[Ты правишь под себя]
    D --> E[Кладёшь файл в корень проекта]
    E --> F[Каждая новая сессия — агент уже в контексте]
    F --> G[Меньше объяснений, лучше код]

Промпт

Ты — опытный tech lead и эксперт по AI-assisted разработке.
Твоя задача — помочь мне создать файл CLAUDE.md для моего проекта.

Сначала задай мне следующие вопросы по одному (жди моего ответа перед следующим вопросом):

1. Опиши проект в 2-3 предложениях: что делает, кто пользователи, на каком этапе.
2. Технологический стек: языки, фреймворки, базы данных, облако, CI/CD.
3. Структура репозитория: монорепо или несколько репо? Как организованы директории?
4. Стиль кода: есть ли линтеры, форматтеры, соглашения об именовании?
5. Что агент НИКОГДА не должен делать? (например: не коммитить секреты, не менять схему БД без миграций, не удалять файлы без подтверждения)
6. Какие команды агент должен знать? (тесты, сборка, деплой, dev-сервер)
7. Есть ли специфика окружения? (Windows/Mac/Linux, Docker, WSL, env-файлы)
8. Что чаще всего идёт не так, когда агент работает с этим проектом?

После получения всех ответов сгенерируй CLAUDE.md со следующей структурой:

# CLAUDE.md

## Project Overview
[Краткое описание проекта]

## Tech Stack
[Стек с версиями где известно]

## Architecture
[Структура директорий и ключевые решения]

## Commands
```bash
# Основные команды

Code Conventions

[Стиль, линтеры, форматтеры, паттерны]

Critical Rules (NEVER do)

[Список запретов с объяснениями]

Common Pitfalls

[Что часто ломается и как этого избежать]

Working with This Codebase

[Специфические советы для этого проекта]

Требования к файлу:

  • Не более 200 строк (иначе агент читает медленнее)
  • Конкретные примеры, не абстрактные советы
  • Команды — рабочие, с флагами
  • Запреты — с объяснением причины
  • Тон — как инструкция для умного джуна в первый день






  
💡 Как использовать

  
Вставь промпт в новый чат с Claude, ChatGPT или Gemini. Отвечай на вопросы вдумчиво — чем точнее ответы, тем полезнее итоговый файл. После генерации пройдись по файлу и удали нерелевантные секции.





---

## Пример результата

Вот фрагмент CLAUDE.md, который генерирует промпт для Python-сервиса с FastAPI:

```markdown
# CLAUDE.md

## Project Overview
REST API для агрегации новостей с ML-категоризацией. Python 3.12, FastAPI.
Production на Railway. ~50k запросов/день. Команда: 2 разработчика.

## Tech Stack
- Python 3.12, FastAPI 0.115, Pydantic v2
- PostgreSQL 16 (asyncpg), Redis 7 (кэш + очереди)
- Alembic для миграций, Celery для воркеров
- Docker Compose для локальной разработки
- Railway (прод), GitHub Actions (CI)

## Commands
```bash
# Локальный запуск
docker compose up -d

# Тесты (ВСЕГДА перед коммитом)
pytest tests/ -v --cov=app --cov-report=term-missing

# Новая миграция
alembic revision --autogenerate -m "описание"
alembic upgrade head

# Линтинг
ruff check . && mypy app/

Critical Rules

  • НИКОГДА не коммить .env файлы или секреты
  • НИКОГДА не писать SQL вручную — только через SQLAlchemy ORM
  • НИКОГДА не менять схему БД без миграции Alembic
  • НИКОГДА не делать синхронные I/O операции в async-функциях

> Хороший CLAUDE.md — это онбординг-документ для ИИ. Пишите его так, как будто объясняете проект умному разработчику, который не знает ни слова о вашем коде, но знает всё об инструментах.

---

## Вариации и настройки

### По типу проекта

| Тип проекта | Что добавить в CLAUDE.md |
|-------------|--------------------------|
| **Frontend (React/Vue)** | Структура компонентов, дизайн-система, storybook, accessibility-требования |
| **Backend API** | Схема эндпоинтов, правила валидации, политика ошибок, rate limits |
| **Монорепо** | Карта пакетов, workspace-команды, правила зависимостей между пакетами |
| **Data / ML** | Структура датасетов, версионирование моделей, правила воспроизводимости |
| **Mobile (Flutter/RN)** | Поддерживаемые платформы, deep links, push-уведомления, permissions |

### Версии промпта под разных агентов

**Для Cursor (.cursorrules):**
Добавь в промпт: «Адаптируй под формат .cursorrules: используй секции @codebase, @docs, укажи языки для автодополнения»

**Для OpenAI Codex (AGENTS.md):**
Добавь: «Используй формат AGENTS.md с секциями Environment, Testing, Style Guide»

**Для командного использования:**
Добавь: «Включи секцию "Onboarding for new developers" с первыми шагами»






  
⚠ Не перегружай файл

  
CLAUDE.md более 200 строк снижает эффективность: агент уделяет меньше внимания каждому правилу. Если нужно больше контекста — разбей на несколько файлов и укажи в основном CLAUDE.md ссылки на них.





---

## Советы по улучшению

### 1. Итерируй вместе с агентом

После первой генерации попроси агента прочитать получившийся CLAUDE.md и задать уточняющие вопросы: «Прочитай этот CLAUDE.md и скажи, чего тебе не хватает для эффективной работы с проектом».

### 2. Добавь раздел «Что часто ломается»

Этот раздел — самый ценный. Запиши все случаи, когда агент делал что-то не то, и зафиксируй их как правила:

```markdown
## Common Pitfalls
- При работе с датами ВСЕГДА использовать timezone-aware объекты (UTC)
- Celery-задачи должны быть идемпотентными — агент часто это игнорирует
- Не добавлять print() в продакшн-код, только logging

3. Версионируй CLAUDE.md

Коммить изменения CLAUDE.md с осмысленными сообщениями. Через месяц будет видно, как эволюционировало взаимодействие с агентом.

4. Тестируй в новой сессии

После обновления CLAUDE.md открой новый чат и попроси агента пересказать, что он понял о проекте. Это покажет пробелы.

📝 Быстрый тест качества CLAUDE.md
Откройте новую сессию с агентом и напишите: «Не смотря на код, расскажи, что ты знаешь о проекте из CLAUDE.md». Если агент путается в стеке или не знает ключевых запретов — файл нужно доработать.

Где хранить CLAUDE.md

project-root/
├── CLAUDE.md          ← основной файл (читается всегда)
├── src/
│   └── CLAUDE.md      ← контекст только для src/ (опционально)
├── tests/
│   └── CLAUDE.md      ← правила тестирования (опционально)
└── .cursorrules       ← если используешь Cursor

Claude Code читает файлы иерархически: сначала ~/.claude/CLAUDE.md (глобальный), затем корневой, затем директорийные. Это позволяет хранить личные предпочтения глобально, а правила проекта — в репозитории.