Default turn-doc diffs to @pierre/diffs

Completed on May 23, 2026 at 6:47 PM ET.

Summary

Updated repository turn-documentation rules to prefer @pierre/diffs for diff snippets, added a documented fallback path, and included the package/lock updates needed for consistent local usage.

Changes Made

Context

The existing guidance required a diff section but did not explicitly standardize on a single rendering tool. This change aligns turn-doc expectations around one default tool while preserving an escape hatch when tooling is unavailable.

Important Implementation Details

Relevant Diff Snippets

@pierre/diffs is now the repository default for this section.

--- AGENTS.md
+++ AGENTS.md
@@
+For diff content in turn documentation (including "Code diffs" and "Relevant Diff Snippets"), use `@pierre/diffs` output by default.
@@
-- **Code diffs**
+- **Code diffs** (use `@pierre/diffs` output by default; if unavailable, include a clearly labeled plain diff/code block and note why)
@@
-5. **Relevant Diff Snippets**
+5. **Relevant Diff Snippets** (render with `@pierre/diffs` output by default; if unavailable, include a clearly labeled plain diff/code block and note why)

--- package.json
+++ package.json
@@
+  "dependencies": {
+    "@pierre/diffs": "^1.2.2"
+  }

Expected Impact for End-Users

Validation

Issues, Limitations, and Mitigations

Follow-up Work