README.ru.md

ForgePlan

От сырой идеи до проверенного решения

Engineering decision framework для команд, которые хотят, чтобы их идеи оставляли след. Структурированные артефакты (PRD, RFC, ADR, Epic, Spec), автоматический scoring качества, evidence и нативная интеграция с AI-агентами.

Сайт · Документация · Методология · Релизы · Marketplace

English · Русский

---

    ┌─────────┐    ┌────────┐    ┌────────┐    ┌───────┐    ┌────────┐    ┌──────┐
    │ OBSERVE │ ─▶ │ ROUTE  │ ─▶ │ SHAPE  │ ─▶ │ BUILD │ ─▶ │ PROVE  │ ─▶ │ SHIP │
    └─────────┘    └────────┘    └────────┘    └───────┘    └────────┘    └──────┘
     health        depth          PRD/RFC       code+test    evidence      activate

Каждое решение оставляет след. Каждый след имеет доказательство. Каждое доказательство честно устаревает.

---

Зачем

До Решения теряются в Slack, Linear, почте «Почему мы выбрали X?» — тишина через полгода AI-агенты выдают правдоподобную, но поверхностную работу ADR существуют в теории, но не пишутся Ресёрч не доходит до реализации

После Каждое решение — git-трекаемый артефакт Полный трейл Problem → Decision → Consequence Depth calibration заставляет нужный уровень строгости forgeplan new adr — одна команда, готово ADI reasoning требует 3+ гипотезы

Установка

# Homebrew (macOS, Linux)
brew install ForgePlan/tap/forgeplan
# Homebrew 6.0+: если установка отклонена с "untrusted tap",
# один раз выполните `brew trust ForgePlan/tap` и повторите строку выше.

# Install script
curl -fsSL https://raw.githubusercontent.com/ForgePlan/forgeplan/main/install.sh | sh

# Из исходников
git clone https://github.com/ForgePlan/forgeplan.git && cd forgeplan
cargo install --path crates/forgeplan-cli

Демо за 60 секунд

$ forgeplan init -y
  ✓ Workspace initialized at .forgeplan/

$ forgeplan route "Добавить OAuth2 авторизацию"
  Depth:      Standard
  Pipeline:   PRD → RFC
  Confidence: 92%

$ forgeplan new prd "OAuth2 Authentication"
  ID:    PRD-001
  Next:  fill Problem, Goals, Non-Goals, Target Users, FR

$ forgeplan validate PRD-001
  Result: PASS (0 errors, 0 warnings)

$ forgeplan reason PRD-001
  Hypothesis 1: Session-based flow   (confidence: 0.6)
  Hypothesis 2: JWT with refresh     (confidence: 0.8)  ← лучшая
  Hypothesis 3: OAuth proxy service  (confidence: 0.4)

$ forgeplan new evidence "15 тестов проходят, 180ms p95 на benchmark"
$ forgeplan link EVID-001 PRD-001 --relation informs
$ forgeplan score PRD-001
  R_eff: 1.00  (Adequate)

$ forgeplan activate PRD-001
  ✓ PRD-001 (draft → active)

Семь вещей, которые важны

📝 Markdown-first	Все артефакты — обычный markdown в git. LanceDB — производный индекс, пересобирается из файлов.
🎯 Quality scoring	R_eff (доверие по weakest link) и F-G-R (formality, granularity, reliability) — автоматически.
🧭 Smart routing	Анализирует задачу, подбирает depth и pipeline. Не надо документировать фикс тайпо.
🧠 ADI reasoning	Abduction → Deduction → Induction. Требует 3+ гипотезы перед каждым решением.
🤖 MCP-native	73 инструмента для Claude Code, Cursor, Aider, Continue. Агенты говорят на языке методологии.
🔍 Локальный семантический поиск	fastembed (BGE-M3, 1024 dims). Без сети, без API-ключей, без утечек.
⏰ Evidence decay	Истёк valid_until → артефакт помечается stale. Доверие честно угасает.

Артефакты одним взглядом

Артефакт	Отвечает на	Когда
PRD	Что мы делаем и зачем?	Новая фича, продуктовое решение
RFC	Как будем делать?	Архитектура, API design
ADR	Почему выбрали именно так?	Необратимые технические решения
Spec	Какие точные контракты?	API контракты, data models
Epic	Какая большая картина?	Cross-cutting, мульти-PRD инициативы
Evidence	Это реально работает?	После реализации, перед активацией

Полное decision tree: docs/methodology/PRD-RFC-ADR-FLOW.md.

Документация

Три точки входа — выбери ту, что соответствует твоей задаче сейчас.

Я хочу...	Начать отсюда
Изучить методологию	docs/methodology/FORGEPLAN-GUIDE.md
Посмотреть всю доку	docs/README.md
Работать с AI-агентами	CLAUDE.md · AGENTS.md

Dogfood

394 tracked артефактов

3243 тестов проходят

81 CLI команда

73 MCP tools

Этот репозиторий использует ForgePlan для управления самим собой. Каждый PRD, RFC, ADR и Evidence лежит в .forgeplan/ — можно просматривать напрямую или через forgeplan list.

Contributing

Полный гайд — CLAUDE.md. Краткая версия:

# Ветка из dev
git checkout dev && git pull
git checkout -b feat/my-feature

# Проходи цикл: Route → Shape → Validate → Build → Evidence → Activate
# cargo fmt + cargo test перед каждым коммитом
# PR → dev (main трогаем только через release ветки)

License

MIT — см. LICENSE.

Structure. Evidence. Trust.

→ Установить сейчас и запустить forgeplan route "твоя следующая задача".

Построен на Quint-code · BMAD · OpenSpec · FPF · LanceDB · fastembed

_{С заботой от @ForgePlan · English version}