Skip to content

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

Merged
fedorovvvv merged 1 commit into
developfrom
docs/issue-121-followup-image-glossary
May 9, 2026
Merged

fedorovvvv merged 1 commit into
developfrom
docs/issue-121-followup-image-glossary

Conversation

@fedorovvvv

Copy link
Copy Markdown
Collaborator

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

  • grep -rn 'dist-experimental\|--experimental' docs/ shows only the --experimental deprecated alias mention in domain.md.
  • git diff --stat is bounded to the three doc files.
  • 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

Tactical follow-up to #121 (PR #122) — agent context files and the
Russian README still described the legacy `dist/` + `dist-experimental/`
shape. Bring them in line with what `develop` actually ships:

- README.ru.md: new "Образы (images)" section mirroring README.md;
  package summary in "Что получаешь" notes the per-image bundle.
- docs/agents/domain.md: replace "legacy dist/" + "opt-in
  dist-experimental/" entries with image / feature-flag definitions;
  document `--experimental` as deprecated alias.
- docs/agents/paths.md: top-level table swaps `dist-experimental/` for
  `dist-nightly/` + `config/`; tarball inventory now reads from
  `config/images.json`.

No code changes — `bin/`, `scripts/`, `template/` untouched, smoke
unchanged. Tactical depth per rule 11 (doc copy-edit, no public
behaviour change), so no new Forgeplan artifact required; references
the existing PRD-030 / RFC-026 / ADR-005 chain.

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

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@fedorovvvv
fedorovvvv enabled auto-merge May 9, 2026 11:20
@fedorovvvv
fedorovvvv merged commit f37817a into develop May 9, 2026
3 checks passed
@fedorovvvv
fedorovvvv deleted the docs/issue-121-followup-image-glossary branch May 9, 2026 11:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant