code-annotationslisted

# code-annotations **Agent writes proposals in code → User reviews in IDE → Agent executes approved.** --- ## Workflow ``` /anno-review <task> → Agent scans codebase, understands context → Inserts @anno-propose annotations at relevant locations → Each annotation has: what, why, risk level → Presents summary: "12 proposals across 5 files, 3 high-risk" User opens IDE, sees: // @anno-propose: extract token refresh logic into auth.tryRefresh() // @anno-risk: medium — affects 3 call sites // @anno-note: currently duplicated in middleware/auth.ts and handler/login.ts User reviews: - This one looks good → leave it - This one is wrong → delete these 3 lines - This one needs adjustment → edit the description /anno-apply → Agent processes only non-deleted annotations → Executes each: reads context, makes the change → Writes ANNOCHANGELOG.md: what was done, what was skipped → Removes applied annotations from source /anno-clear → Removes ALL annotations without executing → For "I changed my mind, clean it up" ``` --- ## Annotation Format Agent writes: ```go // @anno-propose: <one-line description of the change> // @anno-risk: low | medium | high // @anno-note: <optional: why, alternatives considered, related files> ``` Language-aware comment prefix: ``` .ts/.js/.go/.rs → // .py/.rb → # .sql → -- .html → <!-- ... --> ``` --- ## Commands Detailed workflows live in `commands/*.md`. Quick reference: | Comm