🚀 L1DDER — Путеводитель для человека (Vibe-Coder Friendly)
Добро пожаловать в L1DDER! Это руководство написано человеческим языком — без заумной теории. Даже если ты не пишешь код руками и управляешь разработкой через диалог с ИИ («вайбкодишь») в Cursor, Claude Code, Codex, Windsurf, Copilot или OpenCode, за 3 минуты ты поймёшь, как строить сложные, надёжные продукты, которые не разваливаются на третий день.
Навигация по руководству
| Документ | О чём он | Время чтения |
|---|---|---|
| 0. Главная карта (ты здесь) | Суть метода, главная схема цепочек, схема сквозных номеров (ID) и 3 экрана управления | 3 мин |
| 1. Быстрый старт и живой пример | Установка одной командой npx l1dder init + реальный диалог от первой идеи до готового спринта | 5 мин |
2. Подробный разбор кнопок /l1-* | Что внутри /l1-onboard, /l1-idea, /l1-feature, /l1-planning, /l1-task (и Doctor Checklist), /l1-hotfix, /l1-chore и /l1-fast | 7 мин |
| 3. Шпаргалка на 1 экран и FAQ | Таблица «Что нажать, если...», все статусы и ответы на частые вопросы | 2 мин |
Зачем вообще нужен L1DDER?
В обычном вайбкодинге всё начинается весело: ты пишешь «Сделай мне приложение», ИИ пишет 1000 строк кода. Через 3 дня ты просишь добавить новую кнопку — и половина старых функций ломается, а ИИ забывает, о чём вы договаривались вчера.
В L1DDER роли чётко разделены:
- 👤 Ты — Директор продукта (Product Owner) и Главный приёмщик. Ты придумываешь идеи, выбираешь приоритеты, говоришь «ок» на развилках и проверяешь готовый результат глазами.
- 🤖 ИИ-агент — Твоя инженерная команда со встроенным техлидом. Он сам задаёт тебе правильные вопросы с готовыми рекомендациями, сам пишет техзадания (спеки), сам пишет минимальный чистый код, сам тестирует его и сам ведёт документацию.
Для управления всем этим тебе нужны несколько слэш-команд (кнопок) в чате твоего агента: 0. /l1-onboard — один раз на старте проекта: по этапам проработать концепт, затем стек и базовую документацию.
/l1-idea— записать и развить идею./l1-feature— превратить идею в чёткое ТЗ (спеку) и нарезать на задачи в Бэклог./l1-planning— расставить очередь в Роадмапе (что делаем сейчас, а что потом), а если передумал — отклонить текущий спринт с откатом его изменений./l1-task— скомандовать агенту «Делай следующую задачу по Роадмапу!»./l1-hotfix— экстренная кнопка «Срочно почини баг вне очереди!»./l1-chore— правки самого проекта, а не того, что видят твои пользователи: правила git (как называть ветки и коммиты, что проверять перед пушем), автопроверки в CI, обновление библиотек,Makefile, правила для ИИ-агента. Идея, спека и спринт для этого не нужны: агент предлагает, ты говоришь «ок»./l1-fast— быстро сделать небольшую фичу продукта, когда нет начатого спринта (вызываешь строго только ты — агенту запускать/l1-fastпо своей инициативе запрещено). Ты отвечаешь «ок» только дважды (до кода и после всех проверок и ручной приёмки), а агент сам пишет код, прогоняет все проверки и после приёмки заполняет идею, спеку, спринт и задачи с пометкойрежим: /l1-fast. (Плюс сервисная кнопка/l1-evo— если захочешь доработать саму методологию по принципу догфудинга или сохранить файл передачи контекстаHANDOFF.md).
🗺 Главная схема L1DDER: рабочие цепочки
Посмотри на эту схему — это весь процесс работы над проектом от первой мысли до готового продукта:
🔗 Сквозная связь всех сущностей по ID: почему агент никогда ничего не забудет
Чтобы даже самая простая модель ИИ никогда не запуталась, в L1DDER все сущности связаны через сквозные номера (ID). Каждый следующий документ хранит в своей шапке (ID Passport) номера всех своих родителей:
Что это даёт тебе на практике: Когда ты закрываешь последнюю задачу спринта (TASK-01.99), агент по цепочке номеров сам автоматически ставит галочки ✅ реализована и спринту SPRINT-01 в Роадмапе, и фиче FEAT-001 в Бэклоге, и исходной идее IDEA-001 в Банке Идей!
📺 Три главных файла-экрана, куда тебе нужно заглядывать
Тебе не нужно лазить по десяткам папок с кодом. Вся картина твоего проекта всегда перед глазами в 3 файлах внутри папки docs/:
| Файл | Что это простыми словами | Какая команда им управляет |
|---|---|---|
docs/ideas.md | 💡 Банк Идей. Твоя записная книжка всех задумок с приоритетами (P0..P3) и статусами (📋 нереализована, 🚧 реализация, ✅ реализована, ❌ отклонена). | /l1-idea, /l1-fast |
docs/backlog.md | 📋 Таск-трекер (Бэклог). Таблица всех проработанных фич (FEAT-001), их спринтов, задач, журнал срочных починок (HOTFIX-001) и журнал служебных правок (CHORE-001). | /l1-feature, /l1-task, /l1-fast, /l1-hotfix, /l1-chore |
docs/roadmap.md | 🔒 Роадмап (Источник истины). Главный план: какой спринт делается прямо сейчас (1 CURRENT), какой следующим (2 NEXT), и какую идею следующей превращать в ТЗ. | /l1-planning, /l1-fast |
🔒 Главное правило
L1DDER(Roadmap Gate): Мы никогда ничего не пишем в код «просто так с голоса». Если чего-то нет на первой строчке Роадмапа (docs/roadmap.md) — агент откажется это делать и предложит сначала обновить Роадмап через/l1-planning. Вне очереди можно срочно починить сломанное (/l1-hotfix), поправить сам проект без изменения продукта (/l1-chore) или — только когда на1 (CURRENT)пусто и команду явно вызвал ты сам — быстро сделать небольшую фичу продукта через/l1-fast.
👉 Дальше: открой 01-QUICKSTART.md, чтобы посмотреть, как это работает на живом примере диалога!