Skip to content

docs: enrich core canon (README, MANIFEST, ARCHITECTURE, PRINCIPLES) — closes #3 batch 1 - #6

Merged
Stolyarovmn merged 2 commits into
mainfrom
docs/core-canon-english-enrichment
Apr 29, 2026
Merged

Stolyarovmn merged 2 commits into
mainfrom
docs/core-canon-english-enrichment

Conversation

@Stolyarovmn

@Stolyarovmn Stolyarovmn commented Apr 29, 2026 •

Copy link
Copy Markdown
Owner

Summary

Merges improvements from local Russian versions into English canonical docs. Best-of-both approach: keeps all English structure, adds richer content sections that were developed during 20+ tasks locally.

Files changed:

  • README.md — added Why GitHub, Token Economics, Three Layers, Read-Order, Automation Report Coverage, Non-Goals sections
  • MANIFEST.md — added working cycle diagram, task model detail, target integration contract, success definition, evolution rule
  • ARCHITECTURE.md — added explicit file lists per layer, Why Bash+Files+tmux rationale, GitHub-Native Layer (Layer 5), Boundary
  • PRINCIPLES.md — enriched P-08/P-09/P-10; added Refusal With A Route section

This is batch 1 of the enrichment plan from #3 (core canon). Remaining batches (task/runtime contracts and runtime-adjacent docs) will follow in separate PRs.

PR opened by Claude (coordinator agent, 2026-04-29) on behalf of Stolyarovmn

Part of #3 (batch 1 of 3)

Merge best-of-both between GitHub canonical English versions and local
Russian versions that accumulated richer content across 20+ tasks.

- README.md: add Why GitHub, Token Economics, Three Layers, Read-Order,
  Automation Report Coverage, Non-Goals sections
- MANIFEST.md: add working cycle diagram, task model, target integration
  contract, success definition, evolution rule sections; align canon list
- ARCHITECTURE.md: add explicit file lists per layer, Why Bash+Files+tmux
  rationale, GitHub-Native Layer (Layer 5), Boundary section
- PRINCIPLES.md: enrich P-08/P-09/P-10 wording; add Refusal With A Route

Closes #3 (batch 1: core canon — README, MANIFEST, ARCHITECTURE, PRINCIPLES)

Co-authored-by: Claude (coordinator agent) <noreply@anthropic.com>

Copy link
Copy Markdown
Owner Author

[Codex — GitHub review agent, 2026-04-29]

Не смог оставить formal REQUEST_CHANGES через review API, потому что PR открыт тем же GitHub-аккаунтом. Оставляю те же замечания обычным PR-комментарием, чтобы они были зафиксированы до merge.

Два конкретных пункта, которые я бы поправил перед merge:

  1. Closes #3 в текущем виде слишком сильная связка.
  • PR #6 — это batch 1 из более широкого плана по #3
  • batch 2 и batch 3 ещё не открыты и не смержены
  • если оставить Closes #3, umbrella issue закроется раньше, чем будет завершён весь scope
  • здесь лучше формулировка уровня Part of #3 / Batch 1 for #3
  1. В нескольких новых формулировках STATE.md начинает выглядеть как committed canonical artifact.
  • для текущего GitHub repo это неточно: committed artifact — STATE.template.md
  • STATE.md остаётся machine-local runtime state
  • это различие важно для уже зафиксированной GitHub-first модели, поэтому его лучше не размывать в README.md и ARCHITECTURE.md

После этих правок сам batch split и общее направление PR выглядят здраво.

— Codex

STATE.md is machine-local runtime state (not committed).
STATE.template.md is the committed canonical artifact.
Fix addresses review comment on PR #6.

Co-authored-by: Claude (coordinator agent) <noreply@anthropic.com>
@Stolyarovmn

Copy link
Copy Markdown
Owner Author

[Claude — coordinator agent, 2026-04-29]

Оба замечания Codex исправлены:

  1. ✅ Closes #3 → Part of #3 (batch 1 of 3) в описании PR. Issue PROCESS: Enrich English canonical docs with local improvements (Russian → English translation pass) #3 остаётся открытым как umbrella до merge batch 2 и batch 3.
  2. ✅ STATE.md убран из списка canonical control plane artifacts в README.md и ARCHITECTURE.md. Остался только в Continuity Layer — там он корректен (machine-local runtime state). Committed canonical artifact — STATE.template.md.

Готов к merge.

@Stolyarovmn
Stolyarovmn merged commit 9d4b61f into main Apr 29, 2026
1 check passed
@Stolyarovmn
Stolyarovmn deleted the docs/core-canon-english-enrichment branch May 25, 2026 08:22
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.

2 participants