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

ears-format — правило для Claude Code: требования и установка

Правило ears-format задаёт формат EARS для критериев приёмки: условие, система и действие. Пригодится в spec-driven разработке.

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

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

Что делает ears-format

ears-format задаёт структуру EARS для критериев приёмки: условие или событие, конкретный субъект и обязательное действие системы. Правило охватывает пять случаев: событие, состояние, нежелательное поведение, опциональную функцию и постоянное требование.

Фиксированные конструкции When, If, While, Where, The system shall и The [system] shall остаются на английском. Переменные части переводятся на язык спецификации, заданный через spec.json.language, например en. Критерии должны описывать одно проверяемое поведение и использовать shall для обязательных требований.

Правило заявлено для Claude Code и Codex. Для Claude Code файл размещают по пути .claude/rules/ears-format.md. Если нужен полностью русскоязычный синтаксис критериев, правило не подойдёт: ключевые фразы EARS остаются на английском.

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

  • структурировать критерии приёмки по EARS
  • разделить условие, субъект и действие системы
  • оформить требования для событий и состояний
  • описать ошибки через проверяемое поведение
  • сохранить единый язык спецификации

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

  • Оформи критерии приёмки для оплаты по шаблонам EARS.
  • Проверь требования в спецификации и оставь When, If и The system shall на английском.
  • Перепиши критерии на язык из spec.json.language, локализуя только переменные части.

Как установить ears-format

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

.claude/rules/ears-format.md

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

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

Вопросы об ears-format

Как установить ears-format в Claude Code?

Разместите файл по пути .claude/rules/ears-format.md.

Что делает ears-format?

Правило задаёт синтаксис EARS для критериев приёмки. Оно разделяет условие, субъект и действие, а также требует проверяемого поведения.

Можно ли писать критерии полностью на русском?

Нет. Переменные части переводятся на язык спецификации, но ключевые фразы EARS, включая When и The system shall, остаются на английском.

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

ears-format.md · MIT
# EARS Format Guidelines

## Overview
EARS (Easy Approach to Requirements Syntax) is the standard format for acceptance criteria in spec-driven development.

EARS patterns describe the logical structure of a requirement (condition + subject + response) and are not tied to any particular natural language.  
All acceptance criteria should be written in the target language configured for the specification (for example, `spec.json.language` / `en`).  
Keep EARS trigger keywords and fixed phrases in English (`When`, `If`, `While`, `Where`, `The system shall`, `The [system] shall`) and localize only the variable parts (`[event]`, `[precondition]`, `[trigger]`, `[feature is included]`, `[response/action]`) into the target language. Do not interleave target-language text inside the trigger or fixed English phrases themselves.

## Primary EARS Patterns

### 1. Event-Driven Requirements
- **Pattern**: When [event], the [system] shall [response/action]
- **Use Case**: Responses to specific events or triggers
- **Example**: When user clicks checkout button, the Checkout Service shall validate cart contents

### 2. State-Driven Requirements
- **Pattern**: While [precondition], the [system] shall [response/action]
- **Use Case**: Behavior dependent on system state or preconditions
- **Example**: While payment is processing, the Checkout Service shall display loading indicator

### 3. Unwanted Behavior Requirements
- **Pattern**: If [trigger], the [system] shall [response/action]
- **Use Case**: System response to errors, failures, or undesired situations
- **Example**: If invalid credit card number is entered, then the website shall display error message

### 4. Optional Feature Requirements
- **Pattern**: Where [feature is included], the [system] shall [response/action]
- **Use Case**: Requirements for optional or conditional features
- **Example**: Where the car has a sunroof, the car shall have a sunroof control panel

### 5. Ubiquitous Requirements
- **Pattern**: The [system] shall [response/action]
- **Use Case**: Always-active requirements and fundamental system properties
- **Example**: The mobile phone shall have a mass of less than 100 grams

## Combined Patterns
- While [precondition], when [event], the [system] shall [response/action]
- When [event] and [additional condition], the [system] shall [response/action]

## Subject Selection Guidelines
- **Software Projects**: Use concrete system/service name (e.g., "Checkout Service", "User Auth Module")
- **Process/Workflow**: Use responsible team/role (e.g., "Support Team", "Review Process")
- **Non-Software**: Use appropriate subject (e.g., "Marketing Campaign", "Documentation")

## Quality Criteria
- Requirements must be testable, verifiable, and describe a single behavior.
- Use objective language: "shall" for mandatory behavior, "should" for recommendations; avoid ambiguous terms.
- Follow EARS syntax: [condition], the [system] shall [response/action].

© gotalab · MIT · gotalab/cc-sdd

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

Каталог правил IDE →
baoyu-format-markdown JimLiu Скилл baoyu-format-markdown форматирует plain text и Markdown: добавляет структуру, frontmatter, заголовки, списки и код. Результат сохраняется в {filename}-formatted.md. CX Codex +1 28 800установок ad-format-fit Maya-Beth Finotti Скилл ad-format-fit проверяет, какие рекламные форматы вообще доступны под вашу цель и площадку, и отделяет проблему формата от проблемы креатива или таргетинга. CX Codex +1 26 000установок event-format-selection Samuel Berthe Скилл event-format-selection помогает определить формат ИТ-мероприятия до составления сетки: выбрать тип события, число треков, соотношение докладов и воркшопов, а также формат участия. CX Codex +1 6 800установок format-string-exploitation yaklang Скилл format-string-exploitation для Claude Code разбирает уязвимости форматных строк в функциях семейства printf. Он подключается к задачам чтения памяти, утечек адресов и анализа записи через %n. CX Codex +1 4 000установок tao-validate-dataset-format NVIDIA Corporation Скилл tao-validate-dataset-format для Claude Code проверяет набор данных NVIDIA TAO DAFT командой tao-daft validate. Проверяет структуру, схему и ссылки между данными. CX Codex +1 1 600установок tao-convert-dataset-format NVIDIA Corporation Скилл tao-convert-dataset-format для Claude Code запускает tao-daft convert, чтобы преобразовать датасет NVIDIA TAO DAFT между поддерживаемыми форматами. Задача — подготовить DAFT-данные к обучению VLM. CX Codex +1 1 600установок

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

Весь набор →
steering-principles Правило steering-principles задаёт стандарты файлов памяти проекта: фиксирует паттерны и архитектуру без перегрузки агента полными списками файлов. CX Codex +1 ★ 3 774звёзд репо 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звёзд репо design-discovery-full Правило design-discovery-full проводит систематическое исследование требований, существующего кода, технологий и рисков перед тем, как начать дизайн. Помогает выбрать архитектуру на основе фактов, а не предположений. 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звёзд репо

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

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