Claude Md

Введення користувача

$ARGUMENTS

Ви ПОВИННІ врахувати введення користувача перед продовженням (якщо не порожнє). Користувач може вказати:

• create, створити новий CLAUDE.md з нуля
• update, покращити існуючий CLAUDE.md
• audit, проаналізувати та звітувати про якість поточного CLAUDE.md
• Конкретний шлях для створення/оновлення (напр., src/api/CLAUDE.md для інструкцій, специфічних для каталогу)

Основні принципи

LLM не мають стану: CLAUDE.md, головний файл проєкту, що завантажується в кожну розмову (разом з автоматичною пам'яттю та правилами без обмеження області). Він слугує головним документом онбордингу AI-агентів у вашу кодову базу.

Золоті правила

1. Менше, краще: Найсучасніші LLM можуть дотримуватись ~150-200 інструкцій. Системний промпт Claude Code вже використовує ~50. Тримайте CLAUDE.md зосередженим та лаконічним.

2. Універсальна застосовність: Включайте лише інформацію, релевантну для КОЖНОЇ сесії. Інструкції для конкретних завдань належать до окремих файлів.

3. Не використовуйте Claude як лінтер: Рекомендації зі стилю роздувають контекст та погіршують дотримання інструкцій. Використовуйте натомість детерміністичні інструменти (prettier, eslint тощо).

4. Ніколи не генеруйте автоматично: CLAUDE.md, найвпливовіша точка AI-системи. Створюйте його вручну з ретельним обмірковуванням.

Потік виконання

1. Аналіз проєкту

Спочатку проаналізуйте поточний стан проєкту:

1. Перевірити наявні файли CLAUDE.md:

   • Кореневий рівень: ./CLAUDE.md або .claude/CLAUDE.md
   • Специфічні для каталогу: **/CLAUDE.md
   • Глобальний конфіг користувача: ~/.claude/CLAUDE.md

2. Визначити структуру проєкту:

   • Технологічний стек (мови, фреймворки)
   • Тип проєкту (монорепо, окремий додаток, бібліотека)
   • Інструменти розробки (пакетний менеджер, система збірки, тест-раннер)