Micro-RAGing is one of three architectural annotation patterns surfaced by the change-management skill. It applies when the author wants to direct a refinement but doesn't know the exact replacement language β the intent is clear; the text is to be determined.
The pattern is implemented as the highlight mode of the changeProposal shortcode (rendered via src/_includes/parts/change-proposal/highlight.njk). The card highlights the selected text with a yellow accent (the highlighter metaphor) and presents the tobe (proposed state) field as Direction rather than as a proposed replacement.
Use micro-RAGing for:
- "This section needs a stronger argument for X β please refine"
- "Tighten this paragraph, it reads too academic"
- "Reconsider this metaphor; it doesn't carry the weight we need"
- Any case where the author knows the intent of the refinement but not the exact language
Less common in static documents (no AI runs at render time to act on the direction); more common in interactive sessions and verification workflows.
Companion patterns: Micro-editing (when the replacement text is known), Micro-flagging (for raising concerns without proposing a resolution).