Docs
Start from the kind of collection you need: guides, concepts, techniques, or documentation. This page points you to the right part of the reference and gives a few strong starting pages.
Quick routes
Use these entry points when you know how you want to explore, but not the exact page yet.
Guides
Guide pages walk through practical CLI workflows and how to apply the reference in day-to-day work.
- Cursor Dynamic Workflows
Use Cursor as an MCP host for you-agent-factory Factory Session and dynamic-workflow tools.
- How To Make Your Agent Use YOU
Point an AI agent at the packaged you-agent-factory agent orientation topic and let it drive the you CLI itself, with MCP and ACP as the deeper integrations.
- Run Your First Factory
Install a packaged factory from the embedded catalog and run it end to end without writing any configuration.
- Using you-agent-factory for Loops
Run iterative factory loops that keep work cycling until a goal is done.
- Write Your First Factory
Author a you-agent-factory factory of your own, step by step, in either the declarative graph format or the JavaScript orchestrator format.
- Write Your First JavaScript Workflow
Use the you-agent-factory JavaScript orchestrator: the runtime bindings a workflow script gets, how it dispatches agents, and how it bounds, checkpoints, and returns its work.
Concepts
Concept pages explain broader ideas that span many factory workflows, such as harnesses, loops, and bottlenecks.
- Bottlenecks
A factory bottleneck is the stage or resource that caps overall you-agent-factory throughput even when other stages have spare capacity.
- Checklist
A factory planner checklist is a live outcomes and workstream board that shows done, active, ready-next, and intentionally held work.
- Compaction
Compaction shrinks retained context—history, transcripts, or stream windows—so long-running agent or factory work can continue within limits.
- Harness
A harness is the agent runtime the factory drives, such as a coding agent under a shared factory process.
- Loop
A factory loop keeps iterating under you-agent-factory until the goal is done.
- MCP
Model Context Protocol: the host↔server protocol that exposes named tools, including Factory Session tools via you mcp serve.
Techniques
Technique pages explain named methods and practices you can apply across CLI workflows and documentation tasks.
- Classify-Execute
Classify an item into a known class, then run the specialist execute path for that class.
- Fusion
Fusion is a you-agent-factory technique that runs two model passes on the same request: a first pass drafts an answer and a second pass refines it.
- Planner-Executor
Planner-executor separates planning work into reviewable slices from executing those slices so independent factory streams can move in parallel.
- Planner-Executor In Action
Practice planner-executor as a multi-model cost tradeoff: when a larger planner and smaller executor win over one shared model.
- Ralph
Ralph is an autonomous one-story-per-iteration execution loop driven by a product requirements backlog.
- Worker-Adviser
Worker-adviser separates an adviser role that recommends or critiques from a worker role that performs the work.
Documentation
Documentation pages cover reference material for the CLI surface, including contracts, conventions, and supporting detail.
- Agent worker
Configure an AGENT_WORKER for agent-loop execution: model and provider identity, agentTools policy, permissions, resources, and AGENT_RUN workstation companionship.
- Agent-run workstation
Configure type = AGENT_RUN for agent worker dispatch through an AGENT_WORKER backend.
- API
Reach and use the you-agent-factory local HTTP API: how to get a listener running at all, the default base URL, the session-oriented flow, and the path to the operations catalog.
- Architecture of system
How you-agent-factory is structured: factory topology, work, workstations, workers, resources, and live FactorySession runtime.
- Classifier workstation
Configure type = CLASSIFIER_WORKSTATION for classification routes and classifier-specific output restrictions through a HOSTED_WORKER companion.
- CLI
Look up the you-agent-factory command groups, how a factory is selected for a run, the global flags every command shares, and where the full published CLI contract lives.