name	project-instructions-policy
description	Правила проекта и documentation: AGENTS, CLAUDE, REVIEW, ADR/MADR. Используй для: инструкции, docs. EN: project instructions.

Project Instructions Policy

Keep durable project instructions useful for future Codex sessions without turning them into chat history or generic advice.

Create or update AGENTS.md when durable Codex project rules, setup commands, quality gates, architecture constraints, deploy contracts, or workflow guidance change.
Keep AGENTS.md concise because Codex loads it at session start and instruction size matters.
Create or update .claude/CLAUDE.md for every project so Claude Code has first-class project memory tracked on main.
Keep .claude/CLAUDE.md optimized for Claude Code, not as a thin @AGENTS.md import.
Do not create root CLAUDE.md by default; .claude/CLAUDE.md is the rldyour project memory path.
Create or update REVIEW.md when review-specific rules are durable and materially help future review agents.
Create ADRs for important architecture, technology, dependency, deployment, security, or irreversible design decisions.
Repository docs, instructions, ADRs, memories, plans, comments, and commits are English. User-facing conversation with the owner is Russian.
Do not store secrets, personal tokens, local-only credentials, private cookies, or chat transcripts in docs.

Read references/project-instructions-and-adrs.md before creating or updating durable instruction files.

name	project-instructions-policy
description	Правила проекта и documentation: AGENTS, CLAUDE, REVIEW, ADR/MADR. Используй для: инструкции, docs. EN: project instructions.

Keep durable project instructions useful for future Codex sessions without turning them into chat history or generic advice.

Create or update AGENTS.md when durable Codex project rules, setup commands, quality gates, architecture constraints, deploy contracts, or workflow guidance change.
Keep AGENTS.md concise because Codex loads it at session start and instruction size matters.
Create or update .claude/CLAUDE.md for every project so Claude Code has first-class project memory tracked on main.
Keep .claude/CLAUDE.md optimized for Claude Code, not as a thin @AGENTS.md import.
Do not create root CLAUDE.md by default; .claude/CLAUDE.md is the rldyour project memory path.
Create or update REVIEW.md when review-specific rules are durable and materially help future review agents.
Create ADRs for important architecture, technology, dependency, deployment, security, or irreversible design decisions.
Repository docs, instructions, ADRs, memories, plans, comments, and commits are English. User-facing conversation with the owner is Russian.
Do not store secrets, personal tokens, local-only credentials, private cookies, or chat transcripts in docs.

Read references/project-instructions-and-adrs.md before creating or updating durable instruction files.

project-instructions-policy