# 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`.

Актуальные точки входа:

- [пользовательская документация](../README.ru.md) и [руководство](../docs/USER-GUIDE.ru.md);
- [GitHub Issues](https://github.com/Matysh/houseplan-card/issues) — единственный актуальный backlog, статус в метках (`PROCESS.md` §9);
- [статус проекта](../docs/STATUS.md);
- [архитектура](../docs/ARCHITECTURE.md).