| name | setup |
| description | Первый запуск Огорода — онбординг свежего vault: представить методологию, помочь выбрать дашборд (mini без сборки / full на Next.js) и записать выбор в ogorod.config.json. Используй при первом запуске (в projects/ только example-project) или по триггерам «setup», «онбординг», «первый запуск», «выбрать дашборд», «переключи дашборд». |
setup
Первый запуск свежего vault Огорода. Помогает пользователю стартовать и выбрать
дашборд, потому что их два (см. dashboard/README.md). Самодостаточно.
Это не про проект (для нового проекта — charter, для существующего кода —
onboard), а про сам vault: настроить и выбрать витрину.
Когда запускать
- Первый запуск: в
projects/ только example-project (свежий клон шаблона) —
предложи setup вместо sync (синхронизировать нечего).
- По запросу: «setup», «онбординг», «выбрать/переключить дашборд».
Шаг 0 — прочитай правила
Прочитай _rules.md (методология) и dashboard/README.md (два уровня дашборда).
Шаги
-
Представь Огород в двух фразах: персистентная память о проектах/задачах в
markdown; ты (агент) ведёшь её, человек читает. Подробности — _rules.md.
-
(Опц.) Obsidian + Dataview — если человек хочет читать vault в Obsidian,
подскажи поставить плагин Dataview (заработают сводки _dashboard.md/tasks.md).
Не настаивай — это необязательно.
-
Выбор дашборда. Покажи два варианта и помоги решить по потребности:
| mini (dashboard/serve.js) | full (dashboard-app/, Next.js) |
|---|
| Запуск | npm run dashboard — без сборки | npm install + сервер |
| Возможности | проекты · канбан · RICE · инбокс · аналитика · поиск | + Гант · роадмап · фазы · JTBD · документы · хостинг |
| Кому | быстро посмотреть, локально | вести всерьёз, нужен хостинг и полный обзор |
Спроси, какой выбрать (по умолчанию предложи mini — нулевой порог).
-
Запиши выбор в ogorod.config.json в корне vault: { "dashboard": "mini" }
или { "dashboard": "full" }. Создай файл, если его нет. Это источник правды
о выбранной витрине — читай его в начале сессии, чтобы знать, что запускать.
Туда же запиши версию шаблона, с которой установлен vault — поле
ogorod_version (= tag_name последнего GitHub-релиза Огорода без v,
например "1.1.0"). По нему sync понимает, что вышло обновление. Итог:
{ "dashboard": "mini", "ogorod_version": "1.1.0" }.
Туда же — грядка по умолчанию: положи в корень vault bed.json
({ "id": "work", "name": "Рабочая", "type": "agent" }) и добавь в конфиг
"default_bed": "work". Vault становится нейрогрядкой по умолчанию (канон —
methodology.md → «Грядка»); дополнительные грядки появятся под beds/<slug>/,
корневую не двигаем.
-
Настрой выбранный:
- mini: запуск
npm run dashboard (или node dashboard/serve.js --open). Зависимостей нет.
- full:
cd dashboard-app && npm install, затем VAULT_PATH=<корень vault> npm run dev
(прод — npm run build && npm start). Переменные — в dashboard-app/README.md.
-
Скажи про переключение: в любой момент «переключи дашборд на full/mini» —
обнови ogorod.config.json и настрой другой (шаг 5). Данные общие (один vault),
переключение безопасно.
-
Дальше: удали projects/example-project/, заведи первый проект — charter
(greenfield) или onboard (существующий код).
Переключение (повтор по запросу)
«Переключи дашборд на <mini|full>» → перепиши поле dashboard в ogorod.config.json
и выполни настройку нужного уровня (шаг 5). Ничего не мигрируется — обе витрины
читают один markdown-vault.
Самопроверка