Юниты
Зачем выделять юниты
Одно требование часто затрагивает несколько файлов. Связи с юнитами показывают, за какую часть поведения отвечает каждый участок кода.
Юнит имеет ключ и историю редакций. Он может соответствовать одному файлу или набору файлов, которые выполняют общую роль.
От спецификации к исходным файлам
Связи показывают, где реализовано поведение и какие правила применяются к этим файлам.
Требования и спецификации
Требование описывает ожидаемое поведение. Связанные интерфейсы, данные и API уточняют, как устроен сценарий.
Почему и что должно существовать
Юнит
У юнита есть ключ, тип, файлы, технические зависимости, связи со спецификациями и результаты проверки.
Ответственность и правила реализации
Исходные файлы и коммиты
Пути указывают на файлы реализации. Связанные коммиты показывают, какие изменения затронули эти файлы.
Где реализуется поведение
Как связаны спецификации и файлы
Например, юнит диалога согласования может ссылаться на спецификацию интерфейса, связанную операцию API и файлы компонента.
Какие правила действуют для файлов
Общие правила берутся из Code Manifest подсистемы, требования к роли — из типа юнита. Для одного юнита можно добавить отдельные указания.
Состав файлов и допустимые связи зависят от правил проекта.
Что хранится в юните
Ключ, тип и история
Ключ связывает редакции одного юнита. Из записи также видны название, подсистема, область проекта и статус.
Исходные файлы
Список путей показывает, какие файлы входят в юнит. В зависимости от его роли это может быть один файл или несколько.
Правила реализации
Для юнита доступны правила подсистемы и типа, а также дополнительные указания для его реализации.
Связи и результаты проверок
По связям можно открыть спецификации, потребителей, зависимости и коммиты. Статус синхронизации и замечания помогают найти изменения, которые нужно проверить.
Примеры состава юнитов
Границы юнита определяются его ответственностью. Правила типа задают, какие файлы могут входить в него.
Компонент формы регистрации
/components/auth/useSignupForm.ts
/components/auth/SignupForm.test.ts
Юнит может объединять форму регистрации, её поведение и тесты, если это предусмотрено типом.
Действие регистрации пользователя
RegisterUserAction.php
Действие в одном файле следует правилам расположения, именования, зависимостей и поведения своего типа.
Адаптер платёжного провайдера
/billing/billing-contract.ts
/billing/BillingClient.test.ts
Если файлы совместно реализуют один адаптер, их можно включить в один юнит.
В конкретном проекте состав юнитов определяется его архитектурой и типами.
Как используются юниты
Юниты помогают описать существующую реализацию, определить область изменения и проверить результат.
Описание существующего кода
Привяжите репозитории к подсистемам и веткам. Unit Discovery сопоставляет выбранные файлы с юнитами и уточняет их типы и прямые зависимости.
Границы изменения
Свяжите спецификации с юнитами, которые их реализуют. Для нового поведения опишите планируемую роль и состав файлов.
Контекст для реализации
Передайте агенту относящиеся к задаче правила, спецификации, файлы и зависимости.
Проверка результата
Просмотрите затронутые коммиты и результаты проверок соответствия спецификациям и правилам реализации.
Как агент находит спецификации для файла
Запросите через MCP инструмент trace-file. Он находит связанные юниты и спецификации по пути к файлу.
Используй спецификации Reqode через MCP. Обнови /components/auth/SignupForm.vue по запросу CR-123.
Контекст выбранной ветки и подсистемы
- Проект, подсистема и ветка
- Юнит и его тип
- Правила подсистемы, типа и конкретного юнита
- Связанные спецификации, файлы и прямые зависимости
Связанные разделы
Как подключить агента и проверить работу с учётом спецификаций и архитектурных правил.