# Claude Md

Створення або оновлення файлів CLAUDE.md відповідно до найкращих практик для...

- Repository: https://github.com/luongnv89/claude-howto (46363 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add luongnv89/claude-howto --skill claude-md -g -a claude-code -y`
Codex: `npx skills add luongnv89/claude-howto --skill claude-md -g -a codex -y`
Cursor: `npx skills add luongnv89/claude-howto --skill claude-md -g -a cursor -y`
Gemini CLI: `npx skills add luongnv89/claude-howto --skill claude-md -g -a gemini-cli -y`

## Description

Створення або оновлення файлів CLAUDE.md відповідно до найкращих практик для оптимального онбордингу AI-агента

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

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

```text
$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. Визначити структуру проєкту:
   - Технологічний стек (мови, фреймворки)
   - Тип проєкту (монорепо, окремий додаток, бібліотека)
   - Інструменти розробки (пакетний менеджер, система збірки, тест-раннер)

The rest: https://github.com/luongnv89/claude-howto/blob/HEAD/uk/03-skills/claude-md/SKILL.md