mirror of
https://github.com/Matysh/houseplan-card
synced 2026-09-29 03:09:36 +00:00
docs(hygiene): ТЗ выпущенных задач без живых ссылок — в legacy/specs (#682)
Волна 5 эпика #674, перенос ТЗ (класс C). Из 240 файлов `docs/specs/` в `legacy/specs/` уехали 219: на них не ссылается ни один живой файл (код, тесты, скрипты, workflow, документы вне архива и ревью). Остались 21 ТЗ — на которые ссылаются код, ADR, ISOMETRIC, SUN, RADAR, LIGHT (`docs/specs/067`), DECOR-EDITOR, support-relay, и те, на которые ссылаются они сами; README каталога объясняет, где искать остальное. Открытых issue с файлом ТЗ среди перенесённых нет. Относительные ссылки перенесённых файлов переписаны (`../X` → `../../docs/X`, соседние оставшиеся ТЗ → `../../docs/specs/…`) — все 26 резолвятся. Попутно: битая ссылка в `089-isometric-view-stage1.md:8` на удалённый `089-isometric-view.md` — теперь команда `git show` по истории. Строка в `legacy/README.md`. Issue: #682 User-Visible: no Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_018qZfe7YS4rqEMKoVeS3GKd
This commit is contained in:
@@ -5,8 +5,9 @@
|
||||
- Статус ТЗ: **принято к реализации** (ревизия 3, решения владельца и зелёное
|
||||
независимое ревью ТЗ 2026-08-13).
|
||||
Ревизия 2 предшествует действующему процессу и новым визуальным референсам.
|
||||
- Исследование и продуктовое обоснование: [`089-isometric-view.md`](089-isometric-view.md)
|
||||
(контекст; нормативен настоящий файл)
|
||||
- Исследование и продуктовое обоснование — прежний `089-isometric-view.md`,
|
||||
в дереве его больше нет (`git show 446f33ed:docs/specs/089-isometric-view.md`);
|
||||
нормативен настоящий файл
|
||||
- Историческое ревью ревизии 1 не является доступным артефактом репозитория и
|
||||
не заменяет новое ревью по `PROCESS.md`.
|
||||
- Связано: #82 (анимация zoom/fit), #73 (визуальная непрерывность), #85 (тесты
|
||||
|
||||
@@ -4,7 +4,9 @@
|
||||
|
||||
Почему переехало: файл решал ровно одну задачу — доказать, что вердикт ревью вынесен на конкретном тексте, — и создавал две. Индекс в этом README конфликтовал между параллельными задачами и служил вторым, отстающим словарём статусов; каждая правка ТЗ стоила коммита, пуша и метки. Доказуемость теперь обеспечивает конвейер: в блок якорей документа ревью пишется `sha256` нормализованного тела issue, а правка ТЗ после зелёного ревью ТЗ приходит ревьюеру кода находкой (`PROCESS.md` §2.3, §7.1).
|
||||
|
||||
Единственный канонический backlog проекта — GitHub Issues; статус задачи — её метка `S1-new`…`S8-merged` (`PROCESS.md` §9). Индекс «issue ↔ ТЗ» здесь не ведётся: имя файла архива начинается с номера issue, этого достаточно, чтобы найти его командой `ls docs/specs/<NN>-*`.
|
||||
Единственный канонический backlog проекта — GitHub Issues; статус задачи — её метка `S1-new`…`S8-merged` (`PROCESS.md` §9). Индекс «issue ↔ ТЗ» здесь не ведётся: имя файла архива начинается с номера issue, этого достаточно, чтобы найти его командой `ls docs/specs/<NN>-* legacy/specs/<NN>-*`.
|
||||
|
||||
Здесь остались только ТЗ, на которые ссылаются живые код, тесты и документы (ADR, `ISOMETRIC.md`, `SUN.md`, `RADAR.md`, `LIGHT.md`, `DECOR-EDITOR.md`, support-relay), и те, на которые ссылаются они сами. Остальные ТЗ выпущенных задач перенесены в [`legacy/specs/`](../../legacy/specs/) (#682): историю не переписываем, ссылки из документов ревью ведут по SHA и живут дальше. Каталог нужен `scripts/task-packet.mjs` и проверке 3 `scripts/process-gate.mjs`.
|
||||
|
||||
## Обязательные release-артефакты ТЗ
|
||||
|
||||
|
||||
@@ -13,6 +13,7 @@
|
||||
| `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` |
|
||||
| `specs/` | ТЗ выпущенных задач без живых ссылок (#682, 219 файлов). Имя начинается с номера issue: `ls legacy/specs/<NN>-*`. ТЗ с живыми ссылками остались в `docs/specs/` |
|
||||
|
||||
Удалённое из архива (#678, в дереве больше нет — только история git):
|
||||
снимок аудита `docs/audit-v1.58.0/`, черновик `docs/089-isometric-view-draft.md`,
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# ТЗ #20 — Glow проходит через дверь по её фактическому состоянию
|
||||
|
||||
- Issue: https://github.com/Matysh/houseplan-card/issues/20
|
||||
- Каноническая модель света: [`docs/LIGHT.md`](../LIGHT.md)
|
||||
- Каноническая модель света: [`docs/LIGHT.md`](../../docs/LIGHT.md)
|
||||
- Связано: #19, #55, #71, #92, #306
|
||||
|
||||
## Сценарий
|
||||
@@ -11,10 +11,10 @@ Issue: [#164](https://github.com/Matysh/houseplan-card/issues/164)
|
||||
|
||||
Ветка: `issue/164-washer-active-cycle`
|
||||
|
||||
Канонические документы: [SCOPE](../SCOPE.md),
|
||||
[TOUCH-SUPPORT](../TOUCH-SUPPORT.md), [USER-GUIDE](../USER-GUIDE.md),
|
||||
[USER-GUIDE.ru](../USER-GUIDE.ru.md),
|
||||
[CONFIG-COMPATIBILITY](../CONFIG-COMPATIBILITY.md).
|
||||
Канонические документы: [SCOPE](../../docs/SCOPE.md),
|
||||
[TOUCH-SUPPORT](../../docs/TOUCH-SUPPORT.md), [USER-GUIDE](../../docs/USER-GUIDE.md),
|
||||
[USER-GUIDE.ru](../../docs/USER-GUIDE.ru.md),
|
||||
[CONFIG-COMPATIBILITY](../../docs/CONFIG-COMPATIBILITY.md).
|
||||
|
||||
## 1. Сценарий и персона
|
||||
|
||||
@@ -6,10 +6,10 @@
|
||||
|
||||
Issue: [#166](https://github.com/Matysh/houseplan-card/issues/166)
|
||||
Ветка: `issue/166-sun-north-rotation`
|
||||
Канонические документы: [SCOPE](../SCOPE.md), [SUN](../SUN.md),
|
||||
[USER-GUIDE](../USER-GUIDE.md), [USER-GUIDE.ru](../USER-GUIDE.ru.md),
|
||||
[TOUCH-SUPPORT](../TOUCH-SUPPORT.md), [TESTING](../TESTING.md),
|
||||
[CONFIG-COMPATIBILITY](../CONFIG-COMPATIBILITY.md).
|
||||
Канонические документы: [SCOPE](../../docs/SCOPE.md), [SUN](../../docs/SUN.md),
|
||||
[USER-GUIDE](../../docs/USER-GUIDE.md), [USER-GUIDE.ru](../../docs/USER-GUIDE.ru.md),
|
||||
[TOUCH-SUPPORT](../../docs/TOUCH-SUPPORT.md), [TESTING](../../docs/TESTING.md),
|
||||
[CONFIG-COMPATIBILITY](../../docs/CONFIG-COMPATIBILITY.md).
|
||||
|
||||
## 1. Сценарий и продуктовый контекст
|
||||
|
||||
@@ -12,11 +12,11 @@ Issue: [#167](https://github.com/Matysh/houseplan-card/issues/167)
|
||||
Зависимость: [#50](https://github.com/Matysh/houseplan-card/issues/50) — выполнена
|
||||
и выпущена в stable v1.62.0.
|
||||
|
||||
Канонические документы: [SCOPE](../SCOPE.md),
|
||||
[CONFIG-COMPATIBILITY](../CONFIG-COMPATIBILITY.md),
|
||||
[TOUCH-SUPPORT](../TOUCH-SUPPORT.md), [USER-GUIDE](../USER-GUIDE.md),
|
||||
[USER-GUIDE.ru](../USER-GUIDE.ru.md),
|
||||
[ТЗ #50](050-config-export-import.md).
|
||||
Канонические документы: [SCOPE](../../docs/SCOPE.md),
|
||||
[CONFIG-COMPATIBILITY](../../docs/CONFIG-COMPATIBILITY.md),
|
||||
[TOUCH-SUPPORT](../../docs/TOUCH-SUPPORT.md), [USER-GUIDE](../../docs/USER-GUIDE.md),
|
||||
[USER-GUIDE.ru](../../docs/USER-GUIDE.ru.md),
|
||||
[ТЗ #50](../../docs/specs/050-config-export-import.md).
|
||||
|
||||
## 1. Сценарий и персона
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user