Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@ The documents under `docs/` and RUN.md are in Russian (R25); they are cited by s
- [docs/decisions.md](docs/decisions.md) — the decision log, R01…: what was decided, why, and what was rejected. Read it before proposing a design change.
- [docs/stack.html](docs/stack.html) — the stack by architecture layer: each technology with its version, status and the section, decision or task behind it. A summary, not a source: where it differs from spec, the decision log or RUN.md, they win.
- [RUN.md](RUN.md) — the implementation plan, in epics (R44). Table 1 holds the current epic's tasks, run one at a time; table 2 holds later epics, broken into tasks only when their turn comes; table 3 holds the questions the author has not answered yet, and table 4 the technical debt. Full executor rules are in its «Как пользоваться» section.
- `docs/plan/` — the archive of done epics, a file per epic with its tasks as they were when done (R59); and `E2-draft.md`, the old draft of the beta's tasks, written before the LLM-first turn and never run: the raw material for splitting E15, which also keeps the pre-split text of the six tasks E2 took over (T16, T18, T19, T34, T35, T48). Not read whole: a task cited by number, "RUN.md, T11" included, that RUN.md no longer holds is found by its heading, `grep -n '^#### T11\.' RUN.md docs/plan/*.md`.
- `docs/live/` — reports of the spikes and of live runs in the cloud (from T12). Every report follows one format:
- its status, in the first line under the title;
- no identifier of a person or an account — no email, UID, invite code, billing account or token: the repository is public;
Expand Down Expand Up @@ -145,7 +146,7 @@ infra/terraform/ the Google Cloud project as code — not to be confused with i
infra/bootstrap.sh the one-time step that makes what the pipeline signs in with: project, state bucket, WIF
web/ the SPA: React and Konva (R13); src/gen/ holds the generated TypeScript
firebase.json what Firebase Hosting serves, and with which headers (spec 15.5)
docs/ the documents; live/ holds the reports of spikes and live runs
docs/ the documents; live/ holds the reports of spikes and live runs, plan/ the done epics
draft/ the screen mockup: a proposal, not a spec
.devcontainer/ justfile .github/workflows/
```
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,4 +42,4 @@ The documents are in Russian.
- [docs/decisions.md](docs/decisions.md) — the decision log: what was decided, why, and what was rejected.
- [docs/self-hosting.md](docs/self-hosting.md) — how it is deployed: the one-time bootstrap, the delivery of every release, rollback and return.
- [docs/stack.html](docs/stack.html) — the technology stack, layer by layer, with versions and what is still to be chosen. Open the file from a checkout in a browser: GitHub shows only its source.
- [RUN.md](RUN.md) — the implementation plan, in epics: the current epic broken into small tasks, run and reviewed one at a time, and the later epics.
- [RUN.md](RUN.md) — the implementation plan, in epics: the current epic broken into small tasks, run and reviewed one at a time, and the later epics. The done epics, with their tasks, are archived in [docs/plan/](docs/plan/).
2,944 changes: 609 additions & 2,335 deletions RUN.md

Large diffs are not rendered by default.

17 changes: 16 additions & 1 deletion docs/decisions.md
Original file line number Diff line number Diff line change
Expand Up @@ -898,4 +898,19 @@ Centrifugo сохраняет роль из R23. Событие `verdict` ухо
- удалить прежнюю разбивку и ссылаться на историю git;
- вынести прежнюю разбивку в отдельный файл.

— RUN.md.
— RUN.md. — *Поправка 2026-10-15:* сделанный эпик уходит из RUN.md в архив `docs/plan/`, и туда же после разбиения E2 уходит остаток прежней разбивки (R59). До разбиения она остаётся в RUN.md: это сырьё для ближайшего планирования.

**R59. Сделанный эпик уходит из RUN.md в архив `docs/plan/<эпик>.md`.**
- В архив дословно переезжает всё, что RUN.md держал об эпике: описание («Результат», «Нужно», «Почему такой порядок»), таблица задач и тела задач с «Сделано» и «Открыто». Первый архив — `docs/plan/E1.md`.
- В RUN.md остаётся только живое: правила, текущий эпик, эпики на потом, вопросы автору и технический долг, а от сделанного эпика — строка в списке «Сделанные эпики» со ссылкой на архив.
- На задачу ссылаются по номеру. Номера сквозные, поэтому прежние ссылки «RUN.md, T11» не правятся: задачу, которой нет в RUN.md, находят в архиве по заголовку — `grep -n '^#### T11\.' RUN.md docs/plan/*.md`.
- Остаток черновика E2 — задачи, которые не пережили разбиение, — уходит в `docs/plan/E2-draft.md`, когда E2 разбит на задачи.

— *Почему:* решение автора 2026-10-15. RUN.md читают в начале каждой задачи, и сделанное в нём занимает почти всё место. После E1 в файле было 2601 строка: около 260 приходилось на правила и таблицы, около 1260 — на тела задач E1, около 1070 — на черновик E2. Файл уже не помещался в одно чтение, а с каждым эпиком рос бы дальше, вместе с продуктом. Тела сделанных задач нужны редко: когда решение или отчёт ссылается на задачу. Тогда читают одну задачу, а не весь план. R44 отверг отдельный файл для черновика E2, пока тот — сырьё для разбиения; после разбиения остаток черновика — только история, и в RUN.md ему не место.

— *Отвергнуто:*
- оставить тела сделанных задач в RUN.md: план растёт с продуктом, и каждая задача начинается с чтения всего сделанного;
- один архивный файл на все эпики: он растёт так же, а файл на эпик закрыт и больше не меняется;
- переписать ссылки «RUN.md, Txx» в журнале и документах: номер задачи и так однозначен, а записи журнала правятся только поправками.

Поправляет R44. — RUN.md («Как устроен план: эпики»); `docs/plan/`.
Loading