К основному содержанию
правило CX Codex

design-discovery-full — правило для Claude Code

Правило design-discovery-full проводит систематическое исследование требований, существующего кода, технологий и рисков перед тем, как начать дизайн. Помогает выбрать архитектуру на основе фактов, а не предположений.

MIT ★ 3 774 обновлён 2026-10-22

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/design-discovery-full.md
Открыть на GitHub

Что делает design-discovery-full

Правило разбивает подготовку к дизайну на шесть этапов: анализ требований (функциональных и нефункциональных), изучение текущей системы, исследование технологий и лучших практик через поиск и чтение документации, проверка внешних зависимостей, оценка архитектурных паттернов и анализ рисков. На каждом этапе ищет в WebSearch актуальные источники — от официальной документации до свежих статей за последние полгода — и анализирует их через WebFetch, выясняя API, совместимость версий, лимиты, безопасность.

Результаты фиксирует в research.md: ключевые выводы, ограничения, выбранные подходы с обоснованием, отвергнутые альтернативы и торговли, границы доменов, риски и пробелы для дальнейшего исследования. Правило даёт направление на каждом шаге — когда всегда искать (документация API, безопасность, версии), когда искать при неуверенности (паттерны, стандарты, масштабируемость) и как начать поиск (официальные источники, затем блоги и Stack Overflow).

Это подготовительное правило, которое включают перед тем, как просить ИИ спроектировать архитектуру, интеграцию или крупный компонент. Лучше работает в паре с правилом дизайна, которое затем опирается на research.md для принятия решений.

Какие задачи решает

  • собрать требования и технические ограничения в единый список
  • выбрать архитектурный паттерн, опираясь на практики и документацию, а не интуицию
  • проверить совместимость и лимиты внешних зависимостей перед началом кода
  • документировать риски и отвергнутые подходы, чтобы не вернуться к ним позже
  • исследовать текущую систему и найти точки для расширения или интеграции

Примеры запросов агенту

  • Проведи full discovery для нового модуля учёта платежей: требования, исследование payment-провайдеров, риски
  • Исследуй архитектуру перед тем, как менять абстракцию БД, документируй выводы в research.md
  • Найди лучшие практики масштабирования WebSocket-соединений и совместимость с текущим стеком

Как установить design-discovery-full

Вручную: положить файлы

.claude/rules/design-discovery-full.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о design-discovery-full

Как установить design-discovery-full в Claude Code?

Скопируй файл правила в папку .claude/rules/ вашего проекта: создай директорию, если её нет, и сохрани правило как design-discovery-full.md. Claude Code автоматически загрузит правило при следующей работе с проектом.

Что делает design-discovery-full?

Это правило — чек-лист исследований перед проектированием. Оно систематически пробегает по требованиям, существующему коду, технологиям, зависимостям, архитектурным паттернам и рискам, помогая собрать факты и задокументировать выводы в файл research.md.

Зачем нужно это правило, если можно просто попросить ИИ спроектировать?

ИИ может предложить дизайн, не зная о вашей текущей архитектуре, ограничениях или лучших практиках в вашей области. Это правило заставляет сначала исследовать, потом проектировать — так архитектура опирается на факты, а не на общее место.

Исходный текст

design-discovery-full.md · MIT
# Full Discovery Process for Technical Design

## Objective
Conduct comprehensive research and analysis to ensure the technical design is based on complete, accurate, and up-to-date information.

## Discovery Steps

### 1. Requirements Analysis
**Map Requirements to Technical Needs**
- Extract all functional requirements from EARS format
- Identify non-functional requirements (performance, security, scalability)
- Determine technical constraints and dependencies
- List core technical challenges

### 2. Existing Implementation Analysis
**Understand Current System** (if modifying/extending):
- Analyze codebase structure and architecture patterns
- Map reusable components, services, utilities
- Identify domain boundaries and data flows
- Document integration points and dependencies
- Determine approach: extend vs refactor vs wrap

### 3. Technology Research
**Investigate Best Practices and Solutions**:
- **Use WebSearch** to find:
  - Latest architectural patterns for similar problems
  - Industry best practices for the technology stack
  - Recent updates or changes in relevant technologies
  - Common pitfalls and solutions

- **Use WebFetch** to analyze:
  - Official documentation for frameworks/libraries
  - API references and usage examples
  - Migration guides and breaking changes
  - Performance benchmarks and comparisons

### 4. External Dependencies Investigation
**For Each External Service/Library**:
- Search for official documentation and GitHub repositories
- Verify API signatures and authentication methods
- Check version compatibility with existing stack
- Investigate rate limits and usage constraints
- Find community resources and known issues
- Document security considerations
- Note any gaps requiring implementation investigation

### 5. Architecture Pattern & Boundary Analysis
**Evaluate Architectural Options**:
- Compare relevant patterns (MVC, Clean, Hexagonal, Event-driven)
- Assess fit with existing architecture and steering principles
- Identify domain boundaries and ownership seams required to avoid team conflicts
- Consider scalability implications and operational concerns
- Evaluate maintainability and team expertise
- Document preferred pattern and rejected alternatives in `research.md`

### 6. Risk Assessment
**Identify Technical Risks**:
- Performance bottlenecks and scaling limits
- Security vulnerabilities and attack vectors
- Integration complexity and coupling
- Technical debt creation vs resolution
- Knowledge gaps and training needs

## Research Guidelines

### When to Search
**Always search for**:
- External API documentation and updates
- Security best practices for authentication/authorization
- Performance optimization techniques for identified bottlenecks
- Latest versions and migration paths for dependencies

**Search if uncertain about**:
- Architectural patterns for specific use cases
- Industry standards for data formats/protocols
- Compliance requirements (GDPR, HIPAA, etc.)
- Scalability approaches for expected load

### Search Strategy
1. Start with official sources (documentation, GitHub)
2. Check recent blog posts and articles (last 6 months)
3. Review Stack Overflow for common issues
4. Investigate similar open-source implementations

## Output Requirements
Capture all findings that impact design decisions in `research.md` using the shared template:
- Key insights affecting architecture, technology alignment, and contracts
- Constraints discovered during research
- Recommended approaches and selected architecture pattern with rationale
- Rejected alternatives and trade-offs (documented in the Design Decisions section)
- Updated domain boundaries that inform Components & Interface Contracts
- Risks and mitigation strategies
- Gaps requiring further investigation during implementation

© gotalab · MIT · gotalab/cc-sdd

Похожие правила IDE

Все правила IDE по теме «Дизайн» →
gcp-architecture-discovery sstawski Скилл gcp-architecture-discovery обходит GCP-проект от сбойного сервиса и собирает карту зависимостей: compute, сети, базы, бакеты. Результат кладёт в файлы, чтобы следующая сессия не начинала с нуля. CX Codex +1 ★ 151звёзд репо design-code-architecture wondelai Скилл design-code-architecture для Claude Code, Cursor и других платформ проводит вас через восемь фаз архитектурного проектирования — от границ и доменной модели через выбор данных до отказоустойчивости. CX Codex +1 2 700установок ux-research-discovery-testing hueyexe Скилл ux-research-discovery-testing помогает агенту планировать интервью, юзабилити-тесты и синтез находок, чтобы решения по продукту опирались на поведение пользователей, а не на догадки. CX Codex +1 545установок canvas-create-discovery Microsoft Субагент canvas-create-discovery для Claude Code проверяет доступные в Power Apps элементы управления, источники данных и API, фиксируя решения и ограничения. Оценивает осуществимость замысла холст-приложения. CX Codex ★ 1 167звёзд репо discovery-process deanpeters Скилл discovery-process помогает продакт-менеджерам разобрать гипотезу, спланировать интервью с пользователями и проверить варианты решения до написания кода. CX Codex +1 3 400установок om-setup-discovery-pipeline open-mercato Скилл om-setup-discovery-pipeline добавляет продуктовый слой поверх delivery-пайплайна: роли, Definition of Ready, research-директория. Включается, когда в репозитории нужно решать, что строить и зачем, до появления тикетов. CX Codex +1 2 400установок

Из того же набора12

Весь набор →
tasks-parallel-analysis Правило tasks-parallel-analysis для Claude Code: отмечает в tasks.md задачи, которые можно выполнять параллельно, учитывая зависимости между ними. CX Codex +1 ★ 3 774звёзд репо requirements-review-gate Правило requirements-review-gate останавливает работу и требует отремонтировать черновик требований перед тем, как начать писать requirements.md. Проверяет полноту охвата, формат EARS и структуру. CX Codex +1 ★ 3 774звёзд репо design-review-gate Правило design-review-gate проверяет черновик архитектуры перед формированием design.md. Находит пробелы в спецификациях и связывает каждый пункт требований с файловой структурой. CX Codex +1 ★ 3 774звёзд репо ears-format Правило ears-format задаёт формат EARS для критериев приёмки: условие, система и действие. Пригодится в spec-driven разработке. CX Codex +1 ★ 3 774звёзд репо design-review Правило design-review оценивает технический дизайн-документ перед началом кодинга и выносит вердикт GO или NO-GO. Ограничивает замечания тремя критическими пунктами со ссылками на требования. CX Codex +1 ★ 3 774звёзд репо cc-sdd-new-agent Скилл cc-sdd-new-agent помогает добавить нового coding-агента в cc-sdd по готовому SOP: от исследования формата до тестов и dry-run. CX Codex +1 ★ 3 774звёзд репо gap-analysis Правило gap-analysis помогает структурировать анализ существующей кодовой базы, выявить, чего не хватает для реализации требований, и выбрать стратегию разработки. CX Codex +1 ★ 3 774звёзд репо tasks-generation Правило tasks-generation задаёт формат декомпозиции проекта на задачи: делит разработку на четыре фазы, связывает подзадачи с требованиями и отсекает нетехническую работу. CX Codex +1 ★ 3 774звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой