AGENTS.md@.claude/principles · git:20260909.7c6ada1 · 2026-09-09 · sha256 89a0cc5a52a12d5d

AGENTS.md@.claude/principles git:20260909.7c6ada1A

Immutable. This exact content is served forever at /api/v1/blob/89a0cc5a52a12d5d.

# `.claude/principles/` — Demotion Zone

**Purpose**: Location for prescriptive content demoted from `.claude/rules/`. §Distinction from `.claude/rules/` below states when this content loads.

This directory realizes the root `AGENTS.md` `## Progressive Disclosure` policy in three stages: at session start, nothing in this directory loads; when work touches this directory, its entry document (`AGENTS.md`, aliased as `CLAUDE.md`) is picked up by directory convention, bringing this index and the placement policy below into context; a specific principle document is then fetched via Read/Grep only when the utterance or current context names it. Other AI clients can adopt the same content via their own load conventions; the content itself is substrate-agnostic.

## Distinction from `.claude/rules/`

- **`.claude/rules/`** — Auto-loaded by the harness at session start, so it is invoked per-turn.
- **`.claude/principles/`** — Two load paths. The entry document (`AGENTS.md`, aliased `CLAUDE.md`) loads by directory convention when work touches this directory, so it is invoked once per directory visit. Each principle document lazy-loads via Read/Grep only when named, so it is invoked per-session or per-authoring.

This section is the canonical statement of the load mechanism in this repository; other files point here rather than restating it. Naming this index `AGENTS.md` with the `CLAUDE.md` alias — the only file in this directory that carries that name — is what makes the directory-convention pickup happen, which is why it stays short and current.

## Index

- **`architectural-principles.md`** — Tier Factorization, Epistemic Cost Topology, Unix Philosophy Homomorphism, Session Text Composition, Cross-Session Knowledge Composition, Task Externalization Boundary, Reference over Copy, Inter-Protocol Guidance, Coexistence over Mirroring, Termination, Plugin Encapsulation, Utility Skills delegation.
- **`hermeneutic-cycle.md`** — Pattern over Vocabulary, reinterpretation across protocol/session/version/agent boundaries, and correction-channel evidence.
- **`safeguards.md`** — Actionable revision criterion, Literature Application Discipline, Rule Classification Framework, Adversarial Anticipation, White Bear Avoidance. All are authoring/audit/verify-time; the runtime-critical Gate Integrity guards are carried by `premise/gate-design.md` instead.
- **`project-profile-calibration.md`** — Profile Variables and Calibration Rule, Scope Boundary. Authoring/calibration-time reference, not per-turn.
- **`outcome-equivalence.md`** — Outcome Equivalence (whole section). Derived tier, runtime-inert argument chain.

## Philosophy

This directory is not an archive (content remains canonical and current) and not a docs/ replacement (docs/ holds contributor-facing specification and editing conventions, not prescriptive principles; investigation and research products go to the ledger).

The demotion zone reduces auto-load memory pressure (Epistemic Cost Topology applied to the loading dimension) while keeping the demoted content canonical and editable. The split is one-directional by default: there is no formal re-promotion pathway. A demoted section returning to `.claude/rules/` is a contributor-judgment decision per case, not an inscribed criterion.

Per-section demotion history — which section moved from where, when, and why — is not restated here; it is recorded in the git record (commit messages, PR bodies), per this project's Ledger binding (`AGENTS.md` §Settled Directions).