Preserve a Project Learning

Capture the reusable rule, not the incident that revealed it.

1. Find the authority

Read the repository's instruction hierarchy and the relevant nearby section. Follow pointers and generated-file notices to their owning source; the target may be AGENTS.md, CLAUDE.md, or another local instruction file. Treat a file as authoritative only when the instruction hierarchy gives it that role; a file that the hierarchy presents as reference material takes no rule.

Identify every existing rule that overlaps the learning. Amend an existing rule when it already owns the meaning. State whether you amend that rule or add a new one beside it.

Complete when the authoritative file, the target section, and any overlapping rule are identified by name.