Skip to content

docs: correct -c framing for atomic diff, document --json - #3

Open
graywolf336 wants to merge 1 commit into
mainfrom
fix/diff-c-framing-and-json
Open

graywolf336 wants to merge 1 commit into
mainfrom
fix/diff-c-framing-and-json

Conversation

@graywolf336

@graywolf336 graywolf336 commented Sep 25, 2026 •

Copy link
Copy Markdown

Follow-up to atomic#218.

Changes

  • atomic-vcs/SKILL.md — atomic diff -c was described as "compare against a specific change", which reads as a comparison target. It's a selector: the command answers two different questions depending on whether it's present (working copy vs. recorded, or before vs. after a change). This phrasing is what misled on stage.
  • Document --json — added in #218, takes precedence over --stat/--name-only/--name-status; a -c diff carries the change header under change, a working-copy diff carries view.
  • Note that a clean working copy now surfaces copy-pasteable -c commands instead of dead-ending.
  • Append a trailing newline to code-intelligence/SKILL.md so the mirror stays byte-identical to the materialized working copy.

`atomic diff -c` was described as "compare against a specific change",
which reads as a comparison target. It is a selector: the command
answers two different questions depending on whether it is present —
working copy vs. recorded state, or the state before vs. after a
change. Agents were following the misleading phrasing.

Also document --json (added in atomic#218), which takes precedence
over the text format selectors, and note that a clean working copy
now surfaces copy-pasteable -c commands rather than dead-ending.

Append a trailing newline to code-intelligence/SKILL.md so the mirror
stays byte-identical to the materialized working copy; the missing
newline was the only diff between the two.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant