CRISP — Метод Милевы

BA/PM-фреймворк для AI-разработчиков. От размытого клиентского брифа до готовой спецификации для Claude Code — без риска построить не то.

Большинство AI-реализаций проваливаются ещё до написания первой строки кода. Не потому что модель была неправильной. Не потому что инструменты были недостаточно хороши. Потому что никто не определил проблему. Никто не измерил базовые показатели. Никто не спросил зачем перед тем, как спросить как.

Вы — AI-разработчик. Вы умеете строить. Вы, вероятно, даже знаете, какие инструменты использовать. Чего у вас может не быть — пока — это методологии, которая гарантирует, что вы строите правильную вещь.

Это и есть та методология.

---

→ НАЧАТЬ ЗДЕСЬ

---

Что такое CRISP?

CRISP — это open-source фреймворк управления AI-проектами для разработчиков, консультантов и AI-агентств. Это структурированная 5-фазная методология, которая переводит вас от размытого клиентского запроса к полностью проработанному, готовому для Claude Code брифу реализации — до написания единой строки кода.

Создан для:

• Владельцев AI-агентств, ведущих клиентские реализации
• Соло-разработчиков, использующих Claude Code, Cursor или аналогичные агентные инструменты
• Консультантов, которым нужен воспроизводимый процесс от discovery до спецификации
• Продуктовых менеджеров, работающих над AI-нативными продуктами

Фаза	Название	Что делает
C	Clarify (Прояснение)	Определение проблемы, тест «болеутолитель», волшебная палочка, ограничения, buy vs build, исследование рынка — глобальный + региональный/локальный проход по конкурентам (внешний), канвас ценностного предложения (внешний), SWOT (внешний), Go/No-Go
R	Results (Результаты)	Реестр стейкхолдеров + зоны HITL (stakeholder-register.md), базовые измерения + целевые показатели успеха (success-metrics.md), согласование компромиссов
I	Investigate (Исследование)	Картирование процессов (существующих или greenfield), карты пользовательского пути для каждого типа системного пользователя, UX-discovery (внешний UI/Mobile/Web), цели проекта
S	Spec (Спецификация)	UX/дизайн-система, технический стек с зафиксированными версиями + NFR, правила безопасности API-ключей, сканирование Bearer-безопасности на каждый PR, начальный бэклог, журнал допущений, оценка рисков, приоритизация HVLE MVP, AI-архитектура, открытые вопросы по спринту, CLAUDE.md, планирование спринта, критерии качества
P	Prove (Доказательство)	Сдвинулась ли стрелка? Валидация относительно базовых показателей из фазы R.

---

Что нового в V2

V2 превращает CRISP из набора промптов в систему. Всё, что раньше держалось на дисциплине, теперь обеспечивается структурой.

/crisp-orchestrator — новая рекомендуемая точка входа

Заменяет ручное решение «на какой фазе я нахожусь?». Обнаруживает docs/crisp-state.json, сообщает текущую фазу и открытые вопросы, маршрутизирует автоматически. Работает для новых проектов и возобновления.

crisp-state.json — машиночитаемое состояние проекта

Один JSON-файл в docs/, обновляемый в конце каждой фазы. Каждая фаза сначала читает его; каждая фаза записывает в него при выходе. Claude перестаёт переинтерпретировать markdown, который он наполовину запомнил из фазы C, находясь в фазе S.

Новые обязательные результаты фазы S

• Спецификация логирования (docs/logging-spec.md) — уровни логов, правила PII, формат, назначение. Обязательно, не опционально.
• Сканирование Bearer-безопасности — критические/высокие находки блокируют слияние PR. Применяется как жёсткий шлюз, а не рекомендация.
• Спецификация аналитики (docs/analytics-spec.md) — карта событий GA4, напрямую привязанная к метрикам успеха из фазы R. Только для внешних UI-продуктов.
• Бриф лендинга (docs/landing-page-brief.md) — скомпилирован из VPC, исследования рынка, UX-discovery. Для внешних продуктов создание лендинга помечено как MVP — не как послезапускная задача.
• Спецификация безопасности агента (docs/agent-security.md) — соответствует AIUC-1. Обязательно, когда агент входит в область применения. Охватывает идентификацию/разрешения, обработку данных, режимы отказа.
• Отчёт о прогрессе (docs/progress-report.md) — артефакт передачи для клиентов и обеспечения непрерывности между сессиями.

Улучшенное извлечение требований в фазе S

• Исследование OSS-библиотек — структурированная оценка на GitHub для каждой open-source зависимости перед принятием решения. Звёзды, последний коммит, лицензия, отклонённые альтернативы с обоснованием.
• Извлечение маппинга данных — обязательный раздел в фазах I/S для функций, включающих структурированное извлечение или преобразование данных. Источник → маппинг полей → схема БД → граничные случаи.
• Переход Spec→Sprint — фаза S теперь явно указывает вам сказать «Начать Спринт 1». Без переключения режимов, без новой настройки.

Журнал решений по всем фазам

docs/decisions.md — каждое ключевое решение фиксируется с обоснованием и тем, что было отклонено. Поддаётся аудиту. Защищает вас, когда клиент спрашивает «почему вы построили это именно так?»

Вопрос владения памятью

Новое поле в фазе C (problem-statement.md) и технологическом стеке фазы S: требует ли клиент переносимости памяти агента между платформами? Всплывает до подписания контракта.

Обратная совместимость

Ничего не ломается. /crisp-start по-прежнему работает. Все фазовые скиллы ведут себя точно так же, как раньше. Если crisp-state.json не существует, каждая фаза корректно откатывается. V2 добавляет структуру поверх — ничего не убирает.

---

Почему существует CRISP

Каждый провал AI-проекта, который я видел, имел одну и ту же первопричину.

Разработчик получает бриф → сразу переходит к стеку → строит что-то технически впечатляющее → сдаёт → клиент говорит «это не то, что я имел в виду».

Шесть недель. Потрачено впустую.

Пробел не в разработке. Он во всём, что предшествует ей. CRISP заполняет этот пробел воспроизводимым, проверенным на клиентах процессом — от определения проблемы до sprint-ready AI-спецификаций.

---

Принципы CRISP

Извлекай, не допрашивай. Каждый вопрос в CRISP следует одному и тому же паттерну: предварительно заполни из того, что уже известно, представь гипотезу, дай клиенту исправить. Люди лучше реагируют, чем инициируют. Исправления выявляют реальные намерения.

Измеряй до, а не после. Фаза R существует по одной причине: если вы не знаете базовый показатель, вы не можете доказать ценность. Каждый успешный результат привязан к измеримому изменению.

Спецификация — это защита. CRISP не про бюрократию. Он про то, чтобы иметь письменное доказательство того, что вы согласовали, что вы построили и почему. Это защищает вас. Это защищает клиента.

Структура освобождает. Когда процесс ясен, вы тратите меньше умственной энергии на «что мне делать дальше» и больше на реальную работу.