L1DDER

Русский

English

Русский

English

Appearance

🔍 2. Подробный разбор всех цепочек L1DDER ​

⬅️ Назад к Быстрому старту (01-QUICKSTART.md) | ➡️ Далее к Шпаргалке на 1 экран (03-CHEATSHEET.md)

В этом документе разобрана каждая управляющая кнопка (/l1-onboard, /l1-idea, /l1-feature, /l1-planning, /l1-task, /l1-hotfix, /l1-chore, /l1-fast): зачем она нужна, какая магия работает внутри неё под капотом и где агент ждёт твоего решения.

🧭 Кнопка 0: /l1-onboard — Старт проекта по этапам ​

Когда нажимать: Один раз сразу после npx l1dder init (как в новом пустом проекте, так и в существующем репозитории с кодом).

  • Агент определяет режим (from-scratch или existing-code) и проводит тебя по шести этапам, по одному файлу за раз: идея → видение → архитектура → модель данных → стек → банк идей и роадмап.
  • На каждом этапе он задаёт до 7 вопросов с готовыми рекомендациями, разбирает ответы и спрашивает: «Идём дальше или ещё раунд?». Файл этапа записывается только после твоего «ок».
  • Стек (l1dder/rules/30-tech-stack.mdc, Makefile) агент предлагает на пятом этапе, когда уже понятны архитектура и модель данных. В проекте с кодом он берёт стек и остальные факты из самого кода.
  • Если ты сразу говоришь что-то про архитектуру или данные, агент предложит записать это в нужный файл, чтобы ничего не потерялось.

💡 Кнопка 1: /l1-idea — Рождение и развитие идеи ​

Когда нажимать: В любой момент, когда тебе в голову пришла задумка (новая фича, улучшение, механика). Даже если сейчас идёт спринт по совсем другой теме — смело вызывай /l1-idea: она просто положит мысль в Банк Идей, не ломая текущую работу.

Что работает под капотом:

  • grilling (умное интервью): Агент не мучает тебя десятком пустых вопросов. Он задаёт только реальные продуктовые развилки в формате ❓ Q1 ... ➡️ Рекомендация. Если тебе нравится его рекомендация — ты просто пишешь одно слово ок.
  • ponytail (отсечение лишнего): Агент сразу предлагает самый простой вариант без переусложнения и записывает, что мы намеренно НЕ делаем на первом этапе.

📐 Кнопка 2: /l1-feature — Проработка ТЗ (Спеки) и Бэклога ​

Когда нажимать: Когда ты хочешь взять идею IDEA-NNN из Банка Идей и превратить её в чёткое техническое задание (спецификацию) и список задач в Бэклоге.

Что создаётся в итоге:

  1. Папка docs/specs/FEAT-NNN-<название>/ с тремя файлами:
    • requirements.md — что именно видит и делает пользователь.
    • design.md — какие глубокие модули (codebase-design) создаются и какие публичные точки (Seams) будут покрыты автотестами.
    • tasks.md — нарезка на шаги FEAT-NNN.01, FEAT-NNN.02, ..., и обязательный финальный шаг FEAT-NNN.99 (Doctor Checklist).
  2. Запись в docs/backlog.md со статусом 📋 в бэклоге.

🔒 Кнопка 3: /l1-planning — Планирование Роадмапа (Источника истины) ​

Когда нажимать:

  • Когда в Бэклоге появилась новая фича и нужно поставить её в очередь на разработку;
  • Когда ты передумал и хочешь поменять порядок спринтов или приоритеты;
  • Когда ты хочешь отклонить текущий спринт на 1 (CURRENT) и откатить его код: агент покажет коммиты спринта (⛔ СТОП), после твоего «ок» откатит код через git revert без переписывания истории, оставит документы спринта со статусом ❌ отклонена как запись и освободит позицию 1 (CURRENT);
  • Когда закончился текущий спринт и пора наметить следующие шаги.

Почему Роадмап так важен: В L1DDER действует железное правило Roadmap Gate: агент имеет право писать код (20-workflow.mdc) только по тому спринту, который стоит на строчке 1 (CURRENT) в docs/roadmap.md. Это защищает проект от хаоса, когда посреди одной недоделанной фичи начинают пилить три другие. Вне очереди можно срочно починить баг (/l1-hotfix), поправить сам проект без изменения продукта (/l1-chore) или — только когда 1 (CURRENT) пуста и команду вызвал строго только человек — сделать небольшую фичу через /l1-fast.

⚙️ Кнопка 4: /l1-task — Пошаговая разработка и Финальный Доктор спринта ​

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

Часть А: Как проходит обычная задача (TASK-NN.01, TASK-NN.02...) — Правило двух СТОПов ​

Ни одна строчка кода не пишется и ни одна задача не закрывается без твоего согласия:

Часть Б: 🩺 Обязательный финал каждого спринта — TASK-NN.99 (Doctor Checklist) ​

В L1DDER ни один спринт не может завершиться просто так. Последней задачей каждого спринта всегда стоит специальная гигиеническая задача TASK-NN.99 (Doctor Checklist).

Когда обычные задачи спринта закончились и ты вызываешь /l1-task, агент превращается в строгого ревизора и проходит 4 обязательных блока:

Если во время ручного теста в Блоке 4 тебе что-то не понравилось — ты просто пишешь это в чат, агент тут же правит это внутри TASK-NN.99, заново проверяет и показывает тебе!

🚑 Кнопка 5: /l1-hotfix — Экстренная починка бага в обход Роадмапа ​

Когда нажимать: Когда что-то сломалось и это нужно починить прямо сейчас, не разводя бюрократию со спеками и спринтами.

🧹 Кнопка 6: /l1-chore — Правки самого проекта ​

Когда нажимать: Когда нужно поменять не то, что видят твои пользователи, а сам проект: его «внутреннюю кухню». Например:

  • поменять правила работы с git: как называть ветки и коммиты, что проверять перед пушем;
  • настроить автопроверки в CI;
  • обновить библиотеки и зависимости;
  • поправить Makefile, скрипты сборки или тесты;
  • поменять правила для ИИ-агента.

Для таких правок не нужны идея, спека и спринт. Агент один раз показывает, что и как сделает, ты отвечаешь «ок», и правка записывается одной строкой в журнал docs/backlog.md. Можно и без команды: просто напиши «давай сделаем chore-правку...».

Чем отличается от /l1-hotfix: /l1-hotfix чинит то, что сломалось у пользователей продукта. /l1-chore меняет то, чем пользуешься ты и агент, пока делаете продукт.

⚡ Кнопка 7: /l1-fast — Быстрый режим для небольшой фичи продукта ​

Когда нажимать: Когда в проекте нет начатого спринта (строка 1 (CURRENT) в docs/roadmap.md пуста) и тебе нужна небольшая фича продукта, для которой не хочется отдельно проходить /l1-idea → /l1-feature → /l1-planning → /l1-task.

⚠️ Железное правило: команду /l1-fast вызывает строго только человек — для агента запускать или выбирать /l1-fast по своей инициативе запрещено. Без твоего явного вызова /l1-fast агент всегда идёт по основному пути.

  • Если спринт уже идёт (1 (CURRENT) занята): агент строго откажет и не тронет ни одного файла — предложит сначала закончить текущий спринт через /l1-task или отклонить его с откатом через /l1-planning.
  • Оценка масштаба: если фича слишком крупная (больше трёх задач или не хватит одного спринта; нужна новая модель данных, внешняя интеграция или ADR; есть ломающие изменения; за одно обсуждение не уложиться), агент предупредит и предложит обычный путь /l1-idea → /l1-feature.
  • Две остановки вместо четырёх, но без потери качества: ты отвечаешь «ок» два раза — на карточку решения до кода (⛔ СТОП №1) и после ручной проверки готового результата (⛔ СТОП №2). Между ними агент сам бронирует ID на 1 (CURRENT) в роадмапе, пишет код по срезам TDD, коммитит каждую задачу и прогоняет все проверки обычного пути и TASK-NN.99 (make ci, ponytail-review, двухосевой code-review, ponytail-audit, ponytail-debt, E2E, обновление доки и retro).
  • Честные реестры после кода: после твоего второго «ок» агент заполняет docs/ideas.md, docs/backlog.md, спеку в docs/specs/, спринт и задачи с пометкой Режим | /l1-fast и переносит спринт в «Завершённые спринты».

Как не перепутать три быстрые кнопки:

  • /l1-chore — поменять сам проект (правила git, CI, библиотеки, Makefile), продукт для пользователей не меняется;
  • /l1-hotfix — срочно починить баг в продукте;
  • /l1-fast — сделать небольшую новую фичу продукта, когда нет начатого спринта (вызываешь строго ты сам).

👉 Дальше: открой 03-CHEATSHEET.md — там шпаргалка на 1 экран для ежедневной работы!