Руководства

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

Руководства идут рука об руку со справочником (схемы, набор команд, шаблонизатор) — справочник отвечает на вопрос что есть, а руководства — как всё это использовать вместе.

Страницы

Старт и подключение к проекту

Для разработчиков, которые поднимают новый проект или хотят быстро войти в строй на существующем.

• Создание нового проекта с dwe init — workspace.yml ещё нет; создайте минимальный, но полноценный проект, который чисто проходит валидацию при первом запуске.
• Подключение к проекту DWE — вы склонировали репозиторий с workspace.yml; что запустить первым и что окажется на диске.
• Повседневная работа — небольшой набор команд, к которым вы будете обращаться каждый день: статус, сервисы, шелл, команды, логи, stop/restart.
• Диагностика проблем — стек шалит; карта триажа от dwe validate и dwe logs до dwe compose raw.
• Переключение задач через снапшоты — сохранить текущее окружение, переключиться на другую задачу и позже вернуться к нему; сборник рецептов по snapshot create / restore.
• Обновление DWE — вы поставили новую версию DWE; что ломается в каждом релизе и что в ответ на это править.

Авторство и сопровождение проекта

Для разработчиков, которые пишут DWE-конфиг — сервисы, команды, демоны, снапшот-воркфлоу, оформление, локализацию, IDE-template-паки, preflight-проверки.

• Добавление сервиса — встроить новый worker (или app, или infra) сервис в существующий проект.
• Авторство проектных команд — превратить заклинания из README в полноценные команды dwe <id>.
• Фоновые демоны — задекларировать долгоживущий queue worker, watcher или планировщик через type: daemon.
• Preflight-проверки — завершиться сразу и с понятной диагностикой, ещё до того как деплой затронет машину.
• Общий конфиг IDE и AI-агентов — одинаковые VS Code, AGENTS.md и git-хуки у всех через template-паки.
• Локализация под вашу команду — перевести пользовательские команды и строки браузера команд на RU / DE / FR / …
• Брендирование проекта — кастомизировать ASCII-шапку, палитру и дашборд dwe info.
• Авторство снапшот-воркфлоу — написать workspace/snapshot.yml: решить, что сохраняется, восстанавливается и подчищается.
• Написание интеграционных тестов — авторство сценариев workspace/tests/*.yml: изолированные деплой-тесты, проверки, тестирование проектных команд, отладка через --keep.

Интеграции

• Запуск ralphex в workspace — установить workspace-пак, собрать оверрайды промптов и задать область плана в корневом и сервисных репозиториях.

• Интеграция со Starship — компактный, проектно-ориентированный сегмент DWE внутри промта Starship.

• Наблюдаемость с OpenTelemetry — опциональный tool-сервис otel (бандл Grafana LGTM), чей оверлей инструментирует ваши app-сервисы; рецепты под каждый язык и текстовый поиск трейсов для агента.

См. также

• Справочник (reference/) — схемы, поля конфига, render-паки, подсистема документации
• Запустите dwe --help (или любую подкоманду с --help), чтобы увидеть актуальный CLI-интерфейс
• Запустите dwe docs для интерактивного браузера по всему дереву документации