{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "factory-flow-recipes",
  "slug": "flow-recipes",
  "title": "Reusable flow and skill recipes",
  "summary": "Complete small contracts for code review, onboarding, test repair, changelogs, PR descriptions, pane-aware standups, and preference capture.",
  "category": "Execution",
  "tags": [
    "flows",
    "skills",
    "prompts"
  ],
  "sources": [
    {
      "label": "Published mdflow skills",
      "url": "https://walnut-virtue-6d22.here.now/"
    },
    {
      "label": "skills/fixit/SKILL.md",
      "url": "https://shiny-bloom-f8hv.here.now/skills/fixit/SKILL.md"
    },
    {
      "label": "flows/this-or-that.md",
      "url": "https://walnut-virtue-6d22.here.now/flows/this-or-that.md"
    },
    {
      "label": "flows/workshop-standup.claude.md",
      "url": "https://walnut-virtue-6d22.here.now/flows/workshop-standup.claude.md"
    },
    {
      "label": "skills/pr-description/SKILL.md",
      "url": "https://walnut-virtue-6d22.here.now/skills/pr-description/SKILL.md"
    },
    {
      "label": "skills/onboard/SKILL.md",
      "url": "https://walnut-virtue-6d22.here.now/skills/onboard/SKILL.md"
    },
    {
      "label": "skills/fix-tests/SKILL.md",
      "url": "https://walnut-virtue-6d22.here.now/skills/fix-tests/SKILL.md"
    },
    {
      "label": "skills/changelog/SKILL.md",
      "url": "https://walnut-virtue-6d22.here.now/skills/changelog/SKILL.md"
    },
    {
      "label": "skills/review/SKILL.md",
      "url": "https://walnut-virtue-6d22.here.now/skills/review/SKILL.md"
    },
    {
      "label": "skills/workshop-standup/SKILL.md",
      "url": "https://walnut-virtue-6d22.here.now/skills/workshop-standup/SKILL.md"
    },
    {
      "label": "skills/this-or-that/SKILL.md",
      "url": "https://gentle-lasso-9d5n.here.now/skills/this-or-that/SKILL.md"
    }
  ],
  "sourceUnits": [
    "04-prompt-builder/skills/fixit/SKILL.md",
    "05-mdflow/flows/this-or-that.md",
    "05-mdflow/flows/workshop-standup.claude.md",
    "05-mdflow/skills/pr-description/SKILL.md",
    "05-mdflow/skills/onboard/SKILL.md",
    "05-mdflow/skills/fix-tests/SKILL.md",
    "05-mdflow/skills/changelog/SKILL.md",
    "05-mdflow/skills/review/SKILL.md",
    "05-mdflow/skills/workshop-standup/SKILL.md",
    "10-this-or-that/skills/this-or-that/SKILL.md",
    "agenda/flows/workshop.md#dispatcher"
  ],
  "collection": "factory",
  "categoryId": "execution",
  "wordCount": 2829,
  "url": "/topics/factory-flow-recipes/",
  "markdownUrl": "/markdown/factory-flow-recipes.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/factory-flow-recipes.json",
  "headings": [
    {
      "id": "skills-fixit-skill-md",
      "text": "skills/fixit/SKILL.md",
      "level": 2
    },
    {
      "id": "fixit-expert-debugger",
      "text": "fixit — expert debugger",
      "level": 2
    },
    {
      "id": "steps",
      "text": "Steps",
      "level": 2
    },
    {
      "id": "flows-this-or-that-md",
      "text": "flows/this-or-that.md",
      "level": 2
    },
    {
      "id": "the-process-exactly-as-proven-in-authoring-lab-and-07-variations-template-lab",
      "text": "The process (exactly as proven in `authoring-lab/` and `07-variations/template-lab/`)",
      "level": 2
    },
    {
      "id": "accumulated-taste-record-injected-fresh-each-run-read-before-generating-options",
      "text": "Accumulated taste record (injected fresh each run — read before generating options)",
      "level": 2
    },
    {
      "id": "flows-workshop-standup-claude-md",
      "text": "flows/workshop-standup.claude.md",
      "level": 2
    },
    {
      "id": "repo-state-git",
      "text": "Repo state (git)",
      "level": 2
    },
    {
      "id": "terminal-workspace-herdr-panes",
      "text": "Terminal workspace (herdr panes)",
      "level": 2
    },
    {
      "id": "open-tickets-linear",
      "text": "Open tickets (linear)",
      "level": 2
    },
    {
      "id": "your-job",
      "text": "Your job",
      "level": 2
    },
    {
      "id": "skills-pr-description-skill-md",
      "text": "skills/pr-description/SKILL.md",
      "level": 2
    },
    {
      "id": "pr-description-write-a-pr-description-for-the-current-branch",
      "text": "pr-description — write a PR description for the current branch",
      "level": 2
    },
    {
      "id": "steps-2",
      "text": "Steps",
      "level": 2
    },
    {
      "id": "skills-onboard-skill-md",
      "text": "skills/onboard/SKILL.md",
      "level": 2
    },
    {
      "id": "onboard-explain-this-codebase-to-a-newcomer",
      "text": "onboard — explain this codebase to a newcomer",
      "level": 2
    },
    {
      "id": "your-job-2",
      "text": "Your job",
      "level": 2
    },
    {
      "id": "skills-fix-tests-skill-md",
      "text": "skills/fix-tests/SKILL.md",
      "level": 2
    },
    {
      "id": "fix-tests-run-the-test-suite-and-fix-what-fails",
      "text": "fix-tests — run the test suite and fix what fails",
      "level": 2
    },
    {
      "id": "steps-3",
      "text": "Steps",
      "level": 2
    },
    {
      "id": "skills-changelog-skill-md",
      "text": "skills/changelog/SKILL.md",
      "level": 2
    },
    {
      "id": "changelog-draft-a-changelog-entry-from-recent-commits",
      "text": "changelog — draft a changelog entry from recent commits",
      "level": 2
    },
    {
      "id": "steps-4",
      "text": "Steps",
      "level": 2
    },
    {
      "id": "skills-review-skill-md",
      "text": "skills/review/SKILL.md",
      "level": 2
    },
    {
      "id": "review-review-staged-changes-for-bugs",
      "text": "review — review staged changes for bugs",
      "level": 2
    },
    {
      "id": "steps-5",
      "text": "Steps",
      "level": 2
    },
    {
      "id": "skills-workshop-standup-skill-md",
      "text": "skills/workshop-standup/SKILL.md",
      "level": 2
    },
    {
      "id": "workshop-standup-pane-aware-standup",
      "text": "workshop-standup — pane-aware standup",
      "level": 2
    },
    {
      "id": "gather-context-first-run-these-tolerate-absence",
      "text": "Gather context first (run these, tolerate absence)",
      "level": 2
    },
    {
      "id": "your-job-3",
      "text": "Your job",
      "level": 2
    },
    {
      "id": "skills-this-or-that-skill-md",
      "text": "skills/this-or-that/SKILL.md",
      "level": 2
    },
    {
      "id": "this-or-that-rlhf-where-the-user-is-the-reward-model",
      "text": "this-or-that — RLHF where the user is the reward model",
      "level": 2
    },
    {
      "id": "the-harness-3-files-get-them-first",
      "text": "The harness (3 files, get them first)",
      "level": 2
    },
    {
      "id": "running-a-round",
      "text": "Running a round",
      "level": 2
    },
    {
      "id": "vote-record-schema-what-lands-in-votes-jsonl",
      "text": "Vote record schema (what lands in votes.jsonl)",
      "level": 2
    },
    {
      "id": "proven-results-evidence-this-works",
      "text": "Proven results (evidence this works)",
      "level": 2
    },
    {
      "id": "whole-workshop-task-dispatcher",
      "text": "Whole-workshop task dispatcher",
      "level": 2
    },
    {
      "id": "task",
      "text": "Task",
      "level": 2
    },
    {
      "id": "agenda-machine-readable-index-of-the-whole-workshop",
      "text": "Agenda — machine-readable index of the whole workshop",
      "level": 2
    },
    {
      "id": "00-how-agentic-work-is-evolving",
      "text": "00 · How Agentic Work is Evolving",
      "level": 2
    },
    {
      "id": "01-configuring-your-environment",
      "text": "01 · Configuring your environment",
      "level": 2
    },
    {
      "id": "02-custom-zsh-functions",
      "text": "02 · Custom zsh functions",
      "level": 2
    },
    {
      "id": "03-prompting-with-images",
      "text": "03 · Prompting with Images",
      "level": 2
    },
    {
      "id": "04-prompt-builder",
      "text": "04 · Prompt Builder",
      "level": 2
    },
    {
      "id": "05-mdflow",
      "text": "05 · mdflow",
      "level": 2
    },
    {
      "id": "06-why-pi-herdr-and-ghostty",
      "text": "06 · Why Pi, Herdr, and Ghostty",
      "level": 2
    },
    {
      "id": "07-variations-9x-image-mockups",
      "text": "07 · Variations (9x image mockups)",
      "level": 2
    },
    {
      "id": "10-this-or-that-rlhf-for-your-taste",
      "text": "10 · This or That — RLHF for Your Taste",
      "level": 2
    },
    {
      "id": "08-maximum-intelligence-and-video",
      "text": "08 · Maximum Intelligence and Video",
      "level": 2
    },
    {
      "id": "09-debugging-with-markers",
      "text": "09 · Debugging with Markers",
      "level": 2
    },
    {
      "id": "references-resources-tool-alternatives",
      "text": "References & Resources — tool alternatives",
      "level": 2
    }
  ],
  "markdown": "# Reusable flow and skill recipes\n\nComplete small contracts for code review, onboarding, test repair, changelogs, PR descriptions, pane-aware standups, and preference capture.\n\n## skills/fixit/SKILL.md\n\n```yaml\nname: fixit\ndescription: Expert debugger — take a bug report, reproduce it, find the root cause, fix it, and prove the fix. Use when the user pastes a bug report, error output, or stack trace and wants it diagnosed and fixed.\n```\n\n## fixit — expert debugger\n\nSkill twin of the `fixit` wrapper from the prompt-builder guide\n(https://shiny-bloom-f8hv.here.now/) — the same job in its third form:\nzsh wrapper → mdflow flow (`flows/fixit.codex.md`) → agent skill.\n\nYou're an expert debugger. The user's message is the bug report.\n\n## Steps\n\n1. Restate the bug in one sentence so a wrong reading dies early.\n2. Reproduce it — run the failing command, test, or flow and capture the\n   actual output. If you can't reproduce, say exactly what you tried and stop.\n3. Find the root cause. Read the code on the failure path; don't patch\n   symptoms.\n4. Fix it, minimally.\n5. Prove it — re-run the reproduction and show the before/after.\n\nIf the report is too vague to reproduce (no steps, no error, no location),\nask for the missing piece instead of guessing.\n\n## flows/this-or-that.md\n\n```yaml\ndescription: Run one this-or-that Elo voting round — generate structurally distinct options over a constant subject, stand up the duel harness, wait for votes, then bank the taste as explicit rules\n_inputs: [_question, _subject]\n_interactive: true\n```\n\nYou are running one round of the **this-or-that decision flow**: the user can't\narticulate their taste, but they can pick between two things all day. Turn the\nquestion below into an Elo-voted decision with a durable record.\n\n**Question to decide:** {{ _question }}\n\n**Subject / content source (hold constant across every option):** {{ _subject }}\n\n## The process (exactly as proven in `authoring-lab/` and `07-variations/template-lab/`)\n\n1. **Frame the axis.** Name the ONE thing options vary on (theme, format, copy,\n   API shape). Everything else — subject content, visual theme — is held constant\n   so votes measure only that axis.\n2. **Scaffold the lab.** Create `<slug>-lab/` at the repo root. Copy `compare.html`\n   and `server.py` **verbatim** from `10-this-or-that/kit/`. Write `options.json`\n   (`{title, modes: true, options: [{id, name, src}]}`). Write one shared base\n   stylesheet all options link, so theme stays constant; support\n   `html[data-mode=\"light|dark\"]` (light default, `prefers-color-scheme` +\n   `data-mode` override) — the harness stamps it and records the mode on every vote.\n3. **Generate 9–13 structurally distinct options.** Same subject, different\n   approach; if two could be confused at arm's length, replace one. Include the\n   incumbent as a control when one exists. Write one exemplar option yourself,\n   then fan out parallel subagents, each authoring 2–3 options from one tight\n   shared brief (subject digest + format rules + per-option spec + the exemplar\n   path). Real content only — never lorem ipsum, never invented names.\n4. **QA before handing over.** Every file HTTP 200 through `server.py`; grep-audit\n   (zero external requests, no absolute home paths, no secrets); render both light\n   and dark; POST a smoke vote to `/vote`, confirm it lands in `votes.jsonl`,\n   remove it.\n5. **Hand over and get out of the way.** Start `python3 server.py <port>` in the\n   background and give the user the `compare.html` URL. Controls: ←/→ pick ·\n   ↓ both bad · `d` flips light/dark · `s` skip · `f` finish · the note field\n   saves with each vote (tell the user: one note outweighs ten votes).\n6. **When the user says \"done\":** read `votes.jsonl` — ranking, per-mode W-L\n   splits, `both_bad` lines, and especially notes. State the user's taste as\n   explicit, quotable rules backed by vote evidence (head-to-heads, splits,\n   quoted notes). A user note that makes a decision IS the decision.\n7. **Bank it.** Archive as `votes-round<N>.jsonl`, write `RESULTS.md` (standings\n   table, the decision with quoted evidence, taste rules, ship plan), update\n   agent memory so it is never re-litigated. Then propose round 2 from the\n   winners — or ship.\n\n## Accumulated taste record (injected fresh each run — read before generating options)\n\n@../authoring-lab/RESULTS.md\n\n@../07-variations/template-lab/RESULTS.md\n\n## flows/workshop-standup.claude.md\n\n```yaml\ndescription: pane-aware standup — agent starts already knowing git, panes, and tickets\nmodel: sonnet\nprint: true\n```\n\nYou are a standup assistant. Everything below was captured at prompt-build\ntime, BEFORE you started — do not re-run these commands.\n\n## Repo state (git)\n\n!`git status --short --branch`\n\n!`git log --oneline -5 2>/dev/null || echo \"(no commits yet)\"`\n\n## Terminal workspace (herdr panes)\n\n!`herdr api snapshot 2>/dev/null | head -40 || echo \"(herdr not running)\"`\n\n## Open tickets (linear)\n\n!`echo \"(placeholder: linear 'list my in-progress issues' — sandboxed agent call)\"`\n\n## Your job\n\nFrom the preloaded context only:\n1. Say what I'm in the middle of (branch, dirty files, visible panes).\n2. Flag anything that looks stalled or contradictory.\n3. Suggest the single next action, one sentence.\n\n## skills/pr-description/SKILL.md\n\n```yaml\nname: pr-description\ndescription: Write a pull-request description for the current branch — what changed, why, and how to verify it, under 200 words, leading with the outcome. Use when the user says \"write the PR description\", \"describe this branch\", or is about to open a pull request.\n```\n\n## pr-description — write a PR description for the current branch\n\nSkill twin of the mdflow flow `flows/pr-description.md`\n(https://walnut-virtue-6d22.here.now/). The flow preloads the branch history\nat prompt-build time; this skill has you fetch it yourself.\n\n## Steps\n\n1. Gather the branch state (fall back if there's no `main`):\n\n```bash\ngit log --oneline main..HEAD 2>/dev/null || git log --oneline -10\ngit diff --stat main...HEAD 2>/dev/null || git diff --stat HEAD~5\n```\n\n2. Write the pull-request description: what changed, why, and how to verify\n   it. Lead with the outcome. Keep it under 200 words.\n\n## skills/onboard/SKILL.md\n\n```yaml\nname: onboard\ndescription: Explain the current codebase to a newcomer — what it does, how it's laid out, where the core logic lives, and the three files to read first. Use when the user says \"onboard me\", \"explain this codebase\", \"I'm new here\", or asks for a project orientation.\n```\n\n## onboard — explain this codebase to a newcomer\n\nSkill twin of the mdflow flow `flows/onboard.md`\n(https://walnut-virtue-6d22.here.now/).\n\n## Your job\n\nExplore the repository, then explain it to someone joining the project today:\n\n1. What it does — the one-paragraph purpose.\n2. How it's laid out — the directory map that matters, not every folder.\n3. Where the core logic lives.\n4. The three files to read first, with one line each on why.\n\nIf the user names a focus area (e.g. \"onboard me, I care about the billing\ncode\"), weight the whole answer toward it.\n\n## skills/fix-tests/SKILL.md\n\n```yaml\nname: fix-tests\ndescription: Run the project's test suite and fix whatever fails — root cause in the code, not the test, unless the test is genuinely wrong. Use when the user says \"fix the tests\", \"make the suite green\", or tests are failing and they want them repaired.\n```\n\n## fix-tests — run the test suite and fix what fails\n\nSkill twin of the mdflow flow `flows/fix-tests.md`\n(https://walnut-virtue-6d22.here.now/).\n\n## Steps\n\n1. Find and run this project's test suite (check package.json scripts,\n   Makefile, CI config — whatever the project actually uses).\n2. If everything passes, say so and stop.\n3. If anything fails: show the failing output first, then find the root cause\n   and fix it — the code, not the test, unless the test is genuinely wrong.\n4. Re-run the suite to prove the fix. Report what failed, why, and what\n   changed.\n\n## skills/changelog/SKILL.md\n\n```yaml\nname: changelog\ndescription: Draft a concise changelog entry from recent commits, grouped by feature/fix/chore and written for users. Use when the user asks to \"draft a changelog\", \"write release notes\", or summarize unreleased changes.\n```\n\n## changelog — draft a changelog entry from recent commits\n\nSkill twin of the mdflow flow `flows/changelog.md`\n(https://walnut-virtue-6d22.here.now/). The flow preloads the git history at\nprompt-build time; this skill has you fetch it yourself.\n\n## Steps\n\n1. Gather the recent history:\n\n```bash\ngit log --oneline -30\ngit diff --stat HEAD~10 2>/dev/null || true\n```\n\n2. Draft a concise changelog entry for the unreleased changes. Group by\n   feature/fix/chore. Write for users, not committers — describe what changed\n   for them, not the internals. No commit hashes.\n\n## skills/review/SKILL.md\n\n```yaml\nname: review\ndescription: Review staged git changes for bugs — terse findings with file:line citations. Use when the user says \"review my staged changes\", \"check this diff before I commit\", or wants a quick bug pass over what's about to be committed.\n```\n\n## review — review staged changes for bugs\n\nSkill twin of the mdflow flow `flows/review.md`\n(https://walnut-virtue-6d22.here.now/). The flow preloads the diff at\nprompt-build time; this skill has you fetch it yourself.\n\n## Steps\n\n1. Run `git diff --cached`. If it's empty, say so and stop (offer to review\n   the unstaged diff instead — but only if the user asks).\n2. Review the diff for bugs: logic errors, off-by-ones, missed edge cases,\n   broken contracts, unintended behavior changes.\n\nBe terse. Cite every finding as `file:line`. Bugs only — no style notes.\n\n## skills/workshop-standup/SKILL.md\n\n```yaml\nname: workshop-standup\ndescription: Pane-aware standup — report what the user is in the middle of from git state, visible terminal panes, and open tickets, then suggest the single next action. Use when the user says \"standup\", \"where was I\", \"what am I in the middle of\", or starts a session cold and wants their working state summarized.\n```\n\n## workshop-standup — pane-aware standup\n\nSkill twin of the mdflow flow `flows/workshop-standup.claude.md`\n(https://walnut-virtue-6d22.here.now/). The flow preloads this context at\nprompt-build time before the agent starts; this skill has you gather the same\ncontext with tool calls, then do the same job.\n\n## Gather context first (run these, tolerate absence)\n\n```bash\ngit status --short --branch\ngit log --oneline -5 2>/dev/null || echo \"(no commits yet)\"\nherdr api snapshot 2>/dev/null | head -40 || echo \"(herdr not running)\"\n```\n\nIf the user has a ticket CLI (e.g. `linear`), also list their in-progress\nissues; otherwise skip tickets without comment.\n\n## Your job\n\nFrom the gathered context only:\n\n1. Say what the user is in the middle of (branch, dirty files, visible panes).\n2. Flag anything that looks stalled or contradictory.\n3. Suggest the single next action, one sentence.\n\nDo not start doing the work — this is a standup, not a work session.\n\n## skills/this-or-that/SKILL.md\n\n```yaml\nname: this-or-that\ndescription: Run a this-or-that Elo voting round to decide anything with more than one plausible answer (design, format, copy, API shape, naming). Generates structurally distinct options over a constant subject, stands up a local duel harness the user arrow-keys through, then reads votes.jsonl back as explicit taste rules and a durable RESULTS.md record. Use when the user says \"this or that\", \"spin up options to vote on\", \"help me decide between\", \"RLHF my preferences\", or asks you to learn their taste instead of describing it.\n```\n\n## this-or-that — RLHF where the user is the reward model\n\nThe user can't articulate their taste, but they can pick between two things all\nday. This skill turns any multi-answer decision into an Elo-voted record that\nyou read back as explicit rules — so it is decided once, with evidence, and\nnever re-litigated.\n\nNot for decisions with a conventional default or a single verifiable answer —\njust decide those. Use this when taste is the deciding factor.\n\n## The harness (3 files, get them first)\n\n- In John's workshop repo: copy `compare.html` + `server.py` verbatim from\n  `10-this-or-that/kit/`.\n- Anywhere else: `curl -sO https://gentle-lasso-9d5n.here.now/kit/compare.html`\n  and the same for `server.py` (published copies of the kit; also see that\n  site's write-up).\n\n`compare.html` reads `options.json` (`{title, modes, options: [{id, name, src}]}`),\nruns Elo-paired duels in side-by-side iframes (`src` is anything an iframe can\nrender), and POSTs every vote to `/vote`. `server.py` (default port 8477) serves\nthe directory and appends vote bodies to `votes.jsonl`. Set `\"modes\": true` to add\nthe light/dark axis: the harness stamps `data-mode` on each option's `<html>` and\nrecords `ui_mode` on every vote — option pages must style both modes.\n\n## Running a round\n\n1. **Frame the axis.** Name the ONE thing options vary on. Hold everything else\n   constant — same subject content in every option, one shared stylesheet — so\n   votes measure only that axis. Read any prior RESULTS.md / vote archives\n   before generating: accumulated taste constrains the option space.\n2. **Scaffold** `<slug>-lab/`: harness files, `options.json`, shared base CSS\n   (with `html[data-mode]` light/dark support when `modes` is on), `options/`\n   pages.\n3. **Generate 9–13 structurally distinct options.** If two could be confused at\n   arm's length, replace one — near-clones waste votes (a proven failure: a\n   refinement round was rejected wholesale as \"WAAAY too similar\"). Include the\n   incumbent as a control when one exists. Author one exemplar yourself, then\n   fan out parallel subagents, each writing 2–3 options from one tight shared\n   brief: subject digest, format rules, per-option spec, exemplar path. Real\n   content only — no lorem ipsum, no invented names.\n4. **QA before handing over:** every file HTTP 200 through `server.py`;\n   grep-audit for external requests, absolute home paths, secrets (none\n   allowed); check both light and dark actually render; POST a smoke vote,\n   confirm it appends to `votes.jsonl`, remove it.\n5. **Hand over and get out of the way.** Start the server in the background,\n   give the user the `compare.html` URL and the controls (←/→ pick · ↓ both\n   bad · `d` flip mode · `s` skip · `f` finish · per-vote note field). Tell\n   them: one note outweighs ten votes. Do not hover; wait for \"done\".\n6. **Analyze on \"done\".** Read `votes.jsonl`: final standings, per-mode W-L\n   splits, `both_bad` lines, head-to-head results, and every note. State the\n   user's taste as explicit, quotable rules with evidence. A note that makes a\n   decision IS the decision (round 1 of the authoring lab ended with \"use both\n   in separate pages\" — the ranking alone would have missed it).\n7. **Bank it.** Archive `votes-round<N>.jsonl`, write `RESULTS.md` (standings,\n   the decision with quoted evidence, taste rules, ship plan), update agent\n   memory. Propose round 2 from the winners — or ship. A voted winner isn't\n   done until it's shipped into the canonical templates/config it decides.\n\n## Vote record schema (what lands in votes.jsonl)\n\nEach duel vote: `{mode: \"elo\", vote, left, right, winner, loser, elo: {id: score},\nnote, ui_mode?, toggled?, lab, ts}`. Both-bad: `result: \"both_bad\"` instead of\nwinner/loser. Finish: `{mode: \"final\", votes, table: [{id, name, elo, games,\nlight?, dark?}]}`. Record every axis the user cares about as a field on every\nvote — splits you didn't record are insights lost.\n\n## Proven results (evidence this works)\n\n- 3 rounds / 130 votes chose the Instrument Panel theme for all 11 workshop\n  sites (`07-variations/template-lab/RESULTS.md`).\n- 27 votes decided workshop guides are authored as Session Replay + Socratic\n  Dialogue page pairs (`authoring-lab/RESULTS.md`).\n- In the workshop repo, `flows/this-or-that.md` runs this entire loop as an\n  mdflow flow: `md flows/this-or-that.md --_question \"...\" --_subject \"...\"`.\n\n## Whole-workshop task dispatcher\n\n```yaml\ndescription: Load the complete Agentic Software Factory workshop (John Lindquist, the recorded snapshot) — every section's machine guide, Session Replay, and Socratic Dialogue, fetched live — then perform the task.\n_inputs: [_task]\n```\n\nYou are loaded with the complete \"Agentic Software Factory\" workshop (John Lindquist, the recorded snapshot): eleven hands-on sections plus the agenda and a references/resources index. Each section appears three ways below:\n\n- **Machine guide** (`agent.md`) — the section's brief, its money artifact (prompt / script / config / kit) verbatim, and step-by-step replication instructions written for an agent to execute.\n- **Session Replay** — how the section was actually built, beat by beat, including wrong turns.\n- **Socratic Dialogue** — the reasoning and trade-offs behind the section's decisions.\n\nEverything is fetched live from the published sites at run time, so this context is always current. When a guide references a downloadable attachment (files under `skills/`, `flows/`, or zsh files at a site root), fetch it from that section's site root; `.md` attachments need `?raw` appended for the raw file (the bare URL serves an HTML viewer).\n\nGround every answer in this material. Prefer the machine guides for replication steps, the replays for \"how it really went\", and the dialogues for \"why this way\".\n\n## Task\n\n{{ _task }}\n\n## Agenda — machine-readable index of the whole workshop\n\n@https://ember-bodhi-scrr.here.now/agent.md?raw\n\n## 00 · How Agentic Work is Evolving\n\n@https://hallowed-entry-96xv.here.now/agent.md?raw\n\n!`curl -sf https://hallowed-entry-96xv.here.now/replay.html`\n\n!`curl -sf https://hallowed-entry-96xv.here.now/dialogue.html`\n\n## 01 · Configuring your environment\n\n@https://polite-ravine-6v8g.here.now/agent.md?raw\n\n!`curl -sf https://polite-ravine-6v8g.here.now/replay.html`\n\n!`curl -sf https://polite-ravine-6v8g.here.now/dialogue.html`\n\n## 02 · Custom zsh functions\n\n@https://sacred-ritual-w7as.here.now/agent.md?raw\n\n!`curl -sf https://sacred-ritual-w7as.here.now/replay.html`\n\n!`curl -sf https://sacred-ritual-w7as.here.now/dialogue.html`\n\n## 03 · Prompting with Images\n\n@https://amber-willow-n64j.here.now/agent.md?raw\n\n!`curl -sf https://amber-willow-n64j.here.now/replay.html`\n\n!`curl -sf https://amber-willow-n64j.here.now/dialogue.html`\n\n## 04 · Prompt Builder\n\n@https://shiny-bloom-f8hv.here.now/agent.md?raw\n\n!`curl -sf https://shiny-bloom-f8hv.here.now/replay.html`\n\n!`curl -sf https://shiny-bloom-f8hv.here.now/dialogue.html`\n\n## 05 · mdflow\n\n@https://walnut-virtue-6d22.here.now/agent.md?raw\n\n!`curl -sf https://walnut-virtue-6d22.here.now/replay.html`\n\n!`curl -sf https://walnut-virtue-6d22.here.now/dialogue.html`\n\n## 06 · Why Pi, Herdr, and Ghostty\n\n@https://summit-inlet-kxyf.here.now/agent.md?raw\n\n!`curl -sf https://summit-inlet-kxyf.here.now/replay.html`\n\n!`curl -sf https://summit-inlet-kxyf.here.now/dialogue.html`\n\n## 07 · Variations (9x image mockups)\n\n@https://indigo-kayak-2zw8.here.now/agent.md?raw\n\n!`curl -sf https://indigo-kayak-2zw8.here.now/replay.html`\n\n!`curl -sf https://indigo-kayak-2zw8.here.now/dialogue.html`\n\n## 10 · This or That — RLHF for Your Taste\n\n@https://gentle-lasso-9d5n.here.now/agent.md?raw\n\n!`curl -sf https://gentle-lasso-9d5n.here.now/replay.html`\n\n!`curl -sf https://gentle-lasso-9d5n.here.now/dialogue.html`\n\n## 08 · Maximum Intelligence and Video\n\n@https://shiny-rosette-m6zy.here.now/agent.md?raw\n\n!`curl -sf https://shiny-rosette-m6zy.here.now/replay.html`\n\n!`curl -sf https://shiny-rosette-m6zy.here.now/dialogue.html`\n\n## 09 · Debugging with Markers\n\n@https://mindful-mango-accy.here.now/agent.md?raw\n\n!`curl -sf https://mindful-mango-accy.here.now/replay.html`\n\n!`curl -sf https://mindful-mango-accy.here.now/dialogue.html`\n\n## References & Resources — tool alternatives\n\n@https://dewy-sleet-n5zs.here.now/agent.md?raw"
}
