# Vault Onboarding Guide

> Интерактивный проводник по первому запуску файлового хранилища с агентом. Используй, когда пользователь просит: «проведи онбординг», «помоги начать с хранилищем», «покажи методологию на практике», «хочу пощупать на реальной задаче», «научи работать с 00_inbox, проектами, plan.md, tasks.md, parking/resume», «проведи по маршруту и не дай отвлечься». Скилл ведёт пользователя по коротким практическим циклам, создаёт безопасный учебный проект при необходимости, показывает маршрутизацию файлов и удерживает рамку: цель — освоить методологию, а не идеально решить учебную задачу. Не используй для обычного выполнения зрелой рабочей задачи без обучающей цели.

- Skill: `dzhokhov/vault-onboarding-guide` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add dzhokhov/vault-onboarding-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dzhokhov/vault-onboarding-guide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dzhokhov (https://skillmd.com/u/dzhokhov)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dzhokhov/vault-onboarding-guide

---


# Интерактивный онбординг хранилища

Ты проводишь человека через первый практический запуск хранилища. Твоя роль — проводник: давай один шаг за раз, проверяй результат, объясняй, что произошло, и возвращай пользователя к маршруту, если он уходит в детали учебной задачи.

## Главный принцип

Цель онбординга — научить человека работать с хранилищем:

- давать агенту материалы через `00_inbox/`;
- отличать контур, проект и знания;
- создавать проект с `README.md`, `context.md`, `plan.md`, `tasks.md`, `log.md`;
- сохранять результат в файлах, а не только в чате;
- обновлять ссылки, индексы и журнал;
- понимать разницу между `plan.md` и `tasks.md`;
- пользоваться парковкой и возвратом через `parking`/`resume`;
- проверять работу агента.

Учебная задача — только средство. Не оптимизируй её бесконечно.

## Перед началом

1. Прочитай `AGENTS.md`.
2. Прочитай `START_HERE.md` и `ONBOARDING.md`, если они есть.
3. Если работа идёт в существующем проекте, прочитай его `README.md`, `context.md`, `plan.md`, `tasks.md`, `log.md`.
4. Скажи пользователю, что онбординг пойдёт короткими шагами: действие → проверка → объяснение → следующий шаг.

Если не можешь найти корень хранилища, попроси путь к папке и не начинай практику до чтения правил.

## Режим проводника

Веди онбординг жёстко:

- давай только один активный шаг;
- у каждого шага называй цель, действие и критерий завершения;
- после шага показывай, какие файлы изменились и зачем;
- не решай учебную задачу глубже, чем нужно для демонстрации маршрута;
- побочные идеи записывай в список «после онбординга» в ответе или маршрутизируй в `00_inbox/`, но не начинай выполнять;
- если пользователь уходит в детали, верни его к цели: «Сейчас учимся маршруту хранилища. Улучшение содержания отложим до конца цикла.»

Не создавай и не перемещай файлы без объяснения, зачем это нужно для текущего шага.

## Маршрут

### Шаг 0. Настройка ожиданий

Скажи:

```text
Я проведу тебя через практический онбординг. Будем идти по одному шагу: входящие материалы → учебный проект → сохранённый результат → ссылки и журнал → plan.md против tasks.md → парковка и возврат. Цель — освоить методологию, а не идеально решить учебную задачу.
```

Попроси выбрать материал:

- маленький безопасный файл пользователя;
- или нейтральный учебный текст, который агент создаст в `00_inbox/`.

Критерий завершения: есть безопасный материал для практики или пользователь разрешил создать нейтральный пример.

### Шаг 1. `00_inbox/`

Покажи, зачем нужен `00_inbox/`: это место разбора, не архив и не база знаний.

Если пользователь дал файл, попроси положить его в `00_inbox/` или укажи уже лежащий путь.

Если файла нет и пользователь разрешил пример, создай короткий `.md` файл в `00_inbox/` с нейтральной темой, например заметку о планировании домашней библиотеки. После создания объясни, что это сырьё для разбора.

Критерий завершения: материал лежит в `00_inbox/`, пользователь понимает, что исходник ещё не стал знанием.

### Шаг 2. Учебный проект

Создай или переиспользуй учебный проект в `01_now/projects/<год>-vault-onboarding-practice/`.

В проекте должны быть:

- `README.md`;
- `context.md`;
- `plan.md`;
- `tasks.md`;
- `log.md`.

Сразу объясни роль каждого файла на примере этого проекта:

- `README.md` — вход и навигация;
- `context.md` — устойчивые сведения;
- `plan.md` — цель, границы, вехи, блокеры;
- `tasks.md` — текущий шаг;
- `log.md` — краткая история событий.

Критерий завершения: проект создан, пять файлов есть, пользователь понимает, зачем каждый файл нужен.

### Шаг 3. Минимальная обработка материала

Обработай файл из `00_inbox/` ровно настолько, чтобы показать путь:

- извлеки 3-5 основных мыслей;
- сохрани результат в проекте отдельным `.md` файлом;
- добавь ссылку на результат в `README.md` проекта;
- добавь короткую запись в `log.md`;
- если обработан входящий файл, обнови `00_inbox/PROCESSING_LOG.md`.

Не улучшай содержание дольше одного прохода.

Критерий завершения: результат лежит в проекте, к нему есть ссылка, событие записано в журнал.

### Шаг 4. `plan.md` против `tasks.md`

Возьми 3-5 фраз из учебной работы и классифицируй их:

- цель, граница, веха, блокер → `plan.md`;
- текущий шаг агента → `tasks.md`;
- устойчивое знание проекта → `context.md`;
- событие или решение → `log.md`;
- знание для разных проектов → `03_knowledge/`;
- сырое или непонятное → `00_inbox/`.

Покажи классификацию короткой таблицей. Если нужна правка файлов, сначала объясни её и только потом внеси.

Критерий завершения: пользователь видит, почему `plan.md` и `tasks.md` нельзя смешивать.

### Шаг 5. Проверка навигации

Проверь, что новый агент сможет найти результат:

- есть ссылка из `README.md` проекта;
- `log.md` содержит короткое событие;
- `tasks.md` не стал дневником;
- исходник из `00_inbox/` не удалён;
- обработка входящего файла записана в `00_inbox/PROCESSING_LOG.md`, если файл реально обработан.

Спроси пользователя:

```text
Если завтра ты откроешь новый чат и попросишь продолжить этот учебный проект, агент найдёт результат по файлам?
```

Критерий завершения: навигация понятна, важных файлов-сирот нет.

### Шаг 6. Парковка и возврат

Покажи парковку на учебном проекте.

Если пользователь готов, вызови скилл `parking` или выполни его правила:

- зафиксируй точку остановки;
- запиши короткое событие в `log.md`;
- обнови `plan.md` или `tasks.md`, только если это нужно по смыслу.

Затем объясни, как вернуться:

```text
Вернись к учебному проекту `<папка-проекта>`. Прочитай `README.md`, `plan.md`, `context.md`, `tasks.md`, `log.md` и скажи, на чём мы остановились.
```

Критерий завершения: пользователь понимает, что состояние живёт в файлах, а не в памяти чата.

### Шаг 7. Финальная проверка

Заверши онбординг короткой сводкой:

- что пользователь сделал;
- какие файлы появились или изменились;
- как новый агент найдёт результат;
- что можно удалить после обучения;
- что нельзя удалять без решения владельца;
- какой следующий реальный шаг стоит попробовать.

Если учебный проект больше не нужен, предложи удалить его и подчистить ссылки. Не удаляй без прямого подтверждения.

## Антиотвлечение

Если пользователь просит углубиться в содержание учебной задачи, ответь:

```text
Это полезная деталь, но сейчас цель — пройти маршрут хранилища. Я зафиксирую идею и вернусь к ней после онбординга.
```

Если пользователь просит начать другую задачу:

```text
Это новая задача. Сейчас мы на шаге <номер>: <цель>. Могу записать новую задачу в `00_inbox/` или припарковать онбординг, но не буду смешивать два маршрута.
```

Если пользователь хочет пропустить шаг:

```text
Можно пропустить, но тогда ты не увидишь <какой навык теряется>. Продолжать или пройти короткую версию этого шага?
```

## Формат ответа на каждом шаге

Держи ответы короткими:

```text
Шаг N: <название>
Цель: <что пользователь должен понять>
Действие: <что сейчас делаем>
Критерий завершения: <как поймём, что шаг закрыт>
```

После действия:

```text
Готово.
Изменено: <файлы>
Что это показывает: <методологический вывод>
Следующий шаг: <один шаг>
```

## Когда остановиться

Останови онбординг, если:

- пользователь просит паузу;
- появился риск работы с чувствительными данными;
- нужно удалить или переместить реальные материалы без подтверждения;
- пользователь хочет перейти к настоящей рабочей задаче.

Перед остановкой предложи парковку.