{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "factory-factory-loop",
  "slug": "factory-loop",
  "title": "A trustworthy software factory loop",
  "summary": "Bound one recurring task, name the consequential action, and earn autonomy with observable evidence.",
  "category": "Principles",
  "tags": [
    "factory",
    "safety",
    "receipts"
  ],
  "sources": [
    {
      "label": "Software factory operating model",
      "url": "https://proud-anchor-53zn.here.now/learn.html#q1-factory-loop"
    },
    {
      "label": "Companion lesson",
      "url": "https://proud-anchor-53zn.here.now/learn.html#q1-factory-loop"
    }
  ],
  "sourceUnits": [
    "index.html#factory-stages-and-guided-path",
    "learn.html#q1-factory-loop",
    "reference.html#evidence-status"
  ],
  "collection": "factory",
  "categoryId": "principles",
  "wordCount": 848,
  "url": "/topics/factory-factory-loop/",
  "markdownUrl": "/markdown/factory-factory-loop.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/factory-factory-loop.json",
  "headings": [
    {
      "id": "the-unit-of-work-is-a-loop-not-an-agent",
      "text": "The unit of work is a loop, not an agent",
      "level": 2
    },
    {
      "id": "put-each-kind-of-rule-in-its-proper-place",
      "text": "Put each kind of rule in its proper place",
      "level": 2
    },
    {
      "id": "choose-a-route-by-the-problem",
      "text": "Choose a route by the problem",
      "level": 2
    },
    {
      "id": "operating-practice",
      "text": "Operating practice",
      "level": 2
    },
    {
      "id": "bound-one-factory-loop",
      "text": "Bound one factory loop",
      "level": 3
    },
    {
      "id": "what-to-notice",
      "text": "What to notice",
      "level": 4
    },
    {
      "id": "try-this",
      "text": "Try this",
      "level": 4
    },
    {
      "id": "concept",
      "text": "Concept",
      "level": 4
    },
    {
      "id": "reflection",
      "text": "Reflection",
      "level": 4
    },
    {
      "id": "links-shared-for-this-topic",
      "text": "Links shared for this topic",
      "level": 4
    },
    {
      "id": "evidence-limits-that-matter",
      "text": "Evidence limits that matter",
      "level": 2
    }
  ],
  "markdown": "# A trustworthy software factory loop\n\nBound one recurring task, name the consequential action, and earn autonomy with observable evidence.\n\n## The unit of work is a loop, not an agent\n\nA software factory is not a pile of agents. The agent is one machine inside an inspectable loop:\n\n**Input → Boundary → Action → Evidence → Decision → Receipt.**\n\nStart with one recurring task and one costly failure. Define the minimum context, permission boundary, exact human gate, and success evidence before adding autonomy. A gate is a named stop, named evidence, and explicit approval before a consequential action—not a request to review something eventually.\n\nThe operating stages are **Bound → Compose → Run → Verify → Preserve → Promote**:\n\n- **Bound:** state the desired outcome, inputs, exclusions, and the first expensive, destructive, public, or hard-to-reverse action.\n- **Compose:** gather current, relevant evidence that changes the decision, implementation, or verification; do not equate volume with completeness.\n- **Run:** execute the smallest reversible experiment inside the agreed permission boundary.\n- **Verify:** demand the exact observable signal that proves the result; an agent saying “done” is not that signal.\n- **Preserve:** save the outcome, settled decision, rejection reason, failed attempts, and repeatable check so another session can continue from evidence.\n- **Promote:** automate only after repeated manual receipts establish that the signal is useful, owned, affordable, and recoverable.\n\n## Put each kind of rule in its proper place\n\nRepository files explain stable intent. Launch wrappers normalize repeated choices. Command decorators bring warnings to the moment of action. Human gates protect consequential work. Automated checks prove the condition they actually measure. None substitutes for the others.\n\nSafety is a layered design, not a permission-bypass switch. A shell function that can be bypassed with `command` is guidance with teeth, not confinement. A stripped prompt context is not a filesystem or network sandbox. A dry run or stub can prove wiring without proving behavior against a real service.\n\n## Choose a route by the problem\n\nA complete first pass connects the core boundary audit, environment policy, annotated image, focused context packet, repeatable flow, structural alternatives, independent reasoning, and product vision. A quick start takes the core loop, one visual task, and a small set of alternatives. A problem-led route enters at the current bottleneck:\n\n- **Control and safety:** bound the task, place policy near the action, make proof visible.\n- **Prompt and context:** use visual evidence, compose a focused packet, promote repeated prompts into inspectable flows.\n- **Design and taste:** expose structural alternatives and preserve why one won.\n- **Continuity and debugging:** recover trustworthy state and join human testimony to runtime facts.\n- **Advanced reasoning and video:** escalate a hard decision, not an entire workflow by default.\n- **Vision and automation:** state durable direction, promote proven signals, and keep unresolved work explicit.\n\nFor each topic, move through **orientation → concept → evidence → practice → reflection → next action**. Copying a prompt, attempting it, and verifying its result are separate states. “Now” establishes the core loop; “Next” makes it repeatable; “Later” adds expensive or specialized capabilities; “Reference” retains unresolved status.\n\n## Operating practice\n\n### Bound one factory loop\n\n#### What to notice\n\nTurn one recurring task into an inspectable loop with inputs, permissions, proof, a **human gate**, and a **durable receipt**.\n\n#### Try this\n\nWrite Input → Boundary → Action → Evidence → Decision → Receipt for one task you already repeat.\n\n> “If the agents can't see it, it doesn't exist.”\n\nJohn Lindquist · [00:23:25](https://proud-anchor-53zn.here.now/watch.html?t=1405#recording-player)\n\n#### Concept\n\nA software factory is not a pile of agents. The agent is one machine inside the loop. Start with the smallest reversible bet, then name the exact action that must stop for human approval.\n\n#### Reflection\n\nA gate is not “review this sometime.” It is a named stop, named evidence, and explicit approval before a consequential action.\n\n**Recording evidence:** listen at 00:15:52.\n\n> “Alignment is the key word here. Is the agent aligned with your vision?”\n\nJohn Lindquist · [00:32:52](https://proud-anchor-53zn.here.now/watch.html?t=1972#recording-player)\n\n[Open How Agentic Work Is Evolving](https://hallowed-entry-96xv.here.now/)\n\n#### Links shared for this topic\n\n- [Workshop agenda](https://ember-bodhi-scrr.here.now/) — The original workshop sequence and setup hub.\n- [Coding with Agents field guide](https://kindly-mirage-ejqd.here.now/) — The earlier field guide that grounded the workshop’s operating principles.\n- [Cursor Origin](https://cursor.com/origin) — An autonomous coding-agent product discussed during the opening model survey.\n\n[Watch chapter](https://proud-anchor-53zn.here.now/watch.html?t=952#q1-factory-loop)\n\n## Evidence limits that matter\n\nA file appearing, a command running, and a check passing are separate events. Preserve failed attempts instead of upgrading them into success. The environment demonstration surfaced diagnostics, and the recorded MDFlow wrapper exercise did not become a clean success. Those are failure-aware examples, not universal installation proofs.\n\nTool versions, model names, prices, subscription eligibility, limits, and predictions are contextual claims from the recorded discussion—not current purchasing guidance. Current dotfiles and comparative model-cost guidance remained unresolved. The Markers material is a prepared follow-up, not a dedicated recorded section.\n\nKeep exact published resource links separate from uncertain text read off a screen. A transcript establishes what was said; a recording can reveal visible action; a prepared recipe establishes intended behavior; only the appropriate check establishes success."
}
