Keeping Docs in Sync

Reviewing Drift with athena sync

athena sync shows which documents would change and why, then asks once before applying them. Use --dry-run to see the plan without writing, --diff to see full diffs, --yes to apply without asking, and --check in CI (exits with code 1 if knowledge is out of date). Sections you edited by hand are kept unless you pass --force.

$ athena sync
api.md — API surface changed (src/routes/billing.ts)
Apply updates to 1 document? [y/N]

Background Monitoring with athena watch

For real-time development feedback:

athena watch

This watches your project files and prepares proposals when changes are detected. Proposals are queued for your review and are never committed automatically.