Анатомия .claude/
папки

Каждая сессия — чистый лист

Открываешь Claude Code утром — а он не помнит, что вы делали вчера. Это не баг. У модели нет долговременной памяти между сессиями. Контекст обнуляется.

Без структуры это значит: ты заново объясняешь, какие у тебя API-ключи, какой стиль кода в проекте, какие переменные именуются как, и какие решения вы уже приняли по архитектуре. Каждый. Раз.

Решение — в самом Claude Code. Папка .claude/ внутри проекта подгружается автоматически при старте каждой сессии. Что положишь туда — Claude знает с первой секунды.

Этот пост — карта. Семь файлов и папок внутри .claude/ плюс одна папка рядом — memory-bank/. Что делает каждый, как настроить, какие ловушки.

Карта в одной картинке

Claude Code читает .claude/ при каждом старте — это и есть «мозг проекта». Memory-bank рядом — это «что Claude помнит» через сессии.

your-project/
├─ CLAUDE.md              → правила. ≤ 200 строк
├─ CLAUDE.local.md        → личное. в git не идёт
├─ .mcp.json              → MCP-серверы. только в корне
├─ memory-bank/           → память между сессиями
│  ├─ progress.md         → что сделано / в работе
│  ├─ decisions.md        → архитектурные решения
│  └─ insights.md         → грабли, на которые наступал
└─ .claude/                → мозг проекта
   ├─ skills/             → навыки. Claude берёт сам
   ├─ agents/             → суб-агенты, свой контекст
   ├─ commands/           → слэш-команды по имени файла
   ├─ hooks/              → скрипты, всегда срабатывают
   ├─ plugins/            → пакеты агенты+команды+хуки
   ├─ settings.json       → права, модель, реестр хуков
   └─ settings.local.json → личное. в git не идёт

Ниже — каждый файл по делу. Сверху первым — CLAUDE.md, потому что без него остальное полупустое.

CLAUDE.md — правила проекта

Главный файл. Здесь живут правила, которые Claude обязан соблюдать в этом проекте. Без него агент пишет код наугад.

# NotifyMotion — инструкции проекта

## Стандарты
— TypeScript strict, никаких `any`
— @phosphor-icons/react для всех иконок
— тёмная тема по умолчанию

## Архитектура
— Canvas 2D + Zustand для глобального стейта
— WebCodecs + Mediabunny для MP4-экспорта

## Формат коммита
— NM-XXX: суть одной строкой
— Co-Authored-By: Александр

## Никогда не пушить без явного «иди».

memory-bank/ — вторая половина мозга

Если .claude/ = как Claude работает, то memory-bank/ = что Claude помнит между сессиями. Без неё каждый день начинается с чистого листа.

Это не часть Claude Code из коробки — это community-паттерн, который ставится руками. Три файла дают 80% результата:

# Архитектурные решения

## 2026-05-08 · Stripe vs Paddle
Решение: Stripe Connect.
Почему: Paddle не работает в KZ.
Альтернативы пробовали — нет.

## 2026-05-10 · Auth — Supabase
Решение: Supabase Auth + RLS.
Почему: уже есть в стеке,
магические ссылки из коробки.

## Принципы (не правим)
— один экран = один компонент
— стейт только в Zustand store
— никаких prop-drilling глубже 2

skills/ — навыки на тапе

Скилл — это папка с файлом SKILL.md. Внутри — инструкция для Claude по конкретному навыку. Claude сам решает, когда подгрузить: по описанию в frontmatter он матчит запрос пользователя и подхватывает нужный скилл.

---
name: ui-ux-pro-max
description: дизайн на тапе.
  50 стилей, 21 палитра, 50 пар шрифтов
---

# UI/UX Pro Max
Используй при сборке любого UI.

## Когда срабатывать
— пользователь говорит «дизайн» или «UI»
— файл .tsx, .vue, .svelte, .html
— проект — дашборд или SaaS

## Источник
— shadcn/ui MCP для примеров
# Claude подхватит сам.

agents/ — суб-агенты с собственным контекстом

Каждый файл — суб-агент с YAML-frontmatter (имя, описание, набор инструментов, модель). Claude Code делегирует ему задачу через Agent-инструмент. У агента свой контекст — он не съедает токены основной сессии.

---
name: code-reviewer
description: сеньор-ревьюер для PR
tools: Read, Grep, Glob
---

# Code Reviewer
Ты — сеньор-инженер. Без вежливости.

## Проверяй
— баги, которые попадут в прод
— дыры безопасности (auth, SQLi, XSS)
— логику, расходящуюся со спекой
— тесты, которые слишком много мокают

# У агента — свой контекст.

commands/ — слэш-команды

Каждый .md в этой папке становится /имя-файла в чате Claude. Готовый workflow на тапе. Ты решаешь, когда запускать — в отличие от скиллов, которые Claude берёт сам.

---
description: разобрать diff и написать commit
---

# /commit
Запусти `git status` и `git diff --staged`.
Найди *почему*, не *что*.

## Формат
— Subject: 50 символов, повелит. наклонение
— Body: объясни рассуждения
— префикс NM-XXX

## Никогда
— push без подтверждения
— --no-verify

# Слэш-команды = самый быстрый UX.

hooks/ — ограждения

Шелл-скрипты, которые срабатывают автоматически до или после действий Claude. Регистрируются в settings.json. Без вопросов, без исключений.

#!/usr/bin/env bash
# авто-формат каждого файла после Edit

FILE=$(jq -r .tool_input.file_path)

case "$FILE" in
  *.ts|*.tsx|*.js|*.jsx)
    npx prettier --write "$FILE" ;;
  *.py)
    ruff format "$FILE" ;;
  *.go)
    gofmt -w "$FILE" ;;
esac

# срабатывает после каждого Edit

Управление через один файл

plugins/ упаковывает агентов, команды, хуки и MCP-серверы в одну единицу — ставится одной командой и работает везде. settings.json — это главная панель: что Claude разрешено, какая модель, какие хуки активны.

{
  "model": "claude-opus-4-7",
  "permissions": {
    "allow": [
      "Bash(npm run *)", "Bash(git *)",
      "Read", "Edit", "Glob", "Grep"
    ],
    "deny": ["Bash(rm -rf *)"]
  },
  "hooks": {
    "PostToolUse": [
      ".claude/hooks/format-on-save.sh"
    ]
  },
  "outputStyle": "terse",
  "statusLine": ".claude/statusline.sh"
}

Что положить в новый проект

Минимальный набор, чтобы Claude перестал забывать всё с первой сессии. Час работы — окупается за первую же неделю.

# 1. структура папок
mkdir -p .claude/{skills,agents,commands,hooks,plugins} memory-bank

# 2. главный файл правил
touch CLAUDE.md
touch CLAUDE.local.md
echo "CLAUDE.local.md" >> .gitignore

# 3. память между сессиями
touch memory-bank/{progress,decisions,insights}.md

# 4. базовые скиллы от Anthropic
cd .claude/skills/
git clone https://github.com/anthropics/skills

# 5. суб-агент для PR-ревью
cd ../agents/
touch code-reviewer.md  # текст из раздела 06 ↑

# 6. слэш-команда /commit
cd ../commands/
touch commit.md  # текст из раздела 07 ↑

# 7. хук авто-формата
cd ../hooks/
touch format-on-save.sh  # текст из раздела 08 ↑
chmod +x format-on-save.sh

# 8. settings.json — из раздела 09 ↑
cd ..
touch settings.json
touch settings.local.json
echo ".claude/settings.local.json" >> ../../.gitignore

# 9. перезапустить Claude Code в этой папке
claude

После этого первый промпт Claude уже знает, какой у тебя стек, какие правила, кому делегировать ревью и что нельзя пушить без подтверждения. Это и есть пункт Б.