Managed Sections & Preserved Edits

How Athena re-analyzes code without wiping out your custom notes.

Section Delimiters

Athena uses HTML comments to demarcate automatically generated sections:

markdown

<!-- athena:generated:start id=technologies hash=86a969f510f6 -->
## Technologies
…generated content…
<!-- athena:generated:end id=technologies -->
## Developer Notes
Anything outside the markers is yours and is never touched.

If you edit text inside a marker, Athena keeps your edit and stops refreshing that section. athena analyze warns you about it, and athena analyze --force regenerates it.

← PreviousDeveloper Rules (rules.md)Next →Keeping Docs in Sync