agent-instructions

Auditing agent instruction files involves scanning AGENTS.md and per-path guides to identify stale, missing, or overly generic content, then updating them to ensure non-obvious operational knowledge is captured and discoverable.

The Discoverability Filter determines what non-discoverable but high-impact operational knowledge should be documented in instruction files, ensuring guidance remains high-value, actionable, and aligned with project conventions.

Validating SKILL.md frontmatter involves enforcing YAML presence and maintaining a consistent frontmatter schema, ensuring instruction files align with governance patterns and repository state to reduce duplication.

Per-path instruction guides are needed when AGENTS.md or instructional templates are missing, oversized, or overly generic, and when learned lessons from past corrections should be codified into actionable documentation.

Splitting oversized agent documentation guides is best handled by validating instruction files against repository state to reduce duplication and maintenance burden while aligning with tooling and governance patterns.

Codifying learned lessons involves applying the Discoverability Filter to capture non-obvious operational knowledge from past corrections, then creating or updating instruction files to ensure this knowledge remains discoverable and auditable.