Skip to content

ГАЙДЫ · ИНТЕРАКТИВНЫЕ РАЗБОРЫ

Методология в движении

Дюжина самодостаточных интерактивных уроков, объясняющих методологию Forgeplan изнутри: как оцениваются решения, почему R_eff = min() а не среднее, как PRD превращается в Spec и в выкаченную фичу, и как несколько AI-агентов не мешают друг другу в одном репо.

КАРТА СЕРИИ

Шесть уровней — от старта к инструменту. Можно идти подряд или прыгать туда, где сейчас интерес.

01 СТАРТ
зачем и как
00 Что такое журнал решений и зачем он нужен команде 01 Как ввести практику журналирования решений в команде
02 КОНЦЕПТЫ
обзорные
02 Как вести артефакты команды 03 ADI как ежедневная практика: трёхверсионный анализ 04 Как выглядит хороший DDR — шаблон с примером 06 Trust Calculus: оценка доверия по трём осям 07 Evidence и Decay: почему доказательства имеют срок годности
03 ЦИКЛ И ФОРМАТ
детальные
08 Цикл одного решения · ADI · DDR · Trust Calculus 10 BMAD · 13-step PRD · Adversarial Review 11 Spec · Delta · R_eff 12 Lifecycle · от draft до terminal 13 FPF · First Principles Framework как родительская рамка
04 ИНТЕРАКТИВЫ
3D и слайдеры
09 Trust Calculus в 3D F/G/R 14 DAG Explorer · артефакты в 3D 15 Depth Calibrator · routing в реальном времени
05 АГЕНТЫ
контракты и координация
16 Hint Contract · 5 маркеров 17 Multi-agent · dispatch · claim · release
06 ИНСТРУМЕНТ
одна реализация
18 Forgeplan как operational layer 19 Первый артефакт · 20-минутный hands-on walkthrough
20 уроков
15 теории
4 интерактив
~120 мин чтения

Порядок чтения

Построено линейно — каждый урок опирается на концепты предыдущего. Интерактивные приложения (3D-графики, калькуляторы) идут за теоретическими парами.

  1. 00
    нулевой уровень · часть 1 · база theory
    Что такое журнал решений и зачем он нужен команде
    Нулевой уровень — без брендирования. Что такое «журнал решений» как инженерная практика (форматы ADR, DDR), шесть обязательных полей записи, кому нужно, шесть use-cases в разных сферах, и почему это важно сейчас в мире AI.
    →
  2. 01
    нулевой уровень · часть 2 · практика theory
    Как ввести практику журналирования решений в команде
    Практическое продолжение нулевого. Когда писать запись, а когда нет. Шкала глубины задачи. Типичный день инженера. Три способа дать AI-агенту прочитать контекст. Пять сценариев агента с записями. Антипаттерны.
    →
  3. 02
    обзор · артефакты theory
    Как вести артефакты команды
    Обзорная статья между нулевыми и детальными уроками. Что считается артефактом (три признака), правило «один файл — одна ответственность», ритм работы, три признака живого артефакта, 5 антипаттернов. Ссылки на формальный цикл и lifecycle.
    →
  4. 03
    обзор · adi theory
    ADI как ежедневная практика: трёхверсионный анализ
    Обзор приёма «выпиши три версии причины» как ежедневной привычки. Происхождение из медицинской диагностики XIX века. Когда применять, как выглядит один цикл, почему именно три (статистический порог). Ссылки на формальный цикл.
    →
  5. 04
    обзор · ddr theory
    Как выглядит хороший DDR — шаблон с примером
    Обзор формата DDR. Сравнение DDR и ADR, шесть обязательных полей, полный markdown-пример (JWT vs сессии vs OAuth). Почему 200–400 слов и одна экранная страница. Ссылки на формальный цикл и lifecycle.
    →
  6. 05
    обзор · fpf theory
    FPF: карта согласованности
    Семь узлов ядра FPF - холоны, контекст, различения, срок годности, открытый/закрытый мир, доверие F-G-R, цикл рассуждения. Как они связаны и зачем держать их согласованными.
    →
  7. 06
    обзор · trust calculus theory
    Trust Calculus: оценка доверия по трём осям
    Trust Calculus простыми словами: три оси (F/G/R), правило слабого звена (не среднее), штраф за уровень контекста, формула R_eff одной строкой, где F/G/R живёт в шестой секции DDR. Бар-чарт для контраста среднее-vs-минимум. Ссылки на 3D-интерактив.
    →
  8. 07
    обзор · evidence theory
    Evidence и Decay: почему доказательства имеют срок годности
    Обзор типов доказательств (свой замер, бенчмарк коллеги, документация поставщика, опыт чужой команды), три измерения силы (краткий обзор F/G/R), что происходит с доказательством со временем (формула decay), триггеры пересмотра по decay. Ссылки на trust-calculus и lifecycle.
    →
  9. 08
    детальный · основа theory
    Цикл одного решения · ADI · DDR · Trust Calculus
    ADI цикл (Abduction → Deduction → Induction), DDR-поле на каждом ADR и Trust Calculus как способ численно оценивать доверие к источнику. Почему среднее обманывает.
    →
  10. 09
    приложение · интерактив interactive
    Trust Calculus в 3D F/G/R
    3D-сцена с семью evidence на сценарии /search latency. Плоскость порога F+G+R=12, hover-карточки, выбор гипотезы по WLNK. Сцену можно крутить мышью — учебный артефакт для проектора.
    →
  11. 10
    одна фича theory
    BMAD · 13-step PRD · Adversarial Review
    Четыре фазы воронки (Brainstorming → Modeling → Architecting → Delivery), 13 секций PRD из которых 3 критичные (Non-Goals, Risks, Open Questions), и adversarial review чужими глазами как third quality gate.
    →
  12. 11
    одна спецификация theory
    Spec · Delta · R_eff
    Spec против PRD: проверяемое поведение, а не намерение. Delta-формат ADDED/MODIFIED/REMOVED как git diff для требований. R_eff = min(scores) с Evidence Decay — почему среднее обманывает, а минимум — нет.
    →
  13. 12
    что после activate theory
    Lifecycle · от draft до terminal
    State machine с 5 состояниями и 6 переходами: draft → active → {superseded | deprecated | stale} → renew/reopen. Аналогия паспорта с визой. Stale как «забытое состояние», требующее явного решения.
    →
  14. 13
    meta-фреймворк theory
    FPF · First Principles Framework как родительская рамка
    Шесть базовых понятий (Bounded Context, Trust Calculus, F-G-R, ADI Cycle, Category Error, Gamma Algebra) + три режима использования (decompose / evaluate / reason). Показывает, что Trust Calculus и ADI — не отдельные идеи, а встроенные приёмы внутри одной родительской рамки.
    →
  15. 14
    приложение · интерактив interactive
    DAG Explorer · артефакты в 3D
    Plotly 3D scatter с узлами-артефактами и линиями-рёбрами. Knowledge Vault MVP как реальный пример: 22 артефакта, 30 связей, фильтры по типам. Покажет паттерны (здоровая цепочка / blindspot / orphan / разветвление) и трейсируемость одной картинкой.
    →
  16. 15
    приложение · интерактив interactive
    Depth Calibrator · routing в реальном времени
    Три слайдера (complexity / blast radius / reversibility) + три хард-гейта (public API / security / cross-team) → реал-тайм depth tier + pipeline. Пресеты для типовых сценариев (cosmetic / team feature / public API / auth rewrite).
    →
  17. 16
    язык агента ↔ инструмента theory
    Hint Contract · 5 маркеров
    Как агент перестал галлюцинировать next steps. Пять маркеров (Next: / Or: / Wait: / Done. / Fix:) + пять правил контракта (Presence / Actionability / Determinism / Conditionality / Consistency). Reference card.
    →
  18. 17
    параллельная работа theory
    Multi-agent · dispatch · claim · release
    Координация 2–5 agent'ов в одном репо без конфликтов. Planner режет работу на конфликт-free buckets, worker берёт под себя с TTL, release возвращает в pool. WIP=1 hard limit.
    →
  19. 18
    сам инструмент tool
    Forgeplan как operational layer
    POS для методологий: CLI + MCP + .forgeplan/ забирают на себя FPF, BMAD, OpenSpec, QuintCode. 10 типов артефактов (6 в активном ходу) с DAG зависимостей. Четыре depth-уровня и три quality gates в одном validate.
    →
  20. 19
    туториал interactive
    Первый артефакт · 20-минутный hands-on walkthrough
    Пошаговый симулированный терминал: init → health → route → new prd → validate → reason (ADI) → build → new evidence → link + score → activate. Прогресс-бар с кликабельными точками, side-panel состояния workspace, типичные ошибки на каждом шаге.
    →

Полная документация

За пределами этих уроков: справочник Forgeplan.

forgeplan.dev · официальные docs Methodology Overview · 10 правил · CLI Reference · MCP Reference · Marketplace
→