module-instructions

Module instruction files for AI agents are written using a frontmatter-driven contract that enforces specific section order, scope rules, and usage patterns to document module-local guidance consistently.

Frontmatter validation ensures .instructions.md files conform to a strict spec, verifying header formatting, section order, and scope rules so AI agents receive a consistent, enforceable usage contract.

You need to update a module instruction file after API changes to ensure the AI-facing documentation accurately reflects the new public API, maintains correct frontmatter, and passes scope validation.

To enforce section order and scope rules in AI documentation, apply the module-instruction spec during file authoring or updates, validating frontmatter and header formatting to maintain strict module-local guidance.

Yes, frontmatter provides a strict, enforceable contract in .instructions.md files that teaches AI agents module-local guidance and public API usage patterns, ensuring documentation remains consistent and enforceable.

Using a frontmatter-driven contract for module instructions limits documentation to a strict spec enforcing specific section order, header formatting, and scope rules, preventing freeform or non-standard documentation styles.