PAUL Framework — Досье

Автор: Christopher Kahler
GitHub: https://github.com/ChristopherKahler/paul
Звёзды: ~1.1k
Лицензия: MIT
Язык: TypeScript/JavaScript
Актуальность: 2026

Что это

PAUL (Plan-Apply-Unify Loop) — фреймворк для структурированной разработки, помогаемой ИИ с приоритетом качества над скоростью. Предназначен для работы с Claude Code и агентов при разработке сложных проектов.

Философия: "Quality over speed-for-speed's-sake" — гарантирует честное отчётность о статусах и предотвращает рационализацию недоделок.

Проблемы, которые решает

Деградация контекста — По мере заполнения сессии качество падает
Сирые планы — Планы создаются, но никогда не закрываются; статус дрейфует
Низкое качество субагентов — Параллельные агенты производят ~70% качества, требуя переделок
Потеря решений — Критические выборы и контекст теряются между сессиями
Отсутствие приёмки — Нет формальных критериев успеха на старте

Архитектура

Три принципа системы

Целостность цикла — каждый план обязательно завершается UNIFY (примирением)
Контекст в сессии — минимум субагентов, они используются только для исследований
Acceptance-Driven Development — критерии приёмки (Given/When/Then) определяются до начала работ

Структура проекта на диске

<project>/
├── .paul/
│   ├── PROJECT.md       # Требования и контекст
│   ├── STATE.md         # Позиция цикла и текущее состояние
│   ├── ROADMAP.md       # Этапы и вехи проекта
│   ├── paul.toml        # Манифест для интеграции с BASE v2
│   └── ledger.toml      # История всех сессий и решений
├── SUMMARY.md           # Создаётся после UNIFY
└── <source-code>

The Loop: Три этапа цикла

1. PLAN (Планирование)

Создание выполнимого плана с критериями приёмки в формате BDD (Given/When/Then)
Автоматическое определение сложности:
Quick fix (1 файл, <1 часа)
Standard (2–5 задач, несколько часов)
Complex (6+ задач, несколько дней)
Decomposition: план разбивается на конкретные, проверяемые задачи

2. APPLY (Выполнение)

Построчное выполнение плана с проверкой качества
Каждая задача проходит цикл Execute/Qualify:
Execute — реализация задачи
Report — агент описывает сделанное
Qualify — независимая проверка против спецификации
Возможные статусы: DONE, DONE_WITH_CONCERNS, NEEDS_CONTEXT, BLOCKED

3. UNIFY (Закрытие цикла)

Обязательный этап (запрещает "незакрытые" циклы)
Создаёт SUMMARY.md с итогами
Сравнивает план с реальностью: что поменялось, почему
Записывает все решения в STATE.md для следующих циклов
Логирует сессию в ledger.toml

Основные команды (CLI)

Команда	Описание
`/paul:init`	Инициализация проекта с адаптированным опросом
`/paul:plan`	Создание/пересмотр плана с AC
`/paul:apply`	Выполнение плана
`/paul:unify`	Закрытие цикла (обязательно)
`/paul:progress`	Показать позицию в цикле и следующий шаг
`/paul:status`	Статус всех задач в плане

Пример использования

# 1. Инициализация
/paul:init
# → Создаёт .paul/PROJECT.md через интерактивный опрос

# 2. Планирование
/paul:plan
# → Создаёт план с AC в формате Given/When/Then

# 3. Выполнение
/paul:apply
# → Выполняет задачи по одной, проверяя каждую

# 4. Закрытие
/paul:unify
# → Логирует результаты, обновляет STATE.md

Интеграция с другими системами

BASE v2 (Контекстный движок)

PAUL работает автономно, но может интегрироваться с BASE v2 для: - Атрибуции затрат токенов по задачам - Связи между проектами в одной сессии - Автоматического внедрения правил через knowledge graph

Claude Code (основная платформа)

Родной инструмент для Claude Code
Использует /paul команды (slash commands в Claude Code)
Интегрирует агентов и контекст на уровне IDE

Чем это полезно для мультиагентных систем

Структурированность — каждый агент работает в рамках плана, не дрейфует
Качество — механизм Qualify гарантирует проверку на соответствие спецификации
Надёжность — UNIFY предотвращает потерю решений между сессиями
Масштабируемость — управление сложностью через decomposition
Прозрачность — ledger.toml показывает весь путь принятия решений

Ключевые метрики качества

Контекстная целостность — сохраняется между сессиями через STATE.md
Приёмка-первая — AC пишутся до кода
Независимая верификация — Qualify этап отделён от Execute
Честная отчётность — возможны статусы DONE_WITH_CONCERNS, NEEDS_CONTEXT, а не только "done"

Ссылки

GitHub репо: https://github.com/ChristopherKahler/paul
SkillsLLM: https://skillsllm.com/skill/paul

Примечание

PAUL — это решение для качественной, управляемой разработки с ИИ, противоположное подходу "максимум скорости любой ценой". Хорош для сложных проектов, требующих надёжности и прозрачности процесса.