Vault

Vault (.dev-vault/) — персистентное хранилище знаний о проекте. Решает проблему потери контекста: когда Claude Code сжимает историю или начинается новая сессия, vault сохраняет всё важное.

Структура

.dev-vault/
├── stack.md           # Языки, фреймворки, БД, тулинг
├── conventions.md     # Конвенции кода: naming, structure, style
├── knowledge.md       # Архитектура, data model, API, security, gotchas
├── gameplan.md        # План: текущая фаза, все фазы, бэклог
├── phases/            # Файлы фаз для /workflow:dev
├── daily/             # Автоматические логи сессий
├── branches/          # Контекст веток
├── architecture/      # ADR записи
├── bugs/              # Логи решённых багов
├── debt/              # Записи техдолга
├── tasks/             # Задачи (JSON)
└── workflows/         # Кастомные workflow (YAML)

4 ключевых файла

stack.md

Технологический стек проекта. Заполняется автоматически при init (автодетект из package.json, Cargo.toml и т.д.) или через /vault:from-spec.

conventions.md

Конвенции кода: структура файлов, naming, code style, паттерны, git, тестирование. Агенты используют для генерации кода, соответствующего проекту.

knowledge.md

Знания об архитектуре: компоненты, связи, data model, API, security, gotchas. Самый ценный файл — содержит то, что не видно из кода.

gameplan.md

Дорожная карта: текущая фаза, все фазы с задачами, бэклог. Planner-агент использует для приоритизации.

Заполнение

Что попадает в git

• stack.md, conventions.md, knowledge.md, gameplan.md — да
• phases/, architecture/, bugs/, debt/, tasks/ — да
• daily/, branches/ — нет (добавлены в .gitignore при init)