Архив документов
Статус: active. Здесь хранятся завершённые, отменённые и явно устаревшие документы как временная историческая справка.
Назначение
Архив помогает быстро посмотреть, какое решение принималось раньше и почему. Он
не является источником текущих требований, критериев приёмки или команды. Для
актуальных правил используются AGENTS.md, docs/README.md и активные планы.
Если решение снова понадобится, его можно восстановить из git history или
создать новый активный документ: архивные файлы удаляются, а не хранятся
вечно. Удалённые планы восстановимы через
git log --diff-filter=D -- name-only -- docs/archive/ и
git show <commit>^:<path>.
Обязательные метаданные
При переносе документа в архив добавить в начало:
> Статус: archived
> Архивирован: YYYY-MM-DD
> Удалить после: YYYY-MM-DD
> Причина: краткое объяснение, почему документ больше не активен
> Использование: только историческая справка
Дата Удалить после — дата архивирования плюс 30 дней.
Порядок архивирования
- Убедиться, что документ действительно завершён, отменён или заменён более актуальным источником.
- Убрать из него ссылки на несуществующие пути и артефакты прошлых волн.
- Добавить обязательные метаданные.
- Переместить файл в
docs/archive/. - Проверить ссылки из backlog, планов, checklist и
docs/README.md: удалённые файлы должны потерять и входящие ссылки. - Не менять архивный документ под новые требования.
Удаление
Через 30 дней после архивирования:
- проверить, что документ не нужен для текущей работы;
- найти и удалить оставшиеся ссылки на него из активных документов;
- удалить файл из
docs/archive/.
До истечения срока архивный файл не превращается обратно в live-документ: если он снова актуален, создаётся новый документ или возвращается версия из git истории с новым статусом и датами.