<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/adr/2.x/2026-01-29-16-rich-json-outputs-for-agent-commands/">
  <id>https://docs.spec-kitty.ai/adr/2.x/2026-01-29-16-rich-json-outputs-for-agent-commands/</id>
  <title>Rich JSON Outputs for Agent Commands</title>
  <updated>2026-01-29T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/adr/2.x/2026-01-29-16-rich-json-outputs-for-agent-commands/"/>
  <summary>Expands agent-facing JSON with commit hashes and touched-file lists so an agent can confirm what actually happened instead of inferring it from a dirty tree.</summary>
  <content type="html">&lt;h2 id=&quot;context-and-problem-statement&quot;&gt;Context and Problem Statement&lt;/h2&gt;
&lt;p&gt;Agents rely on JSON output from spec-kitty commands to determine next actions. However, the outputs were too vague, causing confusion when unrelated files were dirty.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Real example from ~/tmp:&lt;/strong&gt;&lt;/p&gt;
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;plaintext&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Agent: Run finalize-tasks&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Output: {&quot;result&quot;: &quot;success&quot;, &quot;updated_wp_count&quot;: 0}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Agent: Did the commit happen? Let me check...&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Git status: Shows 41 deleted template files (UNRELATED)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Agent: Must have failed! Let me commit again...&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Git: &quot;nothing to commit&quot; for kitty-specs/&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#d6deeb;--1:#403f53&quot;&gt;Agent: 🤔 Confused - did my commit work or not?&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;Root cause:&lt;/strong&gt; Vague JSON output didn’t confirm:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Did the commit actually happen?&lt;/li&gt;
&lt;li&gt;What was the commit hash (for verification)?&lt;/li&gt;
&lt;li&gt;Which files were committed?&lt;/li&gt;
&lt;li&gt;Why are there dirty files (related or unrelated)?&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Question:&lt;/strong&gt; Should agent commands provide &lt;strong&gt;explicit verification data&lt;/strong&gt; in JSON output instead of vague status messages?&lt;/p&gt;
&lt;h2 id=&quot;decision-drivers&quot;&gt;Decision Drivers&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Agent decision-making&lt;/strong&gt; - LLMs need explicit confirmation, not implicit success&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Debugging&lt;/strong&gt; - Agents should be able to verify operations succeeded&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Unrelated dirty files&lt;/strong&gt; - Common in repos (templates, config, experimental code)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Idempotency&lt;/strong&gt; - Agents should know when operation already completed&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Verification&lt;/strong&gt; - Agents should check results without re-running operations&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;considered-options&quot;&gt;Considered Options&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Option 1:&lt;/strong&gt; Rich JSON with commit_hash, commit_created, files_committed&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option 2:&lt;/strong&gt; Verbose mode flag (—verbose adds details)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option 3:&lt;/strong&gt; Separate verify command (spec-kitty verify finalize-tasks)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option 4:&lt;/strong&gt; Status quo (vague “success” message)&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;decision-outcome&quot;&gt;Decision Outcome&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Chosen option:&lt;/strong&gt; “Option 1: Rich JSON outputs”, because:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Explicit confirmation (commit_created: true/false)&lt;/li&gt;
&lt;li&gt;Verifiable (commit_hash for git verification)&lt;/li&gt;
&lt;li&gt;Clear (files_committed lists what changed)&lt;/li&gt;
&lt;li&gt;No extra commands needed (all in one response)&lt;/li&gt;
&lt;li&gt;Prevents redundant operations (agent checks commit_created)&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;consequences&quot;&gt;Consequences&lt;/h3&gt;
&lt;h4 id=&quot;positive&quot;&gt;Positive&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Explicit confirmation&lt;/strong&gt; - commit_created: true means commit happened&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Verifiable results&lt;/strong&gt; - commit_hash for git rev-parse verification&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Clear scope&lt;/strong&gt; - files_committed shows exactly what changed&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Prevents confusion&lt;/strong&gt; - Unrelated dirty files don’t mislead agent&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Idempotency check&lt;/strong&gt; - commit_created: false means already done&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Debugging-friendly&lt;/strong&gt; - JSON contains all info needed to verify operation&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;negative&quot;&gt;Negative&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Larger JSON payloads&lt;/strong&gt; - More fields (commit_hash is 40 chars, files_committed is array)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Breaking change&lt;/strong&gt; - Agents relying on old schema need updates&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Not all commands updated&lt;/strong&gt; - Only finalize-tasks enhanced so far (more work needed)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Complexity&lt;/strong&gt; - More logic to populate additional fields&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;neutral&quot;&gt;Neutral&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Backward compatibility&lt;/strong&gt; - Old fields still present (result, updated_wp_count)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;JSON only&lt;/strong&gt; - Human output unchanged (separate logic)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Optional fields&lt;/strong&gt; - commit_hash can be null if no commit created&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Extensible pattern&lt;/strong&gt; - Can apply to other commands (move-task, mark-status)&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;confirmation&quot;&gt;Confirmation&lt;/h3&gt;
&lt;p&gt;We validated this decision by:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;✅ 6 tests for finalize-tasks JSON output&lt;/li&gt;
&lt;li&gt;✅ Test simulating ~/tmp scenario (unrelated dirty files)&lt;/li&gt;
&lt;li&gt;✅ commit_created prevents redundant commits&lt;/li&gt;
&lt;li&gt;✅ commit_hash enables verification&lt;/li&gt;
&lt;li&gt;✅ files_committed provides clarity on scope&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;pros-and-cons-of-the-options&quot;&gt;Pros and Cons of the Options&lt;/h2&gt;
&lt;h3 id=&quot;option-1-rich-json-outputs-chosen&quot;&gt;Option 1: Rich JSON outputs (CHOSEN)&lt;/h3&gt;
&lt;p&gt;Add commit_hash, commit_created, files_committed to JSON response.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Explicit: Agent knows if commit happened&lt;/li&gt;
&lt;li&gt;Verifiable: Can check git rev-parse HEAD = commit_hash&lt;/li&gt;
&lt;li&gt;Clear scope: files_committed lists what changed&lt;/li&gt;
&lt;li&gt;One response: All info in JSON (no follow-up needed)&lt;/li&gt;
&lt;li&gt;Prevents confusion: Distinguishes related from unrelated changes&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Larger JSON: More data to transmit&lt;/li&gt;
&lt;li&gt;Breaking change: Requires agent updates&lt;/li&gt;
&lt;li&gt;Code complexity: More fields to populate&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;option-2-verbose-mode-flag&quot;&gt;Option 2: Verbose mode flag&lt;/h3&gt;
&lt;p&gt;Add —verbose flag to include details.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Opt-in: Agents choose verbosity level&lt;/li&gt;
&lt;li&gt;No breaking change: Default behavior unchanged&lt;/li&gt;
&lt;li&gt;Smaller default response&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Agents must know to use —verbose&lt;/li&gt;
&lt;li&gt;Two modes to maintain&lt;/li&gt;
&lt;li&gt;Still doesn’t prevent confusion (agent might not use it)&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;option-3-separate-verify-command&quot;&gt;Option 3: Separate verify command&lt;/h3&gt;
&lt;p&gt;Add spec-kitty verify finalize-tasks to check results.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Separation of concerns&lt;/li&gt;
&lt;li&gt;No changes to existing command&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Two commands instead of one&lt;/li&gt;
&lt;li&gt;Agent must know to run verify&lt;/li&gt;
&lt;li&gt;Duplicates logic (finalize-tasks knows what it did)&lt;/li&gt;
&lt;li&gt;Slower (extra command execution)&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;option-4-status-quo&quot;&gt;Option 4: Status quo&lt;/h3&gt;
&lt;p&gt;Keep vague “success” message.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;No changes needed&lt;/li&gt;
&lt;li&gt;Minimal JSON payload&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Cons:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Agents get confused by unrelated dirty files&lt;/li&gt;
&lt;li&gt;No verification mechanism&lt;/li&gt;
&lt;li&gt;Cannot distinguish “already done” from “just done”&lt;/li&gt;
&lt;li&gt;Poor debugging experience&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;more-information&quot;&gt;More Information&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Implementation:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/cli/commands/agent/feature.py::finalize_tasks()&lt;/code&gt; (enhanced)&lt;/li&gt;
&lt;li&gt;JSON schema:
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;json&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;{&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;result&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;success&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;commit_created&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#FF6A83;--1:#A24848&quot;&gt;true&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,           &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5D6376&quot;&gt;// NEW: Explicit boolean&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;commit_hash&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;5030c9c98d...&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,  &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5D6376&quot;&gt;// NEW: Verification SHA&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;files_committed&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: [              &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5D6376&quot;&gt;// NEW: Scope clarity&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;kitty-specs/.../tasks.md&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#C789D6;--1:#7C5686&quot;&gt;kitty-specs/.../WP01.md&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;,&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;    &lt;/span&gt;&lt;span style=&quot;--0:#FFFFFF;--1:#984E4D&quot;&gt;...&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;  &lt;/span&gt;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;],&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span class=&quot;indent&quot;&gt;  &lt;/span&gt;&lt;span style=&quot;--0:#7FDBCA;--1:#096E72&quot;&gt;&quot;updated_wp_count&quot;&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;: &lt;/span&gt;&lt;span style=&quot;--0:#F78C6C;--1:#AA0982&quot;&gt;2&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;             &lt;/span&gt;&lt;span style=&quot;--0:#919F9F;--1:#5D6376&quot;&gt;// Original field&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt;}&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Tests:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;tests/integration/test_finalize_tasks_json_output.py&lt;/code&gt; (6 tests)&lt;/li&gt;
&lt;li&gt;test_json_output_prevents_agent_confusion - Simulates ~/tmp scenario&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Template Updates:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;src/specify_cli/missions/software-dev/command-templates/tasks.md&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Added: “DO NOT commit after finalize-tasks (commits automatically)”&lt;/li&gt;
&lt;li&gt;Added: “Check commit_created and commit_hash from JSON”&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Future Enhancements:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Apply to move-task, mark-status (status commit confirmations)&lt;/li&gt;
&lt;li&gt;Apply to implement (worktree creation confirmation)&lt;/li&gt;
&lt;li&gt;Apply to merge (merge commit hash and files)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Related ADRs:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;ADR-15: Merge-First Suggestion (reduces need for auto-merge, but this improves fallback UX)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;Version:&lt;/strong&gt; 0.13.8 improvement (agent UX enhancement)&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Pattern:&lt;/strong&gt; “Explicit Confirmation over Implicit Success” - Agents need verification data, not vague status&lt;/p&gt;</content>
</entry>
