AGENT SKILL

write-divergence

Record a moment where the work changed direction because of something the user said. Use when the user redirects a move, thinks aloud and lands somewhere else, hesitates, or tells you something you could have asked about first.

License 许可
MIT
最近更新
2026-08-29
Stars
★ 1
Forks
0

01 前言 Front Matter

name
write-divergence
description
Record a moment where the work changed direction because of something the user said. Use when the user redirects a move, thinks aloud and lands somewhere else, hesitates, or tells you something you could have asked about first.

02 资源文件 1

03 SKILL.md 正文

The work changed direction. Write down what happened, and carry on.

Write one when

  • The user redirects a move you made.
  • The user thinks aloud, and the work ends up somewhere other than where it was going.
  • The user tells you something you could have asked about first.

Any one of these is enough. When you are unsure, write it. A weak record costs three lines, and the alignment pass removes it in a second. A moment you skip is gone.

The blunt cases are easy and rare. The ones worth catching are soft: a pause, a "hmm", a sentence that starts as agreement and ends somewhere else. Watch the direction, not the tone.

Usually skip

  • A new requirement that leaves your direction intact.
  • A fact about the code. The code already holds it.
  • A mistake you found and fixed yourself.

How

  1. Answer the user first. Finish the turn's real work.
  2. Write one file to .agents/divergences/, using RECORD-FORMAT.md.
  3. Carry on exactly as you would have. The conversation keeps its flow.

The record is silent work. It gets no announcement, no summary line, no question, and no place in your reply — the user watches the folder and reads it when they choose. It also changes nothing about the task in front of you: write it, and go back to what you were doing.

Writing takes one tool call and about forty words. Anything more than that has turned a note into an interruption.

Record what happened. Extract no rule. One moment is thin evidence, and a rule written from it becomes an absolute the next session has to live with. The align skill reads many records together, and that is where meaning is safe to find.

04 同仓库更多 Skills