Code Header Annotator

Maintain a fixed 20-line header region per code file (marked by @codex-header: v1) that captures the file's purpose and a compact index of key symbols (with line addresses).

Workflow (per file)

1. Preserve prolog lines - Keep required first lines (shebang, encoding cookie, build tags, etc.)
2. Ensure 20-line header - Insert new or update existing, always keep @codex-header: v1 marker
3. Scan file sections - Imports → config → types → functions → entrypoints → side effects
4. Populate header - Use precise names + line addresses, write TODO when unsure
5. Verify addresses - Ensure every Name@L123 points to correct definition

Navigation

When exploring large repos, read headers first, only open full files when relevant: