flow.html

<!-- Source of the "Recon Pipeline — Flow" artifact.
     Published at: https://claude.ai/code/artifact/53660415-52a9-42a1-be17-21be0ff88cdc
     Favicon: 🛤️ — artifact identity, keep it identical on every republish.
     After editing, republish from this file so the artifact matches the repo.
     Every file reference here is a GitHub link so it fails loudly on drift;
     tools/check-links.sh verifies them against the working tree. -->
<title>Recon Pipeline — Flow</title>
<style>
  :root {
    --paper: #f5f3ee; --paper-2: #edeae2; --ink: #221f19; --ink-2: #5c564a;
    --line: #d8d3c6; --accent: #b57e1c; --accent-soft: #f0e4cb;
    --good: #3e7d4e; --good-soft: #dceadf; --bad: #a8433c; --bad-soft: #f0dcd9;
    --rail: #3d6a8f; --rail-soft: #dde7ee;
    --code-bg: #eae7de;
    --serif: 'Iowan Old Style', 'Palatino Linotype', Palatino, Georgia, serif;
    --sans: system-ui, -apple-system, 'Segoe UI', sans-serif;
    --mono: ui-monospace, 'SF Mono', 'Cascadia Code', Menlo, Consolas, monospace;
  }
  @media (prefers-color-scheme: dark) {
    :root {
      --paper: #17181b; --paper-2: #1f2024; --ink: #e8e4da; --ink-2: #a49d8e;
      --line: #34353a; --accent: #d9a13f; --accent-soft: #35301f;
      --good: #7cbf8c; --good-soft: #21301f; --bad: #d98a80; --bad-soft: #392220;
      --rail: #7ea9cc; --rail-soft: #1e2a35;
      --code-bg: #212227;
    }
  }
  :root[data-theme="light"] {
    --paper: #f5f3ee; --paper-2: #edeae2; --ink: #221f19; --ink-2: #5c564a;
    --line: #d8d3c6; --accent: #b57e1c; --accent-soft: #f0e4cb;
    --good: #3e7d4e; --good-soft: #dceadf; --bad: #a8433c; --bad-soft: #f0dcd9;
    --rail: #3d6a8f; --rail-soft: #dde7ee;
    --code-bg: #eae7de;
  }
  :root[data-theme="dark"] {
    --paper: #17181b; --paper-2: #1f2024; --ink: #e8e4da; --ink-2: #a49d8e;
    --line: #34353a; --accent: #d9a13f; --accent-soft: #35301f;
    --good: #7cbf8c; --good-soft: #21301f; --bad: #d98a80; --bad-soft: #392220;
    --rail: #7ea9cc; --rail-soft: #1e2a35;
    --code-bg: #212227;
  }

  html { background: var(--paper); }
  body {
    margin: 0; font-family: var(--sans); font-size: 15px; line-height: 1.5;
    color: var(--ink); background: var(--paper);
  }
  .wrap { max-width: 860px; margin: 0 auto; padding: 48px 24px 96px; }

  h1 {
    font-family: var(--mono); font-weight: 700; font-size: 20px;
    letter-spacing: 0.04em; margin: 0 0 6px;
  }
  .sub { color: var(--ink-2); margin: 0 0 20px; max-width: 68ch; }
  code {
    font-family: var(--mono); font-size: 0.86em;
    background: var(--code-bg); padding: 1.5px 5px; border-radius: 3px;
  }
  a { color: var(--accent); text-decoration-thickness: 1px; text-underline-offset: 2px; }
  a code { color: inherit; }

  .legend { display: flex; flex-wrap: wrap; gap: 10px; margin: 0 0 40px; }
  .chip {
    display: inline-flex; align-items: center; gap: 7px;
    font-family: var(--mono); font-size: 12px; font-weight: 600;
    padding: 5px 12px; border-radius: 3px; border: 1px solid var(--line);
    background: var(--paper-2); color: var(--ink);
  }
  .chip::before { content: ''; width: 8px; height: 8px; border-radius: 50%; background: var(--ink-2); flex: none; }
  .chip.rail { border-color: var(--rail); background: var(--rail-soft); color: var(--rail); }
  .chip.rail::before { background: var(--rail); }
  .chip.judge { border-color: var(--accent); background: var(--accent-soft); color: var(--accent); }
  .chip.judge::before { background: var(--accent); }
  .chip.human { border-color: var(--bad); background: var(--bad-soft); color: var(--bad); }
  .chip.human::before { background: var(--bad); }
  .chip.ver { margin-left: auto; }

  /* stage header */
  .stage {
    margin: 44px 0 14px; padding-bottom: 6px; border-bottom: 2px solid var(--line);
    display: flex; align-items: baseline; gap: 12px; flex-wrap: wrap;
  }
  .stage h2 {
    margin: 0; font-family: var(--mono); font-size: 13px; font-weight: 700;
    letter-spacing: 0.14em; text-transform: uppercase; color: var(--accent);
  }
  .stage.blocked h2 { color: var(--bad); }
  .stage small { font-family: var(--mono); font-size: 11px; color: var(--ink-2); }

  /* step card: header row + field grid */
  .step {
    border: 1px solid var(--line); border-radius: 4px; background: var(--paper-2);
    margin: 0 0 12px; overflow: hidden;
  }
  .step-h {
    display: flex; align-items: baseline; gap: 10px; flex-wrap: wrap;
    padding: 9px 14px; border-bottom: 1px solid var(--line);
  }
  .step-no {
    font-family: var(--mono); font-size: 11px; font-weight: 700; letter-spacing: 0.08em;
    color: var(--ink-2); flex: none;
  }
  .step-h h3 { margin: 0; font-family: var(--serif); font-size: 16.5px; font-weight: 600; }
  .step-h .src { margin-left: auto; font-family: var(--mono); font-size: 11.5px; white-space: nowrap; }
  .step.rail  { border-left: 3px solid var(--rail); }
  .step.judge { border-left: 3px solid var(--accent); }
  .step.human { border-left: 3px solid var(--bad); }
  .step.rail  .step-no { color: var(--rail); }
  .step.judge .step-no { color: var(--accent); }
  .step.human .step-no { color: var(--bad); }

  .fields { display: grid; grid-template-columns: 64px 1fr; }
  .fields dt {
    font-family: var(--mono); font-size: 10px; font-weight: 700; letter-spacing: 0.12em;
    text-transform: uppercase; color: var(--ink-2);
    padding: 7px 0 7px 14px; border-top: 1px dashed var(--line);
  }
  .fields dd {
    margin: 0; padding: 6px 14px 6px 0; font-size: 13.5px; color: var(--ink);
    border-top: 1px dashed var(--line);
  }
  .fields dt:first-of-type, .fields dd:first-of-type { border-top: none; }
  .fields dd .sep { color: var(--ink-2); padding: 0 4px; }

  .w-rail { color: var(--rail); font-weight: 600; }
  .w-judge { color: var(--accent); font-weight: 600; }
  .w-human { color: var(--bad); font-weight: 600; }

  /* comment mock */
  .comment-mock {
    margin: 10px 14px; border: 1px solid var(--line); border-radius: 4px;
    background: var(--paper); padding: 11px 14px;
    font-family: var(--mono); font-size: 12px; line-height: 1.75;
    overflow-x: auto;
  }
  .comment-mock .cm { white-space: nowrap; }
  .comment-mock .cm b { font-weight: 700; }
  .comment-mock .cm .m { color: var(--rail); font-weight: 700; }
  .comment-mock .cm .att { color: var(--accent); text-decoration: underline; text-underline-offset: 2px; }
  .comment-mock .cm.dim { color: var(--ink-2); }
  .cm-caption {
    margin: 0 14px 12px; font-family: var(--mono); font-size: 10.5px;
    letter-spacing: 0.1em; text-transform: uppercase; color: var(--ink-2);
  }

  .stopbar {
    display: flex; align-items: baseline; gap: 12px; flex-wrap: wrap;
    margin: 4px 0 0; padding: 10px 14px;
    border: 1px dashed var(--ink-2); border-radius: 4px; background: var(--paper);
  }
  .stamp {
    font-family: var(--mono); font-size: 12px; font-weight: 700;
    letter-spacing: 0.12em; text-transform: uppercase; color: var(--ink-2);
    border: 2px solid var(--ink-2); border-radius: 3px; padding: 3px 10px;
    transform: rotate(-1deg); background: var(--paper); flex: none;
  }
  .stopbar p { margin: 0; font-size: 13.5px; color: var(--ink-2); }

  /* registry */
  section.reg { margin-top: 56px; }
  .kicker {
    font-family: var(--mono); font-size: 11.5px; letter-spacing: 0.14em;
    text-transform: uppercase; color: var(--accent); margin: 0 0 4px;
  }
  .reg h2 { font-family: var(--serif); font-weight: 600; font-size: 22px; margin: 0 0 12px; }
  .tablewrap { overflow-x: auto; border: 1px solid var(--line); border-radius: 4px; }
  table { border-collapse: collapse; width: 100%; font-size: 13.5px; }
  th {
    font-family: var(--mono); font-size: 10.5px; letter-spacing: 0.1em; text-transform: uppercase;
    text-align: left; color: var(--ink-2); font-weight: 600;
    padding: 9px 13px; background: var(--paper-2); border-bottom: 1px solid var(--line);
    white-space: nowrap;
  }
  td { padding: 8px 13px; border-bottom: 1px solid var(--line); vertical-align: top; }
  tr:last-child td { border-bottom: none; }
  td.mono { font-family: var(--mono); font-size: 12px; white-space: nowrap; }

  footer {
    margin-top: 56px; border-top: 1px solid var(--line); padding-top: 16px;
    font-family: var(--mono); font-size: 12px; color: var(--ink-2); line-height: 1.9;
  }
</style>

<div class="wrap">

  <header>
    <h1>RECON PIPELINE — FLOW</h1>
    <p class="sub">Every step: <strong>WHO</strong> acts (rail = zero model freedom · judgment = evidence required · red = you) · <strong>IN</strong> → <strong>OUT</strong> · the <strong>RULE</strong> that binds it. Every file name links to the source of truth on GitHub — when in doubt, the repo wins, not this page. Machine spec: <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/docs/pipeline.md">pipeline.md</a>.</p>
    <div class="legend">
      <span class="chip rail">RAIL</span>
      <span class="chip judge">JUDGMENT</span>
      <span class="chip human">HUMAN GATE</span>
      <!-- coherence:version --><span class="chip ver">recon v0.21.0</span>
    </div>
  </header>

  <div class="stage">
    <h2>Stage 0–1 · Triage</h2>
    <small>entry: Recon Triage ATT-1234 (host invocation rendered by reconctl) · skill: <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-triage/SKILL.md">recon-triage/SKILL.md</a></small>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">START</span><h3>Atomic runtime contract</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/reconctl.sh">reconctl.sh start triage</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span></dd>
      <dt>in</dt><dd>explicit <code>base|triage</code> profile + current host environment</dd>
      <dt>out</dt><dd>one root · host · surface · capability · preflight snapshot</dd>
      <dt>rule</dt><dd>pure output, no context file <span class="sep">·</span> failure stops before mutation <span class="sep">·</span> later event rails re-detect current host provenance</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">STEP 0</span><h3>Fresh workspace</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/fresh-workspace.sh">fresh-workspace.sh</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span></dd>
      <dt>in</dt><dd>ticket ID</dd>
      <dt>out</dt><dd><code>meta.yaml</code> <span class="sep">·</span> <code>index.md</code> <span class="sep">·</span> prior artifacts → <code>runs/&lt;ts&gt;/</code></dd>
      <dt>rule</dt><dd>runs exactly once (30-min guard) <span class="sep">·</span> <code>runs/</code> is unreadable for the rest of the run</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">STEP 1</span><h3>Fetch &amp; partition</h3>
      <span class="src">curl · Jira API v2 (<a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/docs/decisions/0001-jira-rest-api-over-mcp.md">why not MCP</a>)</span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span></dd>
      <dt>in</dt><dd>live ticket + linked resources (GET only)</dd>
      <dt>out</dt><dd><code>triage/ticket.json</code> <span class="sep">·</span> <code>triage/aux-&lt;slug&gt;.json</code></dd>
      <dt>rule</dt><dd>comments containing the <code>recon-triage</code> marker = pipeline output, excluded from evidence</dd>
    </dl>
  </div>

  <div class="step judge">
    <div class="step-h"><span class="step-no">STEP 2</span><h3>Decision audit, then six checks</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-triage/SKILL.md">SKILL.md §2–3</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-judge">judgment</span></dd>
      <dt>in</dt><dd>ticket.json + git/gh + fetched links</dd>
      <dt>out</dt><dd><code>triage/triage.yaml</code> — closure statuses, six check values, atomic blockers, TYPED evidence (<code>kind: quote|http|git|file|note</code>)</dd>
      <dt>rule</dt><dd>every candidate carries evidence <span class="sep">·</span> blocking OPEN decisions join one-to-one to blockers <span class="sep">·</span> the model does NOT pick the verdict</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">STEP 3</span><h3>Verify the verdict</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/verify-triage.sh">verify-triage.sh</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span> (new in v0.8.0)</dd>
      <dt>in</dt><dd><code>triage.yaml</code> + <code>ticket.json</code></dd>
      <dt>out</dt><dd><strong>READY</strong> | <strong>BLOCKED</strong> | <strong>NEEDS_INFO</strong> — derived from the checks; <code>verify: clean</code> or failures</dd>
      <dt>rule</dt><dd>closure audit and dependency checks are DERIVED (invariant 15) — mismatch ⇒ fix the audit/checks, never the verdict <span class="sep">·</span> ticket quotes and supplied file lines are verified <span class="sep">·</span> READY → auto-chain to discovery and, after package approval, its own delivery path <span class="sep">·</span> BLOCKED/NEEDS_INFO → posting path, needs ≥1 atomic blocker</dd>
    </dl>
  </div>

  <div class="stage blocked">
    <h2>Posting path · Blocked / Needs_info</h2>
    <small>v0.7.0, render rail v0.8.0 · short comment on the ticket, depth as attachments · invariants 13–15 in <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/docs/pipeline.md">pipeline.md</a></small>
  </div>

  <div class="step judge">
    <div class="step-h"><span class="step-no">P1</span><h3>Structure the blockers</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-triage/SKILL.md">SKILL.md §step 4</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-judge">judgment</span></dd>
      <dt>in</dt><dd>the failed checks</dd>
      <dt>out</dt><dd><code>blockers[]</code>: title · owner · <strong>owner_account_id</strong> · ask · detail <span class="sep">·</span> <code>aux-user-&lt;slug&gt;.json</code> (accountId lookups)</dd>
      <dt>rule</dt><dd>ask = ONE sentence ending "?" <span class="sep">·</span> depth goes in <code>detail</code> <span class="sep">·</span> UI blocker → <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-repro/SKILL.md">recon-repro</a> then <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/verify-repro.sh">verify-repro.sh</a> first <span class="sep">·</span> accountIds from user-search, never guessed — on duplicate names, prefer the account already on the ticket <span class="sep">·</span> re-run <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/verify-triage.sh">verify-triage.sh</a> until clean</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">P2</span><h3>Dossier — render-only</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-report/SKILL.md">recon-report/SKILL.md</a> · <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-report/template.html">template.html</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span> (fixed template, no new facts)</dd>
      <dt>in</dt><dd>current-run artifacts</dd>
      <dt>out</dt><dd><code>report/dossier.html</code> — Blockers &amp; question packs section leads</dd>
      <dt>rule</dt><dd>NO publishing on this path — the ticket attachment is the delivery; the same render-only dossier rail is used after approved READY Discovery</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">P3</span><h3>Render the delivery comment</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/render-comment.sh">render-comment.sh</a> · <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/verify-comment-shape.sh">verify-comment-shape.sh</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span> renders (new in v0.8.0) — the asks were <span class="w-judge">judgment</span> upstream, in <code>triage.yaml</code></dd>
      <dt>in</dt><dd>BLOCKED/NEEDS_INFO: <code>triage.yaml</code> + <code>meta.yaml</code>; READY: also approved <code>gate.yaml</code> + <code>routing.yaml</code></dd>
      <dt>out</dt><dd><code>triage/jira/comment.txt</code> — the exact posted bytes</dd>
      <dt>rule</dt><dd>the model NEVER writes <code>comment.txt</code> — edits go to source artifacts, then re-render <span class="sep">·</span> BLOCKED/NEEDS_INFO are exactly n+4 non-empty lines; approved READY is a fixed six-line discovery index, independently checked until <code>shape: clean</code></dd>
    </dl>
    <div class="comment-mock" role="img" aria-label="Example of the posted Jira comment">
      <div class="cm">h2. Recon triage: BLOCKED — 3 blocker(s) (1 Aug)</div>
      <div class="cm"><b>*1. Updated design*</b> — <span class="m">@Osman</span>: deliver the updated design, or do I build to the attached PNG?</div>
      <div class="cm"><b>*2. Video hosting*</b> — <span class="m">@Barım</span>: who uploads the video, and what are the resulting id and hash?</div>
      <div class="cm"><b>*3. AC #5 events*</b> — <span class="m">@Osman</span>: exact event names and properties — or split AC #5 to a follow-up?</div>
      <div class="cm">Full detail, options, and evidence: <span class="att">recon-dossier-ATT-5107.html</span> · <span class="att">recon-artifacts-ATT-5107.zip</span></div>
      <div class="cm">Reply here — answers on this ticket un-block the pipeline.</div>
      <div class="cm dim">~recon-triage v0.21.0~</div>
    </div>
    <p class="cm-caption">header · one line per blocker · links · reply · marker</p>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">P4</span><h3>Package</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/package-artifacts.sh">package-artifacts.sh</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span></dd>
      <dt>in</dt><dd>whole workspace (dossier included)</dd>
      <dt>out</dt><dd><code>recon-artifacts-&lt;TICKET&gt;.zip</code> (temp) <span class="sep">·</span> <code>triage/jira/bundle-manifest.txt</code></dd>
      <dt>rule</dt><dd>never includes <code>runs/</code> <span class="sep">·</span> the zip never lives inside the workspace</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">P5</span><h3>Render the gate question</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/render-post-gate.sh">render-post-gate.sh</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span></dd>
      <dt>in</dt><dd><code>comment.txt</code> + <code>bundle-manifest.txt</code> + the staged zip</dd>
      <dt>out</dt><dd><code>triage/jira/post-gate-questions.txt</code> — the comment bytes, both attachment names with real sizes, the bundle count, and the three options</dd>
      <dt>rule</dt><dd>the gate presents these bytes word-for-word, never a paraphrase <span class="sep">·</span> never hand-edited — edit <code>triage.yaml</code> and re-render the chain <span class="sep">·</span> byte-deterministic for identical inputs</dd>
    </dl>
  </div>

  <div class="step human">
    <div class="step-h"><span class="step-no">P6</span><h3>GATE — one answer for everything</h3>
      <span class="src">you</span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-human">human</span></dd>
      <dt>in</dt><dd>the rendered question, quoted verbatim (comment bytes + 2 filenames, sizes, bundle count)</dd>
      <dt>out</dt><dd><strong>Post</strong> / <strong>Edit first</strong> / <strong>Don't post</strong>, recorded in <code>triage/jira/post-gate.yaml</code> — one entry per presentation, your exact words next to the mapped <code>outcome</code></dd>
      <dt>rule</dt><dd>one "post" = comment AND both attachments <span class="sep">·</span> any edit lands in <code>triage.yaml</code> → verify → re-render → re-package → re-render the question → re-show gate, appending an <code>edited</code> entry <span class="sep">·</span> nothing touches Jira before this <span class="sep">·</span> "don't post" is a recorded outcome, not an absence</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">P7</span><h3>Attach first, then comment</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/attach-artifacts.sh">attach-artifacts.sh</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span></dd>
      <dt>in</dt><dd><code>recon-dossier-&lt;TICKET&gt;.html</code> + zip</dd>
      <dt>out</dt><dd><code>triage/jira/attach-result.json</code> <span class="sep">·</span> <code>post-result.json</code></dd>
      <dt>rule</dt><dd>delete only <code>recon-*-&lt;TICKET&gt;.*</code>, then upload — replace, never accumulate <span class="sep">·</span> attach BEFORE comment (duplicate names bind links to the OLDER file) <span class="sep">·</span> edit the marker comment, never append a second</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">P8</span><h3>Verify the recorded answer</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/verify-post-gate.sh">verify-post-gate.sh</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span></dd>
      <dt>in</dt><dd><code>post-gate-questions.txt</code> + <code>post-gate.yaml</code> + what is on disk</dd>
      <dt>out</dt><dd><code>post-gate: clean</code> before the run reports</dd>
      <dt>rule</dt><dd>the rendered question carried the posted comment bytes verbatim <span class="sep">·</span> every answer non-empty, the terminal entry last <span class="sep">·</span> <code>posted</code> needs a <code>post-result.json</code>, <code>declined</code> forbids one</dd>
    </dl>
  </div>

  <div class="stopbar">
    <span class="stamp">Stop</span>
    <p>Owners answer <em>on the ticket</em>. A human reply after the marker comment counts as answered — run Recon Triage again using the host-rendered invocation and the stale-blocker check re-evaluates.</p>
  </div>

  <div class="stage">
    <h2>Stage 2 · Discovery</h2>
    <small>precondition: disposition READY · skill: <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-discovery/SKILL.md">recon-discovery/SKILL.md</a></small>
  </div>

  <div class="step judge">
    <div class="step-h"><span class="step-no">D1</span><h3>Map the surface, write the contract</h3></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-judge">judgment</span></dd>
      <dt>in</dt><dd>repo + <code>triage.yaml</code></dd>
      <dt>out</dt><dd><code>discovery/discovery.md</code> — <code>REQ-N</code> + <code>REG-N</code> + <code>OPEN-N</code> Gherkin scenarios</dd>
      <dt>rule</dt><dd>root cause at <code>file:line</code> <span class="sep">·</span> stable IDs join contract, brief, and gate <span class="sep">·</span> OPEN options phrased as user-observable outcomes, never silent assumptions</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">D2</span><h3>Governance ladder → routing fork</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/detect-governance.sh">detect-governance.sh</a> · <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/route-generic.sh">route-generic.sh</a> | <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-decree/SKILL.md">recon-decree</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span></dd>
      <dt>in</dt><dd>env var → <code>~/.config/recon/config</code> → probe</dd>
      <dt>out</dt><dd><code>route/routing.yaml</code> (route · rule trace · handoff as data) <span class="sep">·</span> adapter also <code>route/aux-intent-check.txt</code></dd>
      <dt>rule</dt><dd>detection never opts a developer in <span class="sep">·</span> <code>matched_rule</code> + <code>rules_not_matched</code> recorded <span class="sep">·</span> handoff quoted verbatim, never recomposed</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">D3</span><h3>Repro trigger</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-repro/SKILL.md">recon-repro/SKILL.md</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span> triggers <span class="sep">·</span> <span class="w-judge">judgment</span> reproduces</dd>
      <dt>in</dt><dd><code>task_class</code> + surface + route (condition table)</dd>
      <dt>out</dt><dd><code>repro/repro.md</code> fixed frontmatter <span class="sep">·</span> <code>repro/exhibits/&lt;n&gt;-&lt;slug&gt;.png</code> <span class="sep">·</span> <code>repro/session/</code> recorded bundle (action log + video)</dd>
      <dt>rule</dt><dd>fires on defect + visible UI + non-trivial route, or any UI OPEN scenario <span class="sep">·</span> every browser action recorded through <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/record-repro.sh">record-repro.sh</a> (pinned proofshot) <span class="sep">·</span> happens before the brief <span class="sep">·</span> failed repro = reported finding, never faked</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">D4</span><h3>Verify repro evidence</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/verify-repro.sh">verify-repro.sh</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span> for structure/provenance <span class="sep">·</span> <span class="w-judge">judgment</span> still reads the pixels</dd>
      <dt>in</dt><dd><code>repro.md</code> + current-run PNG exhibits + <code>session-log.json</code></dd>
      <dt>out</dt><dd><code>verify: clean</code> or actionable package failures</dd>
      <dt>rule</dt><dd>regular non-symlinked paths · contiguous visible step/exhibit parity (HTML comments do not count) · PNG chunk/order/CRC/zlib/IEND integrity · exhibits paired to logged screenshot actions in step order · no orphan/stale evidence <span class="sep">·</span> visual meaning remains human/model judgment</dd>
    </dl>
  </div>

  <div class="step judge">
    <div class="step-h"><span class="step-no">D5</span><h3>Routed brief — when required</h3></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-judge">judgment</span></dd>
      <dt>in</dt><dd><code>discovery.md</code> + <code>routing.yaml</code> + verified <code>repro.md</code> when triggered</dd>
      <dt>out</dt><dd><code>discovery/spec-draft.md</code>, intentionally absent for <code>brief_kind: none</code></dd>
      <dt>rule</dt><dd>exact visible scenario-ID parity in either brief shape + fixed sections; comments and code examples cannot become joins <span class="sep">·</span> Manual verification consumes only verified repro evidence (or says why none exists)</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">D6</span><h3>Verify the pre-gate package</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/verify-discovery.sh">verify-discovery.sh pre-gate</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span></dd>
      <dt>in</dt><dd>contract + route + route-required brief + handoff</dd>
      <dt>out</dt><dd><code>verify: clean</code> before any approval question</dd>
      <dt>rule</dt><dd>unique IDs · Gherkin shape · both brief shapes and exact ID parity · valid route and non-empty handoff <span class="sep">·</span> no-brief routes are valid</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">D7</span><h3>Render the gate questions</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/render-gate.sh">render-gate.sh</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span></dd>
      <dt>in</dt><dd><code>discovery.md</code> + <code>routing.yaml</code></dd>
      <dt>out</dt><dd><code>discovery/gate-questions.md</code> — one block per <code>OPEN-N</code> (options with exactly one <code>(recommended)</code>) + the <code>PACKAGE</code> block</dd>
      <dt>rule</dt><dd>the gate presents these bytes word-for-word, never a paraphrase <span class="sep">·</span> never hand-edited — edit <code>discovery.md</code> and re-render <span class="sep">·</span> byte-deterministic for identical inputs</dd>
    </dl>
  </div>

  <div class="step human">
    <div class="step-h"><span class="step-no">D8</span><h3>GATE — approval</h3>
      <span class="src">you</span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-human">human</span></dd>
      <dt>in</dt><dd>the rendered <code>OPEN-N</code> and <code>PACKAGE</code> blocks, quoted verbatim</dd>
      <dt>out</dt><dd><code>discovery/gate.yaml</code> — approve / edit / reject, exact <code>OPEN-N</code> keys recorded plus one verbatim exchange per question (your exact answer next to its mapped resolution); approval also updates the same-ID brief entry</dd>
      <dt>rule</dt><dd>approved outcome copied verbatim to its deterministic destination <span class="sep">·</span> nothing proceeds past a reject — reason recorded, fix re-enters discovery <span class="sep">·</span> rejected packages retain exact OPEN-key parity</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">D9</span><h3>Verify the recorded decision</h3>
      <span class="src"><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/verify-discovery.sh">verify-discovery.sh post-gate</a></span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span></dd>
      <dt>in</dt><dd>pre-gate package + <code>gate-questions.md</code> + <code>gate.yaml</code></dd>
      <dt>out</dt><dd><code>verify: clean</code> before rejection stop, dossier, delivery, or handoff</dd>
      <dt>rule</dt><dd>parseable approval record + exact OPEN resolution parity + verbatim same-ID approved-outcome join <span class="sep">·</span> rendered questions cover every OPEN + PACKAGE, each with a non-empty verbatim answer whose resolution matches</dd>
    </dl>
  </div>

  <div class="step human">
    <div class="step-h"><span class="step-no">D10</span><h3>READY delivery gate</h3>
      <span class="src">you</span></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span> renders and stages <span class="sep">·</span> <span class="w-human">human</span> approves delivery</dd>
      <dt>in</dt><dd>approved package → render-only dossier + fixed READY comment + ZIP manifest + rendered posting-gate bytes</dd>
      <dt>out</dt><dd><strong>Post</strong> / <strong>Edit first</strong> / <strong>Don't post</strong></dd>
      <dt>rule</dt><dd>this is distinct from package approval <span class="sep">·</span> present the rail-rendered posting-gate bytes verbatim and record the exchange <span class="sep">·</span> attach first, then create/edit the marker comment</dd>
    </dl>
  </div>

  <div class="step rail">
    <div class="step-h"><span class="step-no">D11</span><h3>Handoff</h3></div>
    <dl class="fields">
      <dt>who</dt><dd><span class="w-rail">rail</span></dd>
      <dt>in</dt><dd><code>routing.yaml</code> <code>handoff:</code> block</dd>
      <dt>out</dt><dd>the exact next commands, printed</dd>
      <dt>rule</dt><dd>quoted verbatim, never executed — implementation belongs to a NEW session</dd>
    </dl>
  </div>

  <div class="stopbar">
    <span class="stamp">Stop</span>
    <p>After any stop, <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-report/SKILL.md">recon-report</a> fills <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-report/template.html">the fixed template</a> and publishes only when the local host exposes a publisher. <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-state/SKILL.md">recon-state</a> keeps the living canvas honest: state is derived from artifact presence by <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/derive-state.sh">rail</a>, always rendered locally, and republished only when stable-URL publishing is available.</p>
  </div>

  <section class="reg">
    <p class="kicker">Workspace</p>
    <h2>What a run leaves behind — <code>~/.claude/recon/&lt;TICKET&gt;/</code></h2>
    <p style="font-size:14px;color:var(--ink-2)">Checked mechanically by <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/lint-workspace.sh">lint-workspace.sh</a> against the registry in <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/docs/pipeline.md">pipeline.md</a> — an unregistered file fails the run. Full per-file docs: <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/docs/workspace-index.md">workspace-index.md</a> (copied into every workspace as <code>index.md</code>).</p>
    <div class="tablewrap">
      <table>
        <thead><tr><th>Artifact</th><th>Producer</th><th>Consumed by</th></tr></thead>
        <tbody>
          <tr><td class="mono">meta.yaml · index.md</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/fresh-workspace.sh">fresh-workspace.sh</a></td><td>current-run check, starting host/surface provenance, humans</td></tr>
          <tr><td class="mono">runs/&lt;ts&gt;/…</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/fresh-workspace.sh">fresh-workspace.sh</a></td><td><strong>nobody</strong> — reading archived runs is banned</td></tr>
          <tr><td class="mono">history.ndjson</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/log-event.sh">log-event.sh</a> (closed vocabulary + current host/surface; survives step 0)</td><td>state canvas timeline, humans — output, <strong>never evidence</strong></td></tr>
          <tr><td class="mono">triage/{ticket.json, aux-*.json}</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-triage/SKILL.md">triage</a></td><td>the six checks; aux-user-*.json backs the @mentions</td></tr>
          <tr><td class="mono">triage/triage.yaml</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-triage/SKILL.md">triage</a>, verified by <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/verify-triage.sh">verify-triage.sh</a></td><td>discovery precondition; disposition derived + quotes verified from it; comment AND dossier both render from it</td></tr>
          <tr><td class="mono">triage/jira/{comment.txt, bundle-manifest.txt}</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/render-comment.sh">render-comment.sh</a> · <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/package-artifacts.sh">package-artifacts.sh</a></td><td>the BLOCKED/NEEDS_INFO or approved READY delivery gate (exact bytes + what ships), audit</td></tr>
          <tr><td class="mono">triage/jira/{post-gate-questions.txt, post-gate.yaml}</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/render-post-gate.sh">render-post-gate.sh</a> · triage, verified by <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/verify-post-gate.sh">verify-post-gate.sh</a></td><td>the posting gate (exact asked bytes + one verbatim exchange per presentation), state derivation, audit</td></tr>
          <tr><td class="mono">triage/jira/{attach-result.json, post-result.json}</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/attach-artifacts.sh">attach-artifacts.sh</a> · comment rail (after "post")</td><td>delivery audit — attach-result absent ⇒ attachment replacement never completed</td></tr>
          <tr><td class="mono">discovery/{discovery.md, gate-questions.md, gate.yaml, spec-draft.md}</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-discovery/SKILL.md">discovery</a> (gate-questions.md by <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/render-gate.sh">render-gate.sh</a>), verified by <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/verify-discovery.sh">verify-discovery.sh</a></td><td>gate (exact asked bytes + verbatim exchanges), dossier decision cards, the implementing session; spec-draft absent for brief_kind none</td></tr>
          <tr><td class="mono">route/{routing.yaml, aux-intent-check.txt}</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/route-generic.sh">route-generic.sh</a> | <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-decree/SKILL.md">recon-decree</a></td><td>discovery (route, brief_kind, verbatim handoff), dossier</td></tr>
          <tr><td class="mono">repro/{repro.md, exhibits/*.png}</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-repro/SKILL.md">repro</a>, verified by <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/verify-repro.sh">verify-repro.sh</a></td><td>blocker detail packs, gate questions, Manual verification, PR "before" evidence</td></tr>
          <tr><td class="mono">repro/session/*</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/record-repro.sh">record-repro.sh</a> (proofshot bundle, finalized at stop)</td><td>verify-repro.sh log cross-check, delivery bundle (video), audit</td></tr>
          <tr><td class="mono">report/dossier.html</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-report/SKILL.md">recon-report</a></td><td>attached to the ticket on a BLOCKED/NEEDS_INFO or approved READY delivery path; published private on demand</td></tr>
          <tr><td class="mono">state/{state.yaml, canvas.html, publish-gate.yaml, artifact-url}</td><td><a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/derive-state.sh">derive-state.sh</a> · <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/render-state-canvas.sh">render-state-canvas.sh</a> · <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/scripts/record-publish-gate.sh">record-publish-gate.sh</a> · <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/skills/recon-state/SKILL.md">recon-state</a></td><td>living state: canonical next action + local canvas; the publish answer on the record; stable URL only on capable hosts, after a published answer</td></tr>
        </tbody>
      </table>
    </div>
  </section>

  <footer>
    <!-- coherence:version -->recon <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/.claude-plugin/plugin.json">v0.21.0</a> ·
    repo: <a href="https://github.com/AdCreative-ai/recon-plugin">AdCreative-ai/recon-plugin</a> ·
    machine spec: <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/docs/pipeline.md">pipeline.md</a> ·
    ADR: <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/recon/docs/decisions/0001-jira-rest-api-over-mcp.md">0001 — REST API over MCP</a><br>
    v0.7.0 design: <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/docs/plans/2026-07-31-recon-triage-comment-and-delivery-design.md">design doc</a> ·
    <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/docs/plans/2026-07-31-recon-triage-comment-and-delivery.md">implementation plan</a> ·
    <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/docs/plans/2026-07-31-spike-notes.md">spike evidence</a><br>
    improvement proposals: <a href="https://github.com/AdCreative-ai/recon-plugin/blob/master/docs/improvement-proposals/README.md">docs/improvement-proposals</a> ·
    links checked with <a href="https://github.com/lycheeverse/lychee">lychee</a>
  </footer>

</div>