docs: sync glossary + Russian README to image system (PRD-030 follow-up) (#124)

## Summary

Tactical follow-up to #121 (PR #122). Three doc files still described
the
legacy `dist/` + `dist-experimental/` shape — bring them in line with
what `develop` actually ships post-PR-#122.

- `README.ru.md` — new "Образы (images): `stable` (по умолчанию) и
`nightly`" section mirroring `README.md`; updated "Что получаешь" line
to mention the per-image bundle.
- `docs/agents/domain.md` — replace **legacy `dist/`** + **opt-in
`dist-experimental/`** entries with **Image** + **Feature flag**
definitions, and document `--experimental` as a deprecated alias.
- `docs/agents/paths.md` — top-level table swaps `dist-experimental/`
for `dist-nightly/` + `config/`; tarball inventory now references
`config/images.json` for the canonical image list.

## Why

`docs/agents/*.md` are auto-loaded by the `fpl-skills` skill set. Stale
terms there mean every future agent invocation starts with an inaccurate
mental model of the package shape — exactly the kind of drift rule 11
(Forgeplan as single source of truth) is meant to prevent. PRD-030
already activated; this PR closes the doc gap without re-opening the
artifact discipline.

## Scope

No code changes — `bin/`, `scripts/`, `template/` untouched. Smoke
status from PR #122 still applies. Tactical depth per rule 11 (docs
without behaviour change), so no new Forgeplan artifact required.

## Test plan

- [x] `grep -rn 'dist-experimental\|--experimental' docs/` shows only
the `--experimental` *deprecated alias* mention in `domain.md`.
- [x] `git diff --stat` is bounded to the three doc files.
- [x] No code paths touched → smoke unaffected.
- [ ] CI: docs-only PRs still trigger the smoke matrix; expected green
since no source changed.

Refs: PRD-030, RFC-026, ADR-005, #121

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Author: fedorovvvv

README.ru.md

@@ -98,6 +98,34 @@ forgeplan-web start
 наличие `.forgeplan/` в текущей директории. Полная справка —
 [`docs/USAGE.md`](docs/USAGE.md).
 
+### Образы (images): `stable` (по умолчанию) и `nightly`
+
+```bash
+npx @forgeplan/web init -y                   # stable (по умолчанию)
+npx @forgeplan/web init -y --image nightly   # pre-release ветка
+```
+
+Каждый релиз шипит два именованных **образа** (image) скаффолда. Байты
+у обоих одинаковые — self-contained ~1.8 MB single-file bundle (без
+`node_modules/`, никакого `npm install` на стороне пользователя);
+разница в наборе фичефлагов, которые несёт каждый образ. v1 шипит оба
+образа с **нулём** флагов — фреймворк готов к опт-ин фичам без того
+чтобы пользователи `stable` за них платили.
+
+- **`stable`** — дефолт для `init` / `update`. Шипит только флаги, чей
+  rollout достиг stable.
+- **`nightly`** — early-access ветка. Шипит все флаги, включая
+  alpha/beta. Используй когда хочешь pre-release поведение и не против
+  изменений между minor-версиями.
+
+Сменить ветку: `npx @forgeplan/web update --image <name>`. Выбор
+запоминается в `forgeplan-web.json` для будущих обновлений.
+
+`--experimental` — устаревший alias для `--image nightly` (живёт ещё
+один minor-релиз; удаляется в 0.3.0).
+
+Maintainer-вью на образы и флаги: [`config/IMAGES.md`](config/IMAGES.md).
+
 ## Демо за 60 секунд
 
 ```console
@@ -130,7 +158,7 @@ kind, status, диапазону `R_eff`; кликни узел — увидиш
 
 |                                     |                                                                                                                  |
 | :---------------------------------- | :--------------------------------------------------------------------------------------------------------------- |
-| **📦 Без установок у пользователя** | Пакет содержит `dist/` с уже собранным `node_modules/`. `init` — это `cp -r`. У пользователя ничего не ставится. |
+| **📦 Без установок у пользователя** | Пакет содержит один self-contained ~1.8 MB single-file bundle на каждый объявленный образ (`dist/` для `stable`, `dist-nightly/` для `nightly`). `init` — это `cp -r`. У пользователя ничего не ставится. |
 | **🪟 По-настоящему cross-platform** | Smoke-матрица `ubuntu-latest` / `macos-latest` / `windows-latest` × Node 22, зелёная на каждом push с v0.1.3.    |
 | **🔒 Read-only by design**          | `/api/*` дёргает только read-only подкоманды `forgeplan` (правило 22). Вьювер **не может** изменить воркспейс.   |
 | **🌐 Пять видов графа**             | Force, Lanes, Matrix, Radial, Tree. Каждый отвечает на свой вопрос — поток, смежность, иерархия, parent/child.   |

docs/agents/domain.md

@@ -9,20 +9,34 @@ repo. Slang and synonyms get rejected at audit.
   scaffolds a pre-built SvelteKit viewer into the user's project.
 - **`forgeplan-web`** — the unscoped name of the bin script (also
   reachable as `npx @forgeplan/web …`).
-- **`init`** — copies `dist/` → `<cwd>/.forgeplan-web/`, writes
-  `forgeplan-web.json`, appends `.forgeplan-web/` to host's
-  `.gitignore`. Idempotent.
+- **`init`** — copies the chosen image (`dist/` for `stable` by default,
+  `dist-<name>/` for `--image <name>`) → `<cwd>/.forgeplan-web/`,
+  writes `forgeplan-web.json` (recording `image`, `scope`, `version`,
+  `workspaceRoot`), appends `.forgeplan-web/` to host's `.gitignore`
+  (project scope only). Idempotent.
 - **`update`** — refreshes `<cwd>/.forgeplan-web/` to the version
-  bundled with the currently-resolved `@forgeplan/web`. Preserves
-  `workspaceRoot` + `createdAt`.
+  bundled with the currently-resolved `@forgeplan/web`. The image is
+  **sticky**: read from `forgeplan-web.json#image` unless overridden
+  with `--image <name>`. Preserves `workspaceRoot` + `createdAt`.
 - **`start`** — `spawn('node', '.forgeplan-web/index.js')` with
-  `PORT` / `HOST` / `FORGEPLAN_CWD` / `FORGEPLAN_BIN` env.
-- **`dist/`** — the **legacy** pre-built artifact (SvelteKit server +
-  client + bundled `node_modules/`). Default for `init`. ~14 MB
-  unpacked.
-- **`dist-experimental/`** — the **opt-in** single-file esbuild
-  bundle (no `node_modules/`). ~1.5 MB. Selected via `init
---experimental`. PRD-014 / RFC-013.
+  `PORT` / `HOST` / `FORGEPLAN_CWD` / `FORGEPLAN_BIN` env. Image-agnostic
+  (does not branch on the image name).
+- **Image** — a named build artifact of the scaffold. v1 ships
+  `stable` (default) and `nightly`. Each image is one `dist*/` directory
+  in the published tarball: `stable` → `dist/`, every other →
+  `dist-<name>/` (e.g. `dist-nightly/`). All images share the same
+  bundle shape (single esbuild ESM file, ~1.8 MB, no `node_modules/`,
+  capped at 3 MB); they differ in the feature-flag set declared in
+  `forgeplan-web-build.json`. Source of truth: `config/images.json`.
+  PRD-030 / RFC-026 / ADR-005.
+- **Feature flag** — entry in `config/features.json` with
+  `{ id, description, addedIn, expiresIn, owner, rollout }`. The build
+  pipeline fails fast when any flag has `expiresIn ≤ currentVersion`
+  or when its lifetime exceeds 3 minor versions. Flags MUST graduate
+  (promoted into mainline behaviour or dropped) before expiry. v1
+  ships an empty registry — framework only. See `config/IMAGES.md`.
+- **`--experimental`** — *deprecated*. Alias for `--image nightly`
+  with a stderr warning. Removed in 0.3.0.
 
 ## Forgeplan terms (do not paraphrase)
 

docs/agents/paths.md

@@ -8,18 +8,22 @@ Where things live. Authoritative tree — [`../../CLAUDE.md`](../../CLAUDE.md)
 | Path                  | Purpose                                                          | Published? |
 | --------------------- | ---------------------------------------------------------------- | ---------- |
 | `bin/`                | Zero-dep Node CLI (`forgeplan-web.mjs` — init / update / start) | ✅ yes     |
-| `dist/`               | Pre-built SvelteKit app (legacy, default)                        | ✅ yes     |
-| `dist-experimental/`  | Single-file esbuild bundle (opt-in via `init --experimental`)    | ✅ yes     |
-| `template/`           | SvelteKit source — the thing `dist/` is built from               | ❌ no      |
+| `dist/`               | Pre-built scaffold for the `stable` image (default for `init`)   | ✅ yes     |
+| `dist-nightly/`       | Pre-built scaffold for the `nightly` image (`init --image nightly`) | ✅ yes  |
+| `config/`             | Image + feature-flag registries (`images.json`, `features.json`, `IMAGES.md`) | ❌ no |
+| `template/`           | SvelteKit source — the thing every `dist*/` is built from        | ❌ no      |
 | `scripts/`            | `build.mjs`, `smoke.mjs`, `test/forgeplan-shim.mjs`              | ❌ no      |
 | `playground/`         | Seeded ~123-artifact Forgeplan workspace for HMR-driven testing  | ❌ no      |
 | `.forgeplan/`         | This repo's **own** Forgeplan workspace (PRD/RFC/ADR/Evidence)   | ❌ no      |
 | `.claude/`            | Hooks, rules, project skills, settings                           | ❌ no      |
 | `docs/`               | `USAGE.md`, `CONTRIBUTING.md`, `agents/` (this file)             | ❌ no      |
 | `guides/`             | Methodology guides (CLAUDE-MD, Git Flow)                         | ❌ no      |
 
-The npm tarball ships `bin/`, `dist/`, `dist-experimental/`, and
-`README.md`. Everything else is repo-internal.
+The npm tarball ships `bin/`, `dist/`, every `dist-<image>/` declared
+in `config/images.json`, and `README.md`. Everything else is
+repo-internal. Adding a new image means: add it to `config/images.json`
+and add the directory to `package.json#files` (PRD-030 / RFC-026 /
+ADR-005).
 
 ## Inside `template/` — Feature-Sliced Design