Operational rules для Claude при работе с этим проектом.

Чтение spec

1. _index.md — canonical source of truth. Читать первым перед любой содержательной работой.
2. Detailed reasoning, audit findings, rejected alternatives — preserved в chat history исходных specs (ARNO v6, Observability v3, Tech Stack v2). Master spec — condensed reference.
3. Новые знания о ARNO (после реальной разработки/тестов) — дописывать в _index.md с version bump в changelog.

Decision authority при конфликтах

Per §0.6 master spec:

1. Master spec wins над individual specs (_index.md canonical)
2. ARNO Product Design wins над Tech Stack по product behavior
3. Tech Stack wins над ARNO Product Design по infrastructure mechanics
4. Observability wins над both по что monitored/alerted
5. Конфликты не workaround'ятся — resolved в next master spec version

Изменения spec

• Minor clarifications: directly в _index.md, version bump (1.1 → 1.2), changelog updated
• Major architecture changes: ADR created first в docs/adr/, обсуждается, потом master spec обновляется (version 1.x → 2.0)
• Парковка возврат: trigger в § V совпал → unparked, добавлено в active scope
• Audit findings: apply P0/P1 fixes как version bump

Парковка

§V парковка имеет explicit triggers. Не делать "preventive work" по парковке — только когда trigger срабатывает.

Implementation guidance

• Перед началом implementation: week 1 prototyping (§VI) — 3 critical verifications + bundle measurement
• Atomization MVP scope (§IV) — после week 1 results
• Phase order: §VII.1
• Launch readiness gates: §VII.2

Operational

• SPOF mitigation от day 1: multi-owner Cloudflare, separate DNS registrar, DNS TTL 300s, secrets backup
• Cost ladder triggers: monitor free tier usage, plan upgrade перед 80% capacity
• 90-day secret rotation: automated reminders
• Quarterly: runbook review, alert false-positive review, OTel SDK upgrade review

Things to NEVER do

• Add features beyond §IV без обновления master spec
• Skip pre-edit impact analysis для breaking changes
• Force-push session-branches automatically
• Log PII / secrets (§II.2 blocklist)
• Trust client-side validation only (server-side mutation validation mandatory)
• Add user_id to metric labels (cardinality budget violation)
• Lower DNS TTL после initial setup (kept 300s для disaster recovery readiness)
• Use root Cloudflare API token в CI (scoped tokens only)
• Use single secret Cloudflare API token without rotation
• Commit secrets в repo
• Skip GHA production-migration manual approval gate

Document organization

Когда выйдет implementation phase

После создания apps/, packages/, infra/ — следовать monorepo structure §III.3. Каждая package и app имеет свой _index.md (per project convention). Master spec остаётся canonical reference на верхнем уровне.