PDCA Framework
kenjudy/pdca-frameworkФреймворк для AI-assisted разработки с TDD и рефакторингом по циклу Plan-Do-Check-Act. Работает как Claude Code skill или через ручные промпты. Подходит для одиночных сессий и многодневных задач с поддержкой cross-session памяти.
Установка
git clone https://github.com/kenjudy/pdca-framework.gitREADME
PDCA Framework
Дисциплинированный фреймворк для AI-assisted генерации кода по методологии Plan-Do-Check-Act со строгим TDD-подходом.
Три способа использования
Вариант 1: Claude Skill — стандартный (рекомендуется для большинства пользователей)
Установить один раз — автоматически активируется при написании кода
- Подходит для: единообразного PDCA-воркфлоу во всех сессиях
- Настройка: установка в один клик в Claude.ai или Claude Code
- Опыт использования: автоматическая загрузка промптов, прогрессивное раскрытие
- Эффективность токенов: загружает только необходимое в фоне
- Обслуживание: обновить один раз — улучшается везде
- Платформы: macOS, Linux, Windows
📦 Начать работу со стандартным Skill →
Вариант 2: Claude Skill — с Beads (для длительных задач)
Стандартный skill + постоянное отслеживание задач между сессиями
- Подходит для: сложных фич, растянутых на несколько дней/недель
- Дополнительные возможности: git-backed память, непрерывность между сессиями, поиск по ретроспективам
- Требования: установить beads CLI и MCP-сервер (Go 1.23+, ICU headers)
- Работает как: стандартный skill с опциональными beads-командами в каждой фазе
- Обратная совместимость: все beads-команды опциональны — пропускайте их, если beads не установлен
🎯 Начать работу с Beads Skill →
Вариант 3: ручные промпты (лучший вариант для кастомизации)
Копируйте и вставляйте промпты по мере необходимости в каждой сессии
- Подходит для: адаптации промптов под конкретные контексты
- Настройка: создайте симлинки или скопируйте файлы в директорию
.claude/ - Опыт использования: 100% видимость в диалоге, полный контроль
- Гибкость: легко настраивать под каждую сессию
- Переносимость: работает с любым AI-инструментом, не только с Claude
- Платформы: macOS, Linux, Windows
📝 Начать работу с ручными промптами →
Какой вариант выбрать?
| Сценарий использования | Рекомендуемый подход |
|---|---|
| Изучение фреймворка | Ручные промпты — чтобы понять каждую фазу |
| Быстрое исправление бага (одна сессия) | Стандартный Skill — для удобства |
| Регулярные сессии разработки | Стандартный Skill — для единообразного воркфлоу |
| Многодневные фичи | Beads Skill — для непрерывности между сессиями |
| Сложные эпики с зависимостями | Beads Skill — для отслеживания графа задач |
| Стандартизация в команде | Стандартный Skill — обеспечивает единообразие |
| Поиск по ретроспективам | Beads Skill — git-backed хранение выводов |
| Кастомные воркфлоу | Ручные промпты — полная гибкость |
| Сторонние AI-инструменты | Ручные промпты (skill специфичен для Claude) |
Варианты можно комбинировать! Многие пользователи:
- устанавливают стандартный Skill для ежедневной работы;
- держат ручные промпты для особых случаев;
- добавляют Beads Skill при старте сложных долгосрочных фич.
Зачем нужен этот фреймворк
Исследования показывают: AI-генерация кода без контроля человека ведёт к измеримой деградации качества:
- рост дублирования кода в 10 раз (GitClear 2024);
- снижение стабильности поставок на 7,2% при каждом увеличении доли AI на 25% (Google DORA 2024);
- замедление разработки на 19% при использовании AI-инструментов по сравнению с работой без них (METR 2025).
PDCA Framework удерживает человека в активной роли — вовлечённым, наделённым полномочиями и ответственным — используя структурированные промпты для регулирования поведения агента в сторону прозрачности и дисциплины.
Полная статья о фреймворке: SOSA 2025 Notes — презентация подготовлена для XP 2026
Обзор PDCA Framework
Воркфлоу PDCA состоит из четырёх фаз:
- Plan — анализ и детальное планирование
- Do — реализация через TDD
- Check — проверка полноты
- Act — ретроспектива и непрерывное улучшение
Настройка ручных промптов (Claude Code)
Оставшаяся часть документа описывает настройку воркфлоу с ручными промптами в Claude Code с использованием симлинков.
Для настройки Claude Skill (рекомендуется) см. claude-skill/README.md.
Предварительные требования
- Установленный Claude Code CLI
- Git
Только для Windows: Windows 10/11 с включённым режимом разработчика (для создания симлинков без прав администратора)
Структура проекта
После настройки проект должен иметь следующую структуру:
your-project/
├── .claude/
│ ├── instructions.md # Основные инструкции воркфлоу
│ ├── prompts/ # Симлинки на шаблоны фаз
│ │ ├── 1a Analyze to determine approach for achieving the goal.md
│ │ ├── 1b Create a detailed implementation plan.md
│ │ ├── 2. Test Drive the Change.md
│ │ ├── 3. Completeness Check.md
│ │ └── 4. Retrospect for continuous improvement.md
│ └── validation.md # Чеклист перед коммитом
├── .claudeignore # Файлы, которые Claude должен игнорировать
└── LinkPrompts.ps1 # Только Windows: скрипт создания симлинков
Шаги настройки
1. Настройка Git для симлинков
git config core.symlinks true
Только для Windows: сначала включите режим разработчика:
- Откройте «Параметры» → «Обновление и безопасность» → «Для разработчиков»
- Включите Режим разработчика
- Перезапустите PowerShell/Terminal
2. Создание структуры директорий
macOS/Linux:
mkdir -p .claude/prompts
Windows (PowerShell):
New-Item -ItemType Directory -Path ".claude\prompts" -Force
3. Создание симлинков на шаблоны промптов
macOS/Linux:
# Замените $TEMPLATES_PATH на реальный путь к шаблонам PDCA
TEMPLATES_PATH="/path/to/pdca-templates"
ln -s "$TEMPLATES_PATH/1. Plan/1a Analyze to determine approach for achieving the goal.md" \
".claude/prompts/1a Analyze to determine approach for achieving the goal.md"
ln -s "$TEMPLATES_PATH/1. Plan/1b Create a detailed implementation plan.md" \
".claude/prompts/1b Create a detailed implementation plan.md"
ln -s "$TEMPLATES_PATH/2. Do/2. Test Drive the Change.md" \
".claude/prompts/2. Test Drive the Change.md"
ln -s "$TEMPLATES_PATH/3. Check/3. Completeness Check.md" \
".claude/prompts/3. Completeness Check.md"
ln -s "$TEMPLATES_PATH/4. Act/4. Retrospect for continuous improvement.md" \
".claude/prompts/4. Retrospect for continuous improvement.md"Windows (PowerShell):
# Запустите скрипт LinkPrompts.ps1 из корня репозитория
.\LinkPrompts.ps1Использование ручных промптов
После настройки используйте команду /prompts в Claude Code для доступа к шаблонам фаз:
/prompts/1a Analyze...— начать анализ задачи/prompts/1b Create...— создать детальный план реализации/prompts/2. Test Drive...— реализовать изменения через TDD/prompts/3. Completeness Check— проверить полноту реализации/prompts/4. Retrospect...— провести ретроспективу
Дополнительные ресурсы
- claude-skill/README.md — настройка и использование Claude Skill
- SOSA 2025 Notes — теоретическая база фреймворка
- XP 2026 Presentation — презентация о человекоцентричной AI-разработке