pinecore/.claude/README.md

Knowledge Base Index

Полный индекс базы знаний проекта Pinecore. Все файлы в этой директории коммитятся в репозиторий.

Быстрая навигация

Что нужно	Файл
Я только что открыл проект	architecture/overview.md
Как поднять worker / запустить?	development/commands.md
Какой паттерн использовать?	development/patterns.md
Commit/branch/namespace conventions	development/conventions.md
Как отладить локально	development/testing.md
Ядро, Config, Environment, ContainerFactory	architecture/bootstrap.md
HTTP: Request, Response, Router, Middleware	architecture/http.md
Worker и WorkerRunner	architecture/worker.md
Auth (JWT, AuthMiddleware)	architecture/auth.md
Логирование	architecture/logging.md
ORM (MongoDB)	architecture/orm.md
Console-команды	architecture/console.md
Почему архитектура именно такая	decisions/README.md
Контекст текущей задачи	tasks/active/

Структура директории

.claude/
├── README.md                    # Этот файл — индекс
├── architecture/                # Стабильные архитектурные docs
│   ├── overview.md              # Обзор системы и жизненный цикл запроса
│   ├── bootstrap.md             # Kernel, Config, Environment, ContainerFactory
│   ├── http.md                  # HTTP слой: Request, Response, Router, Middleware
│   ├── worker.md                # Worker entrypoint и WorkerRunner
│   ├── auth.md                  # Auth: JWT, AuthMiddleware
│   ├── logging.md               # Логирование
│   ├── orm.md                   # ORM: MongoDB, entities, repositories
│   └── console.md               # Console-команды
├── development/                 # Практика разработки
│   ├── patterns.md              # Переиспользуемые code patterns
│   ├── conventions.md           # Соглашения: коммиты, ветки, неймспейсы
│   ├── commands.md              # Команды запуска и утилиты
│   └── testing.md               # Отладка и тестирование
├── decisions/                   # Architecture Decision Records (ADR)
│   ├── README.md                # Индекс ADR + как писать
│   └── ADR-NNN-*.md
└── tasks/                       # Контекст задач (по одному файлу на ветку)
    ├── _template.md             # Шаблон для новой задачи
    ├── active/                  # Активные ветки
    └── completed/               # Смерженные задачи

Правила обновления

Во время разработки в feature-ветке:

• Пиши только в tasks/active/<branch-name>.md (свой файл)
• Можешь добавить decisions/ADR-NNN.md (новый файл — нет конфликтов)
• НЕ трогай architecture/ и development/ — только в main

После мержа в main (интегратор):

• Читает секцию "Merge Notes" в task-файле
• При необходимости обновляет architecture/ и development/
• Перемещает: tasks/active/<branch>.md → tasks/completed/<branch>.md