doctrine-navigation

Doctrine Navigation Skill

Kind: always-on primer for doctrine consumers Authority: advisory; the cited files hold the authority, not this skill

Purpose

Stop the two commonest retrieval failures: citing the wrong layer (a checklist, tooling illustration, or evolution note quoted as if it were a principle) and citing without a checkable location. The layer model this skill enforces is how-to-read-this-doctrine.md; the reason the layers exist is timeless-principles-and-tooling.md.

Instructions

When you consult this doctrine library:
1. Route by task from ENGINEERING.md, then read the owning principle or pattern in full before citing it. The umbrella and any semantic index are route maps, not authority.
2. Take authority only from doctrine/principles/ (durable) or doctrine/patterns/ (conditional: active only when the pattern's applicability conditions hold). Never cite a checklist, tooling file, estate supplement, or evolution note as the authority for an obligation.
3. Cite by repo-relative path and section, for example doctrine/patterns/run-contracts.md section 3, and quote the strength keyword exactly as written.
4. Check lifecycle status before relying on a file: doctrine/DEPRECATED.md and any Status marker in the file take precedence over its body text.
5. Where two files appear to conflict, apply the conflict-resolution rules in how-to-read-this-doctrine.md and record the conflict; do not pick silently.
6. Say when the doctrine is silent. Absence of guidance is a finding, not permission to invent a rule.

Run-Contract Use

context:
  skills:
    - [email protected]
verifiers:
  - [email protected]

Suitable for estate-policy injection on every task class that touches doctrine; the block is small and carries no task-specific behaviour.