Use Git-Formatted Diffs for Agents

VCS-USE-GIT-FORMATTED-DIFFS-FOR-AGENTS

VCS JJ Agent Workflow Review Handoff Tooling

Summary

Prefer jj diff --git when agents or patch-oriented tools need diff text. Git patch format preserves hunks and paths in a shape those consumers can parse reliably.

Rule

Prefer Git-formatted diffs when agents need to interpret patch text.

Why

Many agents and review tools understand Git patch format better than native jj summaries. jj diff --git preserves file paths, hunks, renames, and patch shape in a format that patch-oriented tooling can parse reliably.

Helps

Makes diffs easier for agents and humans to inspect, quote, and apply.

Limits

Use native jj summaries for graph and change-shape questions. Use Git-formatted diffs when the consumer needs patch text.

Agent Instruction

Use Git-formatted diffs for agents and review tools that understand patch format better than native
jj summaries.

Mechanisms

Supported by jj diff --git, jj show --git, path-scoped diffs, and handoffs that include important files rather than raw huge patches.