<?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-02-09-4-cross-repo-evidence-completion/">
  <id>https://docs.spec-kitty.ai/adr/2.x/2026-02-09-4-cross-repo-evidence-completion/</id>
  <title>Cross-Repo Evidence-Based Completion</title>
  <updated>2026-02-09T00: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-02-09-4-cross-repo-evidence-completion/"/>
  <summary>Required structured commit evidence before completion, closing the split-brain gap where the planning repository and the implementation repository disagreed.</summary>
  <content type="html">&lt;blockquote&gt;
&lt;p&gt;Superseded by &lt;code dir=&quot;auto&quot;&gt;2026-04-03-2-review-approval-and-integration-completion-are-distinct.md&lt;/code&gt;.
This ADR attached review approval evidence directly to &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt;. The current
lifecycle splits review evidence (&lt;code dir=&quot;auto&quot;&gt;for_review -&gt; approved&lt;/code&gt;) from integration
and acceptance evidence (&lt;code dir=&quot;auto&quot;&gt;approved -&gt; done&lt;/code&gt;).&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h2 id=&quot;context-and-problem-statement&quot;&gt;Context and Problem Statement&lt;/h2&gt;
&lt;p&gt;Spec Kitty’s planning repository and implementation target repositories are separate git repositories. A WP can be marked “done” in the planning repo while the target repo has no corresponding commits — or implementation may be complete in the target repo while the planning repo still shows &lt;code dir=&quot;auto&quot;&gt;in_progress&lt;/code&gt;. This “split-brain” failure mode exists because there is no automatic linkage between planning status and target-repo commits.&lt;/p&gt;
&lt;p&gt;The current system allows marking a WP as “done” with no structured proof of what was actually implemented, tested, or reviewed. This makes &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt; a trust-based assertion rather than a verifiable fact.&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;Verifiable “done”&lt;/strong&gt; — Completion must include structured proof, not just assertion&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Cross-repo drift detection&lt;/strong&gt; — Planning and implementation repos must be reconcilable&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Dual execution mode support&lt;/strong&gt; — Both worktree-based and direct-repo workflows need evidence paths&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Offline-first reconciliation&lt;/strong&gt; — Must work via git-native &lt;code dir=&quot;auto&quot;&gt;status reconcile&lt;/code&gt;, not a centralized service&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Reviewer authority&lt;/strong&gt; — Evidence must satisfy guard conditions from ADR 2026-02-09-2&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; Trust-based completion (mark done without evidence)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option 2:&lt;/strong&gt; Automated verification only (CI gates, no human review evidence)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option 3:&lt;/strong&gt; Structured evidence payloads with explicit reconciliation&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Option 4:&lt;/strong&gt; Centralized service-based reconciliation&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 3: Structured evidence payloads with explicit reconciliation”, because it makes “done” verifiable, supports both execution modes, preserves offline capability, and integrates with the state machine’s guard conditions.&lt;/p&gt;
&lt;h3 id=&quot;implementation&quot;&gt;Implementation&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Evidence payload for &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt; transitions:&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;Every event transitioning a WP to &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt; must include a structured &lt;code dir=&quot;auto&quot;&gt;evidence&lt;/code&gt; field:&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;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;repos&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 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;repo&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;spec-kitty-saas&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;branch&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;feature/WP05-webhook-handler&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&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;abc123f&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;files_touched&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;apps/connectors/views.py&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 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 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;verification&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 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;command&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;pytest apps/connectors/tests/&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;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;passed&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;summary&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;12 tests passed, 0 failed&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&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 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;review&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;reviewer&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;architecture-team-review&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;verdict&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;approved&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;reference&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;WP05 review feedback&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&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 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;p&gt;&lt;strong&gt;Execution modes:&lt;/strong&gt; Feature metadata includes &lt;code dir=&quot;auto&quot;&gt;execution_mode&lt;/code&gt;:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;worktree&lt;/code&gt; (default) — evidence gathered from worktree branch&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;direct_repo&lt;/code&gt; — evidence explicitly gathered via reconciliation&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Reconciliation command (&lt;code dir=&quot;auto&quot;&gt;status reconcile&lt;/code&gt;):&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Scan&lt;/strong&gt;: Examine target repos for WP-linked commits and evidence&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Detect&lt;/strong&gt;: Identify drift between planning status and implementation reality&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Emit&lt;/strong&gt;: Generate reconciliation events (dry-run shows proposed; apply appends to canonical log)&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Never implicit&lt;/strong&gt;: Reconciliation never silently mutates state&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Guard integration:&lt;/strong&gt; Evidence satisfies ADR 2026-02-09-2 guards:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Guard 3 (&lt;code dir=&quot;auto&quot;&gt;in_progress → for_review&lt;/code&gt;): Satisfied by &lt;code dir=&quot;auto&quot;&gt;evidence.repos&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;evidence.verification&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Guard 4 (&lt;code dir=&quot;auto&quot;&gt;for_review → done&lt;/code&gt;): Satisfied by &lt;code dir=&quot;auto&quot;&gt;evidence.review&lt;/code&gt;&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;“Done” is verifiable — every completion includes structured proof&lt;/li&gt;
&lt;li&gt;Cross-repo drift is detectable via &lt;code dir=&quot;auto&quot;&gt;status reconcile&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Dual execution modes have first-class evidence paths&lt;/li&gt;
&lt;li&gt;Reconciliation is explicit — events always written to canonical log, no silent mutation&lt;/li&gt;
&lt;li&gt;Audit trail complete — evidence captures the full chain: code → tests → review → approval&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;negative&quot;&gt;Negative&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;Evidence gathering adds friction to WP completion&lt;/li&gt;
&lt;li&gt;Reconciliation tooling (&lt;code dir=&quot;auto&quot;&gt;status reconcile&lt;/code&gt; with scan, detect, dry-run, apply) must be built&lt;/li&gt;
&lt;li&gt;Dry-run adds a manual review step before applying&lt;/li&gt;
&lt;li&gt;Evidence schema may need evolution for different WP types (code, research, documentation)&lt;/li&gt;
&lt;/ul&gt;
&lt;h4 id=&quot;neutral&quot;&gt;Neutral&lt;/h4&gt;
&lt;ul&gt;
&lt;li&gt;Auto-collection from git: &lt;code dir=&quot;auto&quot;&gt;status emit&lt;/code&gt; can auto-populate &lt;code dir=&quot;auto&quot;&gt;repos[]&lt;/code&gt; from branch commit log&lt;/li&gt;
&lt;li&gt;Evidence stored as JSON, so schema evolution is non-breaking&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;status doctor&lt;/code&gt; provides automated detection of stale completions and unresolved drift&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;confirmation&quot;&gt;Confirmation&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;CI check: &lt;code dir=&quot;auto&quot;&gt;done&lt;/code&gt; events without evidence payload are flagged&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;status reconcile --dry-run&lt;/code&gt; shows proposed events before applying&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;status doctor&lt;/code&gt; detects orphaned workspaces and stale completions&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;trust-based-completion-mark-done-without-evidence&quot;&gt;Trust-based completion (mark done without evidence)&lt;/h3&gt;
&lt;p&gt;Allow WPs to be marked “done” based on the implementer’s assertion.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Zero friction — fastest path to completion&lt;/li&gt;
&lt;li&gt;No tooling required&lt;/li&gt;
&lt;li&gt;Works for any execution mode without special handling&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;“Done” is a meaningless assertion — no way to verify what was implemented&lt;/li&gt;
&lt;li&gt;Enables split-brain between planning and target repos&lt;/li&gt;
&lt;li&gt;No audit trail for what was tested or reviewed&lt;/li&gt;
&lt;li&gt;Scales poorly to multi-agent work — cannot verify AI agent completions&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;automated-verification-only-ci-gates-no-human-review&quot;&gt;Automated verification only (CI gates, no human review)&lt;/h3&gt;
&lt;p&gt;Require CI pipeline results as evidence, but don’t capture human review context.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Fully automated — no manual evidence gathering&lt;/li&gt;
&lt;li&gt;Objective — test results are binary (pass/fail)&lt;/li&gt;
&lt;li&gt;Integrates with existing CI infrastructure&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;Cannot capture human review context (architecture review, UX evaluation)&lt;/li&gt;
&lt;li&gt;State machine guard condition 4 requires reviewer identity — missing without review evidence&lt;/li&gt;
&lt;li&gt;Not all WPs have automated tests (documentation, research, planning WPs)&lt;/li&gt;
&lt;li&gt;Misses the “who approved and why” audit trail&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;centralized-service-based-reconciliation&quot;&gt;Centralized service-based reconciliation&lt;/h3&gt;
&lt;p&gt;Use the SaaS platform to continuously monitor target repos and auto-reconcile.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Pros:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Real-time drift detection — no manual triggering&lt;/li&gt;
&lt;li&gt;Dashboard visibility&lt;/li&gt;
&lt;li&gt;Can integrate with GitHub/GitLab webhooks&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;Requires online centralized service — violates non-goal: “Not replacing git with an online control plane”&lt;/li&gt;
&lt;li&gt;Breaks offline workflow&lt;/li&gt;
&lt;li&gt;Single point of failure&lt;/li&gt;
&lt;li&gt;Canonical authority question: does the service or git own the truth?&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;Related ADRs:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;ADR 2026-02-09-1 (Canonical WP Status Model) — evidence events appended to the same JSONL log&lt;/li&gt;
&lt;li&gt;ADR 2026-02-09-2 (WP Lifecycle State Machine) — evidence satisfies guard conditions&lt;/li&gt;
&lt;li&gt;ADR 2026-02-09-3 (Event-Log Merge Semantics) — reconciliation events participate in merge&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;References:&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;The Twelve-Factor App: Admin Processes — &lt;a href=&quot;https://12factor.net/admin-processes&quot;&gt;https://12factor.net/admin-processes&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;PRD: Feature Status State Model Remediation (Sections 2, 4, 8, 10, 11)&lt;/li&gt;
&lt;/ul&gt;</content>
</entry>
