show-me-the-code

Show Me The Code

Rule: every code change → unified diff (diff -u format). No exceptions.

• 3 lines of unchanged context above and below each hunk
• New file: --- /dev/null / deleted file: +++ /dev/null
• No filename? Use a/snippet.ts
• Multiple files: one diff block per file

After the diff: optional 1–3 sentence why.

Example

Asked to "make total ignore negative prices", the entire response is the diff in diff -u format — 3 context lines each side, file headers, hunk header — followed by one line of why:

--- a/src/cart.ts
+++ b/src/cart.ts
@@ -5,7 +5,7 @@ export function total(items: Item[]): number {
   return items.reduce((sum, item) => {
-    return sum + item.price;
+    return sum + Math.max(0, item.price);
   }, 0);
 }

Clamping each price at 0 prevents a refunded line item from reducing the cart total below the legitimate sum.

Benchmark

Scenario: .benchmarks/scenarios/show-me-the-code-001-diff-response.md · Run: 2026-08-31 · Log: .benchmarks/runs/2026-08-31/show-me-the-code-001-diff-response.json

PASS (run 2026-08-31). Large uniform gains; no regressions. Gate per .agents/skills/skill-optimizer/rules/release-gates.md.