Актуальная документация продукта
Одно требование в нескольких редакциях
Попросите ИИ-аналитика добавить корпоративный SSO при регистрации. Он предложит правки к требованию и связанным спецификациям. После применения Reqode сохранит новую редакцию под тем же ключом. На схеме видно, как требование менялось в запросах на добавление SSO и двухфакторной аутентификации.
Где хранится описание поведения
Если спецификацию копируют в задачу или документ к выпуску, копия отражает состояние на момент публикации. Ссылка на требование ведёт к записи с её редакциями и историей изменений.
Копии в задачах и документах
- Копия фиксирует текст на момент её создания.
- Причину последующих правок нужно искать в истории задачи.
- Связанные тесты и код могут обновляться по отдельности.
- При проверке приходится уточнять, какой текст действует сейчас.
Спецификации с историей
- Артефакт сохраняет ключ при изменении описания.
- Текущая редакция и предыдущие версии доступны из одной записи.
- Связи показывают, какие части системы затронуты.
- Новая задача может ссылаться на ту же спецификацию.
Из чего складывается история
Ключ, редакция и запрос на изменение помогают восстановить, какое решение действовало в конкретной ветке.
Постоянный ключ
Содержимое меняется, но ключ спецификации остаётся прежним. Старые ссылки продолжают вести к той же записи.
Редакции и статусы
Draft — черновик, Locked — зафиксированная редакция, Deprecated — устаревшая спецификация. Прежние редакции доступны для сравнения.
Контекст изменения
Запрос на изменение объединяет затронутые редакции и работы. В отдельной ветке можно готовить правки параллельно с основной.
Связи с кодом и проверками
Юниты ведут к исходным файлам. Тест-кейсы и замечания показывают, где ожидания ещё нужно сверить с реализацией.
Как пользоваться историей
Что актуально сейчас?
Откройте текущую редакцию в нужной ветке и проверьте её статус.
Почему это изменилось?
Сравните редакции и прочитайте запрос на изменение, в котором появилась правка.
Что затронуто?
Перейдите к связанным спецификациям, исходным файлам, тестам и задачам.
Что передать агенту разработки?
Укажите ключ артефакта и нужную ветку. Агент получит спецификации и архитектурные правила через MCP.
Связанные разделы
Возможности Reqode для работы с редакциями, запросами на изменение и проверками.