Суть урока
Структура папок — это не организационный вопрос, это архитектурный: Claude Code думает о твоём проекте ровно так, как устроены твои папки, и правильная иерархия умножает качество работы агентов.
Ключевые концепции
- PARA — система из 4 категорий, охватывающая 100% любой информации
- Структура папок = архитектура мышления: как организовано, так и думается
- Claude Code читает структуру через
CLAUDE.md— это карта для агента - Золотые правила именования файлов делают поиск AI точнее
- Flat vs deep hierarchy — у каждого подхода свои случаи применения
Теория
PARA система — четыре ящика для всего на свете
PARA разработана Тиаго Форте и стала стандартом для «второго мозга». Суть: любая единица информации попадает в один из четырёх ящиков.
| Буква | Название | Что туда идёт | Пример |
|---|---|---|---|
| P | Projects | Активные проекты с дедлайном | Запуск нового продукта к 1 июня |
| A | Areas | Сферы ответственности без дедлайна | Здоровье, финансы, маркетинг |
| R | Resources | Справочные материалы | Гайды, шаблоны, исследования |
| A | Archive | Завершённое и неактуальное | Старые проекты, черновики |
Ключевой принцип PARA: информация организована не по теме (как в школьных тетрадях), а по степени активности. Это важно для AI: агент понимает, что в Projects — живое и важное, в Archive — мёртвое и необязательное.
Почему структура папок = архитектура мышления
Структура папок влияет на то, как ты (и твои агенты) принимаете решения.
Плохая структура:
/projects/
/my_business/
idea1.txt
old_idea.txt
notes_final.docx
notes_final_v2.docx
notes_REALLY_final.docx
random_stuff/
...Claude в этой структуре: «Я не понимаю, что здесь текущее, что устаревшее, что важное. Буду гадать».
Хорошая структура (PARA):
/projects/
/launch-product-x/ ← активный проект
BRIEF.md ← контекст для Claude
/research/
/drafts/
/final/
/areas/
/marketing/ ← постоянная сфера
/finance/
/resources/
/templates/ ← переиспользуемое
/guides/
/archive/
/2025-product-y/ ← завершённоеClaude в этой структуре: «Вижу активные проекты, справочники и архив. Буду работать в /projects/launch-product-x/, использовать шаблоны из /resources/templates/».
Как Claude Code понимает структуру папок через CLAUDE.md
Claude Code при запуске читает CLAUDE.md в корне проекта. Это — инструкция для агента: что где лежит, как называется, какие правила. Подробно про сам файл: CLAUDE.md — системный промпт твоего проекта. Создать заготовку можно командой /init. Кроме CLAUDE.md, Claude Code читает AGENTS.md, правила из папки .claude/rules/ и ведёт собственную память (auto memory), управлять ей можно командой /memory.
Пример CLAUDE.md для PARA-структуры:
# Project Context ## Structure - `/projects/` — активные проекты (каждый в отдельной папке с BRIEF.md) - `/areas/` — постоянные сферы ответственности - `/resources/` — шаблоны, гайды, справочники - `/archive/` — завершённые проекты (не редактировать) ## Naming Convention - Папки: kebab-case, всегда строчные (product-launch, not ProductLaunch) - Файлы: kebab-case + дата если версионируется (report-2026-10.md) - ЗАГЛАВНЫЕ: только CLAUDE.md, README.md, BRIEF.md (важные инструкции) ## Rules - Никогда не редактируй `/archive/` - Черновики сохраняй в папке `/drafts/` внутри проекта - Финальные версии — в `/final/` без суффиксов _v2, _final
С таким CLAUDE.md агент работает чётко: знает где искать, куда сохранять, что не трогать.
Золотые правила именования файлов для AI
AI-агенты — как поисковые системы: они лучше работают с предсказуемыми именами.
Правило 1: kebab-case везде
✅ market-research-2026.md ❌ Market Research 2026.md ❌ marketResearch2026.md ❌ market_research_2026.md
Правило 2: Дата в начале для временных файлов
✅ 2026-10-01-competitor-analysis.md ❌ competitor-analysis-may.md
Даты в начале = хронологическая сортировка автоматически.
Правило 3: Глагол или существительное — не «финал»
✅ landing-page-copy.md ✅ email-sequence-onboarding.md ❌ landing_FINAL_v3_use_this.md ❌ email_copy_new2.docx
Правило 4: ЗАГЛАВНЫЕ только для главных инструкций
CLAUDE.md ← агент читает первым
README.md ← человек читает первым
BRIEF.md ← контекст проектаПравило 5: Без пробелов в именах папок
✅ /my-business/
❌ /My Business/ ← ломает bash-команды, путает агентовПример структуры для AI-предпринимателя
~/workspace/
├── CLAUDE.md ← главная инструкция
├── projects/
│ ├── saas-tool-launch/
│ │ ├── BRIEF.md ← контекст для Claude
│ │ ├── research/
│ │ │ └── 2026-09-competitors.md
│ │ ├── drafts/
│ │ │ └── landing-page-v1.md
│ │ └── final/
│ │ └── landing-page.md
│ └── youtube-channel/
│ ├── BRIEF.md
│ └── content-calendar.md
├── areas/
│ ├── marketing/
│ │ ├── brand-voice.md ← Claude читает перед написанием
│ │ └── target-audience.md
│ ├── finance/
│ │ └── budget-2026.md
│ └── tech-stack/
│ └── tools-and-keys.md
├── resources/
│ ├── templates/
│ │ ├── blog-post.md
│ │ ├── email-sequence.md
│ │ └── project-brief.md
│ └── guides/
│ └── claude-code-cheatsheet.md
└── archive/
└── 2025-old-project/Flat vs Deep Hierarchy — что лучше для AI-систем
Flat (плоская) структура:
/projects/
project-a-research.md
project-a-draft.md
project-b-research.md✅ Хорошо для: небольших проектов, быстрого поиска, до 50 файлов ❌ Плохо для: больших систем, совместной работы, масштабирования
Deep (глубокая) структура:
/projects/
/project-a/
/phase-1/
/research/
/primary/
/interviews/✅ Хорошо для: больших проектов с множеством этапов ❌ Плохо для: каждодневной работы (слишком много шагов), агенту сложнее ориентироваться на глубине 4+ уровней
Правило: максимум 3 уровня вложенности
/root/
/category/ ← уровень 1
/project/ ← уровень 2
/file.md ← уровень 3Три уровня достаточно для любого соло-проекта. Глубже — только для enterprise с командами.
Практика
- Посмотри свою текущую структуру честно:
find ~/workspace -maxdepth 3 -type d | head -30
# или если нет workspace:
ls -la ~/Desktop- Создай PARA-структуру для своего главного проекта:
mkdir -p ~/workspace/{projects,areas,resources,archive}
mkdir -p ~/workspace/projects/мой-проект/{research,drafts,final}
mkdir -p ~/workspace/areas/{marketing,finance}
mkdir -p ~/workspace/resources/{templates,guides}Создай
CLAUDE.mdв корне~/workspace/(возьми пример из урока, адаптируй под себя)Создай
BRIEF.mdв папке своего активного проекта:
# Project Brief: [Название]
## Цель
[Что мы создаём и зачем]
## Аудитория
[Для кого]
## Дедлайн
[Когда]
## Контекст для Claude
[Что Claude должен знать перед началом работы]
## Ограничения
[Что нельзя, стиль, бюджет]- Запусти Claude Code в папке
~/workspace/и проверь, что он правильно понимает структуру:
Прочитай CLAUDE.md и объясни мне: если я попрошу тебя написать черновик лендинга для проекта X, куда ты его сохранишь и почему?
Инструменты и ресурсы
- Building a Second Brain (книга) — оригинальная книга Тиаго Форте о PARA
- PARA Method (статья) — подробное объяснение системы бесплатно
- Obsidian — локальный второй мозг с PARA-плагинами
- Notion — PARA в облаке с командным доступом
Ключевые выводы
PARA — это не система хранения файлов, это система хранения внимания: Projects требуют действий сейчас, Areas — регулярного внимания, Resources — используются по необходимости, Archive — для истории.
Claude Code работает настолько хорошо, насколько ему понятна структура проекта —
CLAUDE.mdэто карта для агента, без неё он как новый сотрудник в первый день без оргструктуры.
Три уровня вложенности и kebab-case именование — два правила, которые делают работу с AI-агентами ощутимо точнее при минимуме усилий.
Что дальше
→ AI копирайтинг через промпт-конвейер — пишем в своём голосе
Отметка хранится только в этом браузере и никуда не отправляется. Мой прогресс