{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "codex-variation-workflows-team-guide",
  "slug": "variation-workflows-team-guide",
  "title": "Controlled variation workflows: team walkthrough",
  "summary": "Controlled software variations using one variable, a shared prompt seed, isolated candidates, common verification, comparison records, and explicit Pick/Combine/Refine/Expand/Reject decisions, including billing-webhook examples and convergence failure…",
  "category": "Team practice",
  "tags": [
    "variations",
    "verification",
    "comparison",
    "team-guide"
  ],
  "sources": [
    {
      "label": "Portable Codex workflow resources",
      "url": "https://lapis-fossil-vsbc.here.now/downloads/codex-power-user-workshop-2026-06-27.bundle"
    }
  ],
  "sourceUnits": [
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Presenter Goal",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Timing Options",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Timing Options/10-Minute Version",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Timing Options/20-Minute Version",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Timing Options/35-Minute Version",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Things To Say",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Live Demo Script",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Live Demo Script/1. Start With The Pattern",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Live Demo Script/2. Write The Variable",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Live Demo Script/3. Create The Run Folder",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Live Demo Script/4. Save A Prompt Builder Seed",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Live Demo Script/5. Check Repo State",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Live Demo Script/6. Show Same Verification",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Live Demo Script/7. Save The Decision",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Cut Path",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Boundaries",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Boundaries/From Section 5",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Boundaries/To Section 7",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Failure Paths To Preserve",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Do Not Over-Explain",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Presenter Checklist",
    "downloads/codex-power-user-workshop-2026-06-27.bundle!/instructor-notes/06-code-is-free-generate-variations.md#Instructor Notes: 06. Code Is Free / Generate Variations/Practice Launch Notes",
    "downloads/codex-power-user-workshop-2026-06-27.bundle"
  ],
  "collection": "codex",
  "categoryId": "team-practice",
  "wordCount": 1251,
  "url": "/topics/codex-variation-workflows-team-guide/",
  "markdownUrl": "/markdown/codex-variation-workflows-team-guide.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/codex-variation-workflows-team-guide.json",
  "headings": [
    {
      "id": "team-learning-goal",
      "text": "Team Learning Goal",
      "level": 2
    },
    {
      "id": "walkthrough-depth",
      "text": "Walkthrough Depth",
      "level": 2
    },
    {
      "id": "essential-walkthrough",
      "text": "Essential Walkthrough",
      "level": 3
    },
    {
      "id": "expanded-walkthrough",
      "text": "Expanded Walkthrough",
      "level": 3
    },
    {
      "id": "deep-dive-walkthrough",
      "text": "Deep-Dive Walkthrough",
      "level": 3
    },
    {
      "id": "talking-points",
      "text": "Talking Points",
      "level": 2
    },
    {
      "id": "live-demo-script",
      "text": "Live Demo Script",
      "level": 2
    },
    {
      "id": "1-start-with-the-pattern",
      "text": "1. Start With The Pattern",
      "level": 3
    },
    {
      "id": "2-write-the-variable",
      "text": "2. Write The Variable",
      "level": 3
    },
    {
      "id": "3-create-the-run-folder",
      "text": "3. Create The Run Folder",
      "level": 3
    },
    {
      "id": "4-save-a-prompt-builder-seed",
      "text": "4. Save A Prompt Builder Seed",
      "level": 3
    },
    {
      "id": "5-check-repo-state",
      "text": "5. Check Repo State",
      "level": 3
    },
    {
      "id": "6-show-same-verification",
      "text": "6. Show Same Verification",
      "level": 3
    },
    {
      "id": "7-save-the-decision",
      "text": "7. Save The Decision",
      "level": 3
    },
    {
      "id": "minimal-useful-path",
      "text": "Minimal Useful Path",
      "level": 2
    },
    {
      "id": "boundaries",
      "text": "Boundaries",
      "level": 2
    },
    {
      "id": "from-section-5",
      "text": "From Section 5",
      "level": 3
    },
    {
      "id": "to-section-7",
      "text": "To Section 7",
      "level": 3
    },
    {
      "id": "failure-paths-to-preserve",
      "text": "Failure Paths To Preserve",
      "level": 2
    },
    {
      "id": "do-not-over-explain",
      "text": "Do Not Over-Explain",
      "level": 2
    },
    {
      "id": "team-checklist",
      "text": "Team Checklist",
      "level": 2
    },
    {
      "id": "practice-launch-notes",
      "text": "Practice Launch Notes",
      "level": 2
    },
    {
      "id": "related-resources",
      "text": "Related resources",
      "level": 2
    }
  ],
  "markdown": "# Controlled variation workflows: team walkthrough\n\n## Team Learning Goal\n\nTeach controlled variation as a decision workflow.\n\nThe point is not “generate more.” The point is:\n\n```text\nGenerate comparable options, verify each option, then preserve the decision.\n```\n\nBy the end of this section, the room should understand:\n\n- why cheap generation changes the workflow\n- why quality, integration, and verification are not free\n- how to choose one variable under test\n- how to write a variation matrix\n- why isolation matters before fan-out\n- why the same verification command must run for every candidate\n- how to decide Pick / Combine / Refine / Expand / Reject\n- how Section 5’s saved prompt becomes the seed\n- how Section 7 expands what can become prompt material\n\n## Walkthrough Depth\n\n### Essential Walkthrough\n\n1. State: `Code is free` does not mean quality is free.\n2. Teach the One Dimension Rule.\n3. Show a billing webhook variation matrix.\n4. Show the `artifacts/variations/<run-id>/` folder shape.\n5. Show one verification command applied to all candidates.\n6. End with Pick / Combine / Refine / Expand / Reject.\n\nPreserve:\n\n```text\ngoal -> variable -> matrix -> isolation -> fan-out -> verify -> review -> selection -> convergence -> saved decision\n```\n\n### Expanded Walkthrough\n\nAdd:\n\n- dirty repo checkpoint\n- Prompt Builder seed prompt\n- worktree isolation\n- candidate prompt overrides\n- comparison file\n\n### Deep-Dive Walkthrough\n\nAdd:\n\n- visible cmux fan-out\n- screenshots for UI candidates\n- convergence prompt from saved decision\n- failure paths\n- exercises\n\n## Talking Points\n\nOpening:\n\n> Code is free does not mean quality is free.\n\nOn variations:\n\n> Variation is a decision tool, not a procrastination tool.\n\nOn the One Dimension Rule:\n\n> If every candidate changes everything, comparison teaches nothing.\n\nOn verification:\n\n> Unverified candidates are just more text.\n\nOn isolation:\n\n> Parallel work needs lanes. Without lanes, candidates overwrite each other.\n\nOn Combine:\n\n> Combine still needs a primary candidate. Otherwise it becomes “take everything I liked” and scope explodes.\n\nBridge from Section 5:\n\n> Section 5 made the prompt deliberate. Section 6 turns that prompt into comparable options.\n\nBridge to Section 7:\n\n> We just learned to vary from one prompt. Next, we widen what can count as prompt material.\n\n## Live Demo Script\n\n### 1. Start With The Pattern\n\n```text\ngoal -> variable -> matrix -> isolation -> fan-out -> verify -> review -> selection -> convergence -> saved decision\n```\n\n### 2. Write The Variable\n\n```text\nWe are comparing candidates that differ only by idempotency strategy.\n```\n\n### 3. Create The Run Folder\n\n```bash\nRUN_ID=\"billing-webhook-$(date +%Y%m%d-%H%M%S)\"\nROOT=\"artifacts/variations/$RUN_ID\"\nmkdir -p \"$ROOT\"/{prompts,launch,logs,review,decisions}\nmkdir -p \"$ROOT\"/candidates/{v1,v2,v3}\nfind \"$ROOT\" -maxdepth 3 -type d | sort\n```\n\n### 4. Save A Prompt Builder Seed\n\n```bash\nPROMPT='Generate three controlled fixes for duplicate billing webhook processing. Keep the provider contract and database schema fixed. Vary only the idempotency strategy. Each option must name files, tests, risks, and rollback notes.'\n\np --print-prompt \"$PROMPT\" > \"$ROOT/prompts/base.prompt.md\"\np --print-launch-json \"$PROMPT\" > \"$ROOT/launch/base.launch.json\"\ntest -s \"$ROOT/prompts/base.prompt.md\" && echo \"base-prompt:OK\"\n```\n\n### 5. Check Repo State\n\n```bash\ngit status --short | tee \"$ROOT/review/git-status-before.txt\"\ngit diff > \"$ROOT/review/dirty-before.patch\"\ngit diff --staged > \"$ROOT/review/staged-before.patch\"\n```\n\nPresenter note:\n\n```text\nDirty state is not forbidden. Unknown dirty state is the problem.\n```\n\n### 6. Show Same Verification\n\n```bash\nVERIFY='pnpm test billing-webhook -- --runInBand && pnpm build'\nprintf 'v1\\t<status>\\t%s\\n' \"$VERIFY\" > \"$ROOT/review/verification.tsv\"\nprintf 'v2\\t<status>\\t%s\\n' \"$VERIFY\" >> \"$ROOT/review/verification.tsv\"\nprintf 'v3\\t<status>\\t%s\\n' \"$VERIFY\" >> \"$ROOT/review/verification.tsv\"\ncolumn -t -s $'\\t' \"$ROOT/review/verification.tsv\"\n```\n\nIf real tests are too slow live, show the shape and say:\n\n> In a real project, this is where broken candidates get filtered before review.\n\n### 7. Save The Decision\n\n```bash\ncat > \"$ROOT/decisions/selection.md\" <<'EOF'\n# Saved Decision\n\n- outcome: Combine\n- primary candidate: v2\n- secondary candidate ids: v1\n- decision: Use v2 as the base and take v1's rollback guard.\n- final verification command: pnpm test billing-webhook -- --runInBand && pnpm build\n\n## Continue Prompt\n\nContinue from this saved decision.\nPreserve v2 as the primary candidate.\nApply only the named v1 rollback guard.\nRun final verification.\nEOF\n```\n\n## Minimal Useful Path\n\nIf 5 minutes behind, cut:\n\n- visible cmux fan-out\n- feature flag isolation\n- screenshots\n- convergence prompt command\n\nPreserve:\n\n- `Code is free` does not mean quality is free\n- One Dimension Rule\n- variation matrix\n- dirty repo checkpoint\n- same verification command\n- Pick / Combine / Refine / Expand / Reject\n\nIf 10 minutes behind, skip worktree creation and use output folders only:\n\n```bash\nmkdir -p \"$ROOT\"/candidates/{v1,v2,v3}\n```\n\nIf 20 minutes behind, teach only:\n\n```text\nOne deliberate prompt becomes a matrix.\nThe matrix changes one dimension.\nEach candidate gets isolation.\nEach candidate gets the same verification.\nThe final decision is Pick, Combine, Refine, Expand, or Reject.\n```\n\n## Boundaries\n\n### From Section 5\n\nSection 5 solves composition:\n\n```text\nWhat exactly am I about to send?\n```\n\nSection 6 solves controlled fan-out:\n\n```text\nWhat do I do after the prompt is good enough to become a seed?\n```\n\n### To Section 7\n\nSection 6 assumes the seed is mostly text plus project context.\n\nSection 7 expands the prompt material:\n\n```text\nvideo can carry visual state, timing, workflow, cursor motion, and failure evidence\n```\n\n## Failure Paths To Preserve\n\nCandidates drift:\n\n> Drift means the matrix was too weak or the candidate prompt was too loose. Stop and tighten the variable.\n\nUnverifiable options:\n\n> If you cannot verify the candidates, you are setting up a beauty contest. Define verification first.\n\nDirty repo:\n\n> Dirty state is not forbidden. Unknown dirty state is the problem.\n\nMerge conflicts:\n\n> The selected candidate worked in isolation. Convergence has to protect that proof, not bulldoze it.\n\nStrongest idea split across candidates:\n\n> That is Combine. Pick a primary candidate and name the pieces you are taking.\n\nAll candidates fail:\n\n> That is useful information. Reject the set or expand with a tighter prompt. Do not pretend one failed candidate won.\n\n## Do Not Over-Explain\n\nAvoid spending time on:\n\n- every local helper\n- every possible git worktree cleanup command\n- full review UI implementation details\n- exhaustive parallel orchestration\n- model-provider comparisons\n- abstract creativity theory\n\nKeep the section practical:\n\n```text\nmatrix\nisolation\nfan-out\nverification\nreview\nsaved decision\n```\n\n## Team Checklist\n\nBefore considering this section ready, confirm the materials include:\n\n```text\nCode is free\nquality is not free\nintegration is not free\nverification is not free\ncontrolled variations\nOne Dimension Rule\ngood variables\nbad variables\nwhen to use variations\nwhen not to use variations\ngoal -> variable -> matrix -> isolation -> fan-out -> verify -> review -> selection -> convergence -> saved decision\nvariation matrix template\nPrompt Builder seed\nartifacts/variations/<run-id>/\nbase.prompt.md\nbase.launch.json\ndirty repo checkpoint\nworktrees\nbranches\ndirectories\nfeature flags\nsame verification command\ncomparison notes\ndiff review\nscreenshots for UI\ntest results\nPick\nCombine\nRefine\nExpand\nReject\nfailure paths\nSection 7 bridge to video\n```\n\n## Practice Launch Notes\n\nGood demo scenarios:\n\n| Scenario | Variable |\n| --- | --- |\n| checkout saved payment methods | UI integration strategy |\n| billing webhook duplicate-processing | idempotency strategy |\n| auth/session architecture | architecture boundary |\n| flaky regression coverage | test boundary |\n| checkout implementation | implementation alternative |\n\nAvoid:\n\n```text\nmake the app better\nimprove architecture\ntry some ideas\nfix everything\n```\n\nThe cleanest live example is billing webhook idempotency because correctness, verification, rollback, and risk are easy to discuss.\n\n## Related resources\n\n- [Companion reference](https://lapis-fossil-vsbc.here.now/downloads/codex-power-user-workshop-2026-06-27.bundle)\n- [Resource directory and portable download](/topics/codex-resources/)"
}
