npm - @dirtydishes/skills - Versions diffs - 0.1.1 - Mend

@dirtydishes/skills 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (51) hide show

package/skills/dirtyloops/examples/single-thread-subagent/docs/implementation/example-stream/loop-state.md ADDED Viewed

@@ -0,0 +1,28 @@
+# Loop State
+Canonical tracker: Beads epic `example-epic`
+This file is a compact resume aid only. If this file disagrees with Beads, Beads wins.
+Status: active
+Stream: `example-stream`
+Workflow: `single-thread-subagent`
+Current phase: none
+Current Beads issue: none
+Current PR: none
+Last completed phase: none
+Blocked: no
+## Phase Ledger
+| Phase | Beads Issue | Status | PR | Turn Doc |
+|---|---|---|---|---|
+| Foundation | `example-epic.1` | pending | | `turn-docs/01-foundation.md` |
+| Integration | `example-epic.2` | pending | | `turn-docs/02-integration.md` |

package/skills/dirtyloops/examples/single-thread-subagent/docs/implementation/example-stream/prompts/run-loop.md ADDED Viewed

@@ -0,0 +1,22 @@
+# Run Loop: Example Stream
+Workflow: `single-thread-subagent`
+Canonical tracker: Beads epic `example-epic`
+## Rules
+- Beads is canonical.
+- Do not create separate Codex worker or reviewer threads.
+- Continue phase-by-phase until the epic is complete, blocked, interrupted, or review/CI is unresolved.
+- The main thread owns integration, branch state, PR state, Beads updates, and closeout.
+- Use bounded selector/scout/slice/implementation-helper/reviewer/CI subagent swarms.
+- Use 8+ subagents by default for broad scout, slice, implementation-helper, and review work.
+- Run a slice planning swarm before broad implementation.
+- Reviewer agents use `thermo-nuclear-code-quality-review`.
+- Reviewer and CI verification agents own CI evidence.
+- Update the existing Markdown turn doc.
+## Start Prompt
+Run the Example Stream dirtyloop with workflow `single-thread-subagent`. Use Beads epic `example-epic` as canonical. Read `docs/implementation/example-stream/IMPLEMENT.md` and `docs/implementation/example-stream/loop-state.md`, select one next ready Beads child issue, use mass subagent swarms for selector/scout/slice/implementation-helper/review/CI work, synthesize the slice plan before broad implementation, integrate only the selected phase in the main thread, update the existing Markdown turn doc, update Beads first, then update `loop-state.md`. Continue to the next ready phase unless the epic is complete, blocked, interrupted, or review/CI is unresolved.

package/skills/dirtyloops/examples/single-thread-subagent/docs/implementation/example-stream/turn-docs/01-foundation.md ADDED Viewed

@@ -0,0 +1,32 @@
+# Phase 01 Turn Doc: Foundation
+Beads issue: `example-epic.1`
+Phase doc: `docs/implementation/example-stream/01-foundation.md`
+## Phase Selection
+Selected by the main coordinator after Beads showed `example-epic.1` ready.
+## Subagent Swarms
+- Selector swarm confirmed no dependencies.
+- Scout swarm checked old reporting behavior.
+- Slice planning swarm split implementation into `slice-model-boundary`, `slice-tests`, and `slice-adapter-cleanup`.
+- Implementation helper swarm prepared patch guidance for each slice.
+- Reviewer swarm used `thermo-nuclear-code-quality-review`.
+- CI verification swarm resolved gate evidence.
+## Implementation Log
+The main coordinator synthesized swarm reports, integrated the selected patches, resolved conflicts, and opened PR `#123`.
+## CI And Gates
+CI owner: reviewer/verification subagents
+Current CI state: `ci-green`
+## Closeout
+Coordinator updated Beads, refreshed the export, and selected the next ready phase because the loop runs until complete by default.

package/skills/dirtyloops/plan.html ADDED Viewed

@@ -0,0 +1,587 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>dirtyloops plan</title>
+  <style>
+    :root {
+      color-scheme: light;
+      --bg: oklch(0.98 0.01 250);
+      --ink: oklch(0.18 0.03 255);
+      --muted: oklch(0.42 0.03 255);
+      --surface: oklch(1 0 0);
+      --surface-2: oklch(0.95 0.015 250);
+      --line: oklch(0.86 0.02 250);
+      --accent: oklch(0.58 0.16 168);
+      --accent-2: oklch(0.55 0.17 28);
+      --accent-3: oklch(0.54 0.16 285);
+      --good: oklch(0.52 0.14 150);
+      --warn: oklch(0.62 0.15 70);
+      --bad: oklch(0.56 0.18 25);
+      --shadow: 0 8px 24px oklch(0.2 0.03 255 / 0.08);
+      font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    }
+    * {
+      box-sizing: border-box;
+    }
+    body {
+      margin: 0;
+      background:
+        radial-gradient(circle at top left, oklch(0.9 0.08 168 / 0.35), transparent 34rem),
+        linear-gradient(180deg, var(--bg), oklch(0.95 0.02 250));
+      color: var(--ink);
+      line-height: 1.55;
+    }
+    main {
+      width: min(1180px, calc(100% - 32px));
+      margin: 0 auto;
+      padding: 56px 0 72px;
+    }
+    header {
+      display: grid;
+      grid-template-columns: minmax(0, 1.4fr) minmax(280px, 0.6fr);
+      gap: 28px;
+      align-items: end;
+      margin-bottom: 36px;
+    }
+    h1,
+    h2,
+    h3 {
+      margin: 0;
+      letter-spacing: -0.025em;
+      text-wrap: balance;
+    }
+    h1 {
+      font-size: clamp(3rem, 8vw, 5.8rem);
+      line-height: 0.92;
+      max-width: 10ch;
+    }
+    h2 {
+      font-size: clamp(1.8rem, 4vw, 3rem);
+      line-height: 1;
+      margin-bottom: 16px;
+    }
+    h3 {
+      font-size: 1.05rem;
+      line-height: 1.2;
+      margin-bottom: 10px;
+    }
+    p {
+      margin: 0;
+      color: var(--muted);
+      max-width: 72ch;
+      text-wrap: pretty;
+    }
+    code {
+      font-family: "SFMono-Regular", Consolas, "Liberation Mono", monospace;
+      font-size: 0.92em;
+      background: oklch(0.93 0.015 250);
+      border: 1px solid var(--line);
+      border-radius: 6px;
+      padding: 0.08rem 0.28rem;
+      color: oklch(0.26 0.08 255);
+    }
+    pre {
+      margin: 0;
+      overflow: auto;
+      border: 1px solid var(--line);
+      background: oklch(0.16 0.03 255);
+      color: oklch(0.94 0.01 255);
+      border-radius: 12px;
+      padding: 16px;
+      box-shadow: var(--shadow);
+    }
+    pre code {
+      color: inherit;
+      background: transparent;
+      border: 0;
+      padding: 0;
+    }
+    a {
+      color: oklch(0.42 0.16 168);
+      text-decoration-thickness: 0.08em;
+      text-underline-offset: 0.18em;
+    }
+    .deck {
+      font-size: 1.15rem;
+      color: oklch(0.34 0.04 255);
+    }
+    .stat-strip {
+      display: grid;
+      grid-template-columns: repeat(3, 1fr);
+      gap: 10px;
+    }
+    .stat {
+      padding: 14px;
+      border: 1px solid var(--line);
+      border-radius: 12px;
+      background: oklch(1 0 0 / 0.78);
+    }
+    .stat strong {
+      display: block;
+      font-size: 1.5rem;
+      line-height: 1;
+      color: var(--ink);
+    }
+    .stat span {
+      color: var(--muted);
+      font-size: 0.9rem;
+    }
+    section {
+      margin-top: 42px;
+    }
+    .panel {
+      border: 1px solid var(--line);
+      border-radius: 16px;
+      background: oklch(1 0 0 / 0.84);
+      box-shadow: var(--shadow);
+      padding: 24px;
+    }
+    .grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+      gap: 16px;
+    }
+    .workflow {
+      display: grid;
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+      gap: 18px;
+    }
+    .workflow-card {
+      position: relative;
+      overflow: hidden;
+      border: 1px solid var(--line);
+      border-radius: 16px;
+      background: var(--surface);
+      padding: 22px;
+    }
+    .workflow-card::before {
+      content: "";
+      position: absolute;
+      inset: 0;
+      height: 5px;
+      background: var(--accent);
+    }
+    .workflow-card.callback::before {
+      background: var(--accent-3);
+    }
+    .chip-row {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 8px;
+      margin: 14px 0 0;
+    }
+    .chip {
+      display: inline-flex;
+      align-items: center;
+      min-height: 28px;
+      border-radius: 999px;
+      padding: 4px 10px;
+      background: var(--surface-2);
+      border: 1px solid var(--line);
+      color: oklch(0.3 0.04 255);
+      font-size: 0.86rem;
+      white-space: nowrap;
+    }
+    .flow {
+      display: grid;
+      gap: 10px;
+      margin-top: 16px;
+    }
+    .node {
+      display: grid;
+      grid-template-columns: 32px 1fr;
+      gap: 12px;
+      align-items: start;
+      border: 1px solid var(--line);
+      border-radius: 12px;
+      background: oklch(0.98 0.008 250);
+      padding: 12px;
+    }
+    .node b {
+      display: grid;
+      place-items: center;
+      width: 32px;
+      height: 32px;
+      border-radius: 999px;
+      background: oklch(0.88 0.08 168);
+      color: oklch(0.22 0.06 168);
+      font-size: 0.9rem;
+    }
+    .node.callback b {
+      background: oklch(0.88 0.08 285);
+      color: oklch(0.25 0.08 285);
+    }
+    .node strong {
+      display: block;
+      color: var(--ink);
+    }
+    .node span {
+      color: var(--muted);
+      font-size: 0.95rem;
+    }
+    .table-wrap {
+      overflow: auto;
+      border: 1px solid var(--line);
+      border-radius: 14px;
+      background: var(--surface);
+    }
+    table {
+      border-collapse: collapse;
+      min-width: 780px;
+      width: 100%;
+    }
+    th,
+    td {
+      padding: 14px;
+      border-bottom: 1px solid var(--line);
+      text-align: left;
+      vertical-align: top;
+    }
+    th {
+      color: var(--ink);
+      background: oklch(0.96 0.012 250);
+    }
+    td {
+      color: var(--muted);
+    }
+    tr:last-child td {
+      border-bottom: 0;
+    }
+    .callout {
+      border: 1px solid oklch(0.78 0.09 70);
+      background: oklch(0.96 0.04 70);
+      border-radius: 14px;
+      padding: 16px;
+    }
+    .callout strong {
+      color: oklch(0.35 0.09 70);
+    }
+    .paths {
+      display: grid;
+      gap: 10px;
+    }
+    .path {
+      display: flex;
+      gap: 10px;
+      align-items: center;
+      justify-content: space-between;
+      border: 1px solid var(--line);
+      background: var(--surface);
+      border-radius: 12px;
+      padding: 12px 14px;
+    }
+    .path span {
+      color: var(--muted);
+      font-size: 0.92rem;
+    }
+    .footer {
+      margin-top: 56px;
+      color: var(--muted);
+      font-size: 0.95rem;
+    }
+    @media (max-width: 800px) {
+      header,
+      .workflow {
+        grid-template-columns: 1fr;
+      }
+      h1 {
+        max-width: 100%;
+      }
+      .stat-strip {
+        grid-template-columns: 1fr;
+      }
+      .path {
+        align-items: flex-start;
+        flex-direction: column;
+      }
+    }
+    @media (prefers-reduced-motion: no-preference) {
+      .panel,
+      .workflow-card,
+      .path {
+        animation: enter 600ms cubic-bezier(.16, 1, .3, 1) both;
+      }
+      .workflow-card:nth-child(2) {
+        animation-delay: 80ms;
+      }
+      @keyframes enter {
+        from {
+          opacity: 0.001;
+          transform: translateY(12px);
+        }
+        to {
+          opacity: 1;
+          transform: translateY(0);
+        }
+      }
+    }
+  </style>
+</head>
+<body>
+  <main>
+    <header>
+      <div>
+        <h1>dirtyloops</h1>
+        <p class="deck">A Beads-canonical loop skill for turning finalized plans into executable phase streams, then running them with either one coordinator thread or the original callback-driven thread topology.</p>
+      </div>
+      <div class="stat-strip" aria-label="dirtyloops summary">
+        <div class="stat">
+          <strong>2</strong>
+          <span>workflow topologies</span>
+        </div>
+        <div class="stat">
+          <strong>5</strong>
+          <span>branches: help, create, run, inspect, closeout</span>
+        </div>
+        <div class="stat">
+          <strong>1</strong>
+          <span>canonical tracker: Beads</span>
+        </div>
+      </div>
+    </header>
+    <section class="panel">
+      <h2>Core Contract</h2>
+      <p>dirtyloops keeps status and ordering in Beads, stores execution context in phase docs, records phase history in one Markdown turn doc, pushes review through a strict quality skill, makes reviewer and CI agents own CI, and finishes with a storyboard HTML artifact.</p>
+      <div class="chip-row" aria-label="core contract tags">
+        <span class="chip">Beads canonical</span>
+        <span class="chip">one phase at a time</span>
+        <span class="chip">Markdown turn docs</span>
+        <span class="chip">subagent swarms</span>
+        <span class="chip">reviewer-owned CI</span>
+        <span class="chip">storyboard closeout</span>
+      </div>
+    </section>
+    <section>
+      <h2>Branches</h2>
+      <div class="grid">
+        <article class="panel">
+          <h3><code>$dirtyloops help</code></h3>
+          <p>Explains commands, workflow choice, required inputs, generated files, examples, and how to run a loop. This branch is read-only.</p>
+        </article>
+        <article class="panel">
+          <h3><code>$dirtyloops create</code></h3>
+          <p>Turns the finalized plan into a Beads epic, child phase issues, typed loop metadata, implementation docs, workflow prompts, schemas, loop state, and a paste-ready run prompt.</p>
+        </article>
+        <article class="panel">
+          <h3><code>$dirtyloops run</code></h3>
+          <p>Reads Beads, executes ready phases through the selected workflow, updates the existing turn docs and Beads, then continues until complete, blocked, interrupted, unresolved, or <code>--once</code>.</p>
+        </article>
+        <article class="panel">
+          <h3><code>$dirtyloops inspect</code></h3>
+          <p>Reads Beads and loop docs without mutation, then reports current phase, active PR or thread state, blockers, and the next safe action.</p>
+        </article>
+        <article class="panel">
+          <h3><code>$dirtyloops closeout</code></h3>
+          <p>Verifies every phase is resolved, then generates <code>storyboard-post-run-mm-dd-yyyy.html</code>. It uses impeccable when available and installs the SSR diff renderer when needed.</p>
+        </article>
+      </div>
+    </section>
+    <section>
+      <h2>Workflow Topologies</h2>
+      <div class="workflow">
+        <article class="workflow-card">
+          <h3>single-thread-subagent</h3>
+          <p>One visible coordinator owns loop state, integration, PRs, and closeout. Mass subagent swarms handle scouting, slice planning, implementation help, review, and CI.</p>
+          <div class="flow">
+            <div class="node">
+              <b>1</b>
+              <div><strong>Coordinator reads Beads</strong><span>Selects one ready phase from the epic.</span></div>
+            </div>
+            <div class="node">
+              <b>2</b>
+              <div><strong>Mass swarms split the phase</strong><span>Scout, slice, implementation-helper, reviewer, and CI agents return compact reports.</span></div>
+            </div>
+            <div class="node">
+              <b>3</b>
+              <div><strong>Coordinator integrates</strong><span>Broad solo implementation is a violation; branch, PR, Beads updates, and closeout stay with the coordinator.</span></div>
+            </div>
+          </div>
+        </article>
+        <article class="workflow-card callback">
+          <h3>orchestrator-callback</h3>
+          <p>The original loop shape. A main orchestrator creates standard-speed implementation and review threads with concrete callback targets, then advances after validated callbacks.</p>
+          <div class="flow">
+            <div class="node callback">
+              <b>1</b>
+              <div><strong>Orchestrator selects phase</strong><span>Selector subagent reads Beads and linked phase docs.</span></div>
+            </div>
+            <div class="node callback">
+              <b>2</b>
+              <div><strong>Implementation thread opens PR</strong><span>Worker uses the exact callback id, updates the turn doc, and calls back once.</span></div>
+            </div>
+            <div class="node callback">
+              <b>3</b>
+              <div><strong>Review thread owns CI</strong><span>Reviewer uses thermo-nuclear review, handles CI/repairs, then echoes the callback id.</span></div>
+            </div>
+          </div>
+        </article>
+      </div>
+    </section>
+    <section>
+      <h2>Authority Matrix</h2>
+      <div class="table-wrap">
+        <table>
+          <thead>
+            <tr>
+              <th>Responsibility</th>
+              <th>single-thread-subagent</th>
+              <th>orchestrator-callback</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr>
+              <td>Phase selection</td>
+              <td>Main coordinator with selector subagents.</td>
+              <td>Orchestrator with selector subagent.</td>
+            </tr>
+            <tr>
+              <td>Implementation</td>
+              <td>Mass subagents split and assist; coordinator integrates glue, conflicts, and final repairs.</td>
+              <td>Implementation thread created by orchestrator with exact callback target and standard defaults.</td>
+            </tr>
+            <tr>
+              <td>Review</td>
+              <td>Reviewer subagents report to the coordinator.</td>
+              <td>Review thread created by orchestrator; reviewer subagents report inside that thread.</td>
+            </tr>
+            <tr>
+              <td>CI</td>
+              <td>Reviewer and CI verification subagents own evidence.</td>
+              <td>Review thread owns CI through reviewer and verification subagents.</td>
+            </tr>
+            <tr>
+              <td>Beads closeout</td>
+              <td>Main coordinator updates Beads first, then loop-state.</td>
+              <td>Orchestrator updates Beads after implementation/review callbacks.</td>
+            </tr>
+            <tr>
+              <td>Next phase</td>
+              <td>Main coordinator continues after closeout unless complete, blocked, interrupted, unresolved, or <code>--once</code>.</td>
+              <td>Orchestrator launches the next selector after closeout unless complete, blocked, interrupted, unresolved, or <code>--once</code>.</td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    </section>
+    <section class="panel">
+      <h2>Review And CI Gate</h2>
+      <p>Reviewer agents must use <code>thermo-nuclear-code-quality-review</code>. CI is not an orchestrator afterthought: reviewer and CI verification agents own inspection, diagnosis, repairs, reruns, and evidence.</p>
+      <div class="chip-row">
+        <span class="chip">ci-green</span>
+        <span class="chip">ci-repaired-and-green</span>
+        <span class="chip">ci-unavailable-with-evidence</span>
+        <span class="chip">ci-blocked-with-cause</span>
+      </div>
+    </section>
+    <section class="panel">
+      <h2>Post-Run Storyboard</h2>
+      <p>When the epic is complete, dirtyloops generates <code>storyboard-post-run-mm-dd-yyyy.html</code> from every Markdown turn doc. The document tells the implementation story phase by phase, including discoveries, repairs, review moments, PRs, CI evidence, and follow-ups.</p>
+      <div class="callout">
+        <strong>Required:</strong> closeout installs <code>@pierre/diffs</code> in the target repo when missing, and every diff block is rendered with <code>@pierre/diffs/ssr</code>. Use <code>impeccable</code> when available; if it is missing, complete the storyboard and note that it was skipped.
+      </div>
+    </section>
+    <section>
+      <h2>Skill Files</h2>
+      <div class="paths">
+        <div class="path">
+          <code>SKILL.md</code>
+          <span>Router and checkable branch steps.</span>
+        </div>
+        <div class="path">
+          <code>references/</code>
+          <span>Shared rules, branch instructions, and workflow definitions.</span>
+        </div>
+        <div class="path">
+          <code>templates/</code>
+          <span>Reusable generated-file templates for loop creation.</span>
+        </div>
+        <div class="path">
+          <code>examples/</code>
+          <span>Concrete output shapes for both workflows.</span>
+        </div>
+        <div class="path">
+          <code>schemas/</code>
+          <span>Callback and swarm report schemas.</span>
+        </div>
+      </div>
+    </section>
+    <section>
+      <h2>Example Invocation</h2>
+      <pre><code>$dirtyloops create orchestrator-callback from the finalized plan above
+Repo: .
+Stream slug: example-stream
+Epic title: Example stream migration
+Run policy: until complete; use --once only for one-shot operation
+Thread defaults: implementation standard, review standard
+Quality gates: bun test, bun run typecheck, targeted browser QA
+Branch/PR policy: one active implementation PR at a time</code></pre>
+    </section>
+    <p class="footer">dirtyloops is intentionally user-invoked: you choose when to spend attention on a durable loop, and the skill keeps the process predictable once invoked.</p>
+  </main>
+</body>
+</html>