mirror of
https://github.com/Matysh/houseplan-card
synced 2026-09-28 19:01:34 +00:00
Ревью #682 r1, Medium: перенос добавляет документу уровень вложенности (`docs/reviews/X.md` → `legacy/reviews/<тег>/X.md`, `docs/specs/` → `legacy/specs/`), а относительные ссылки внутри перенесённых документов и в соседях, ссылавшихся на них, никто не пересчитывал — на `97d19268` 53 битые ссылки в 46 файлах (заявление «все 26 резолвятся» в `7feb6177` было верно только до переноса документов ревью). Гейты архив не смотрят. `reviews-archive.mjs`: `repairLinks` пересчитывает ссылку, если она не резолвится от нового места, а цель находится от нового или старого места через карту переносов; битая и до переноса ссылка не трогается. `--apply` делает это само, `--repair-links=<rev>` — для всех переименований `<rev>..HEAD`, `--check-links` печатает битые. Этим коммитом `--repair-links=origin/dev` переписал ровно 53 ссылки в 46 файлах; остались две прежние «...»-заглушки в CODE-REVIEW-448-r2 (битые и на dev). Тесты: перенесённый документ, сосед со ссылкой в архив, ТЗ со ссылкой на позже перенесённое ревью, битая-до-переноса не трогается, в `legacy/` битых нет; мутант `reviews-archive-links-from-new-place-only`. PROCESS §2.10 и DEVELOPMENT › Release называют переписывание и `--check-links`. Issue: #682 User-Visible: no Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018qZfe7YS4rqEMKoVeS3GKd
Legacy archive
Здесь хранятся исторические материалы, которые больше не являются источником истины для текущей версии House Plan. Они оставлены для расследования старых решений и регрессий, но не участвуют в сборке, тестах или релизе. На них можно ссылаться из кода и документов только как на историю решения — не как на действующий контракт.
| Путь | Почему перенесено |
|---|---|
docs/SUN-CONTRAST.md |
Отклонённая модель солнечного контраста; реализована только описанная в актуальном docs/SUN.md кромка. На неё ссылаются src/sun.ts и docs/SUN.md как на историю решения |
docs/superpowers/specs/ |
Одиннадцать дизайн-документов 2026-08-05…08-10, написанных до процесса. Историческая справка: действующее ТЗ живёт в теле issue (#517), docs/specs/ — архив ТЗ. Код и ТЗ ссылаются на них по этому пути |
docs/ROADMAP.md |
Историческое направление инженерной работы с открытыми чекбоксами — параллельный бэклог, которого процесс не допускает (PROCESS.md §12); текущие задачи только в GitHub Issues |
docs/STATUS-FEATURES.md |
Параллельный список фич и вех (обрывается на v1.23.1); поверхность продукта описывают changelog и руководство пользователя |
docs/QUALITY-560.md |
Разовый отчёт о качестве по #560; на него ссылается комментарий demo/smoke_household_journeys.mjs |
reviews/<тег>/ |
Документы ревью задач выпущенных стабильных линий (#635, #682): переносит node scripts/reviews-archive.mjs --through=<тег> --apply после стабильного релиза (PROCESS.md §2.10). Первый перенос — линии до v1.77.0 включительно, 965 документов. Живой индекс docs/reviews/INDEX.md перечисляет только текущую линию |
specs/ |
ТЗ выпущенных задач без живых ссылок (#682, 219 файлов). Имя начинается с номера issue: ls legacy/specs/<NN>-*. ТЗ с живыми ссылками остались в docs/specs/ |
Удалённое из архива (#678, в дереве больше нет — только история git):
снимок аудита docs/audit-v1.58.0/, черновик docs/089-isometric-view-draft.md,
завершённые планы docs/implementation-plans/, продуктовые снимки
docs/PRODUCT-2026-07-05.md и docs/PRODUCT-IMPROVEMENT-PLAN.ru.md, разовые
диагностики demo/dbg_click.mjs и demo/repro_issue3.mjs.
Актуальные точки входа:
- пользовательская документация и руководство;
- GitHub Issues — единственный актуальный backlog, статус в метках (
PROCESS.md§9); - статус проекта;
- архитектура.