Актуальная документация продукта

ИИ-аналитик предлагает обновления связанных спецификаций, когда меняются решения по продукту. После применения согласованных правок в Reqode доступны актуальные спецификации и их предыдущие редакции.

Одно требование в нескольких редакциях

Попросите ИИ-аналитика добавить корпоративный SSO при регистрации. Он предложит правки к требованию и связанным спецификациям. После применения Reqode сохранит новую редакцию под тем же ключом. На схеме видно, как требование менялось в запросах на добавление SSO и двухфакторной аутентификации.

Непрерывная история требования REQ-24 «Регистрация пользователя». Ревизия 1 поддерживает электронную почту и пароль. CR-12 добавляет корпоративный SSO в ревизии 2. CR-19 добавляет второй фактор в текущей ревизии 3. Ключ всё время остаётся REQ-24.

Где хранится описание поведения

Если спецификацию копируют в задачу или документ к выпуску, копия отражает состояние на момент публикации. Ссылка на требование ведёт к записи с её редакциями и историей изменений.

СТАТИЧНЫЕ ДОКУМЕНТЫ

Копии в задачах и документах

  • Копия фиксирует текст на момент её создания.
  • Причину последующих правок нужно искать в истории задачи.
  • Связанные тесты и код могут обновляться по отдельности.
  • При проверке приходится уточнять, какой текст действует сейчас.
МОДЕЛЬ ПРОДУКТА

Спецификации с историей

  • Артефакт сохраняет ключ при изменении описания.
  • Текущая редакция и предыдущие версии доступны из одной записи.
  • Связи показывают, какие части системы затронуты.
  • Новая задача может ссылаться на ту же спецификацию.

Из чего складывается история

Ключ, редакция и запрос на изменение помогают восстановить, какое решение действовало в конкретной ветке.

Постоянный ключ

Содержимое меняется, но ключ спецификации остаётся прежним. Старые ссылки продолжают вести к той же записи.

Редакции и статусы

Draft — черновик, Locked — зафиксированная редакция, Deprecated — устаревшая спецификация. Прежние редакции доступны для сравнения.

Контекст изменения

Запрос на изменение объединяет затронутые редакции и работы. В отдельной ветке можно готовить правки параллельно с основной.

Связи с кодом и проверками

Юниты ведут к исходным файлам. Тест-кейсы и замечания показывают, где ожидания ещё нужно сверить с реализацией.

Как пользоваться историей

Что актуально сейчас?

Откройте текущую редакцию в нужной ветке и проверьте её статус.

Почему это изменилось?

Сравните редакции и прочитайте запрос на изменение, в котором появилась правка.

Что затронуто?

Перейдите к связанным спецификациям, исходным файлам, тестам и задачам.

Что передать агенту разработки?

Укажите ключ артефакта и нужную ветку. Агент получит спецификации и архитектурные правила через MCP.

Связаться с нами

Поля, отмеченные *, обязательны для заполнения.

0 / 5 000

Можно также написать на info@reqode.com