Concepts/Developer Rules (rules.md)
DocsConcepts

Developer Rules (rules.md)

How rules.md establishes guardrails for AI coding assistants.

Why rules.md Matters

AI coding agents frequently hallucinate library methods, disregard architectural boundaries, or invent bad practices.

.athena/rules.md is a developer-owned document where you declare conventions that AI models must follow.

Preservation Guarantee

When you run athena analyze or athena sync, Athena will never alter or overwrite rules.md.

You can inspect or update rules directly in your text editor or via:

bash
athena rules