L1DDER

Русский

English

Русский

English

Appearance

⚡ 1. Быстрый старт и живой пример работы в L1DDER ​

⬅️ Назад к Главной карте (README.md) | ➡️ Далее к Подробному разбору кнопок (02-FLOWS-IN-DETAIL.md)

Здесь показано:

  1. Как за 30 секунд установить L1DDER в проект для любого ИИ-агента (Cursor, Claude Code, Codex, Windsurf, Copilot, OpenCode, Cline).
  2. Живой сквозной пример: как ты общаешься с агентом в чате от первой идеи до готовой фичи.

Шаг 1. Подключение L1DDER в проект (выполняется 1 раз) ​

Ты можешь даже не открывать терминал — просто отправь своему ИИ-агенту (Cursor, Claude Code, Codex, Windsurf, Copilot) одну фразу в чат:

text
Установи в этот проект фреймворк L1DDER командой `npx l1dder@latest init --lang ru --yes`, а затем сразу начни онбординг по `l1dder/skills/l1-onboard/SKILL.md`

Агент сам запустит установщик (который по умолчанию сконфигурирует и Cursor, и Claude Code, и Codex) и сразу начнёт онбординг с первого этапа — идеи проекта!

Либо выполни команду в терминале самостоятельно:

bash
# Интерактивная установка (спросит язык ru/en и твоих агентов)
npx l1dder init

# Или без вопросов (по умолчанию ставит для Cursor, Claude Code и Codex):
npx l1dder init --lang ru --yes

Эта команда:

  • создаст папку l1dder/ с методологией, шаблонами и правилами;
  • автоматически разложит правила и слэш-команды (/l1-onboard, /l1-idea, /l1-feature, /l1-planning, /l1-task, /l1-hotfix, /l1-chore, /l1-fast, /l1-evo, /ponytail*) во все выбранные агенты.

После этого открой чат своего агента и введи:

text
/l1-onboard

Агент проведёт тебя по шести этапам: идея, видение, архитектура, модель данных, стек, банк идей и роадмап. На каждом этапе он задаёт до 7 вопросов с готовыми рекомендациями и спрашивает, идти дальше или обсудить ещё. Стек он предложит только после архитектуры и запишет в l1dder/rules/30-tech-stack.mdc.

Шаг 2. Живой пример: как выглядит твоя работа день за днём ​

Представь, что мы делаем веб-приложение с базой знаний, и тебе пришла в голову идея: «Хочу мгновенный поиск по статьям и фильтр по тегам с сохранением в ссылке». Вот как выглядит весь путь в 4 простых шага:

💬 Сцена 1: Рождение идеи (/l1-idea) ​

Ты пишешь в чат:

/l1-idea Хочу сделать мгновенный поиск по заголовкам статей и фильтрацию по тегам, чтобы выбранный фильтр сохранялся в URL

Что делает агент: Он не бросается писать код! Он проверяет Банк Идей и задаёт тебе 1–2 умных вопроса с готовой рекомендацией:

🤖 Агент: Отличная идея для навигации по каталогу! Перед записью в Банк Идей давай уточним одну развилку:

❓ Q1 — Как сочетаются несколько выбранных тегов? ➡️ Рекомендация: Логика И (показываем статьи, где есть все выбранные теги) с кнопкой «Сбросить всё» — это стандарт, который проще всего читается в URL (?tags=api,auth).

Вот черновик карточки IDEA-002 с приоритетом P0 и статусом 📋 нереализована. Утверждаем (ок / правки)?

Ты пишешь:

ок

✅ Результат: Идея IDEA-002 аккуратно сохранена в docs/ideas.md. На это ушло 30 секунд! Так ты можешь накидать хоть 20 идей подряд, не теряя ни одной мысли.

💬 Сцена 2: Проработка фичи и ТЗ (/l1-feature) ​

Когда ты готов превратить идею IDEA-002 в детальный план:

Ты пишешь в чат:

/l1-feature IDEA-002

Что делает агент: Агент продумывает требования, архитектуру модулей и режет фичу на задачи для спринта (причём последней задачей FEAT-002.99 он всегда автоматически ставит финальный техосмотр — Doctor Checklist):

🤖 Агент: Я подготовил проект спецификации FEAT-002 (связана с IDEA-002):

  • Требования (requirements.md): 3 пользовательских сценария (поиск по подстроке, фильтр по тегам, синхронизация с URL).
  • Дизайн (design.md): создаём глубокий модуль CatalogFilter с чистым публичным швом filterArticles(items, query) для unit-тестов.
  • Нарезка задач (Кандидат спринта):
    • FEAT-002.01 — Модуль фильтрации и парсинга URL-параметров с unit-тестами.
    • FEAT-002.02 — UI-панель строки поиска и чипсов тегов.
    • FEAT-002.99 — Гигиена спринта и Doctor Checklist (E2E + UAT + Docs Sync).

Утверждаем спеку FEAT-002 для записи в Бэклог (ок / правки)?

Ты пишешь:

ок

✅ Результат: Создана папка спеки docs/specs/FEAT-002-catalog-search/, фича FEAT-002 записана в docs/backlog.md со статусом 📋 в бэклоге, а идея IDEA-002 автоматически перешла в статус 🚧 реализация.

💬 Сцена 3: Постановка в Роадмап (/l1-planning) ​

Теперь мы хотим официально поставить эту фичу в очередь разработки.

Ты пишешь в чат:

/l1-planning

Что делает агент:

🤖 Агент: Предлагаю обновить наш источник истины docs/roadmap.md:

  • Ставим SPRINT-02 (по фиче FEAT-002 ← IDEA-002) на позицию 1 (CURRENT).
  • Задачи спринта получают номера: TASK-02.01, TASK-02.02 и финальная TASK-02.99 (Doctor Checklist).
  • В очередь проработки идей (Discovery Queue) ставим следующую нереализованную идею IDEA-003.

Утверждаем Роадмап (ок / перестроить)?

Ты пишешь:

ок

✅ Результат: docs/roadmap.md обновлён, создана папка спринта docs/sprints/SPRINT-02-catalog-search/README.md. Теперь можно кодить!

💬 Сцена 4: Разработка задач и финальный Доктор спринта (/l1-task) ​

Теперь тебе вообще не нужно придумывать промпты для кода. Ты просто раз за разом вызываешь одну и ту же команду:

Ты пишешь в чат:

/l1-task

Что происходит дальше (Правило двух СТОПов):

  1. Агент сам видит по Роадмапу, что сейчас очередь задачи TASK-02.01.
  2. Он составляет план plan.md и делает ⛔ СТОП №1: «План TASK-02.01 готов. Начинаем реализацию (ок)?»
  3. Ты пишешь: ок.
  4. Агент пишет код, сам гоняет тесты, сам проверяет отсутствие ошибок и делает ⛔ СТОП №2: «Самопроверка пройдена! Вот что сделано, вот что намеренно упрощено (Ponytail skipped). Закрываем задачу (ок)?»
  5. Ты пишешь: ок. Агент создаёт отчёт summary.md и отмечает TASK-02.01 выполненной (✅ реализована).

Когда все обычные задачи спринта сделаны, следующий вызов /l1-task запускает финальную задачу TASK-02.99 (Doctor Checklist):

  • Агент вычищает весь мусор из кода и проверяет make ci;
  • Сам проверяет все пользовательские сценарии спринта (E2E);
  • Обязательно обновляет долгосрочную документацию (docs/concept/, l1dder/rules/), чтобы она не устаревала;
  • Пишет тебе простую инструкцию: «Запусти приложение вот так и проверь руками 1-2-3. Всё ли тебе нравится?»
  • Как только ты проверил и написал ок — спринт SPRINT-02, фича FEAT-002 и идея IDEA-002 автоматически получают статус ✅ реализована!

🔄 Как обновить весь фреймворк или только скиллы при выходе новой версии? ​

Когда выходит новая версия l1dder, у тебя есть две команды на выбор:

bash
# 1. Обновить ВЕСЬ фреймворк (правила Core, шаблоны, гайды и все скиллы),
# сохранив нетронутыми твой проектный стек (30-tech-stack.mdc) и docs/:
npx l1dder@latest update

# 2. Обновить ТОЛЬКО скиллы (вообще не трогая правила и шаблоны):
npx l1dder@latest update --skills

👉 Дальше: открой 02-FLOWS-IN-DETAIL.md, чтобы увидеть подробные схемы работы каждой кнопки!