workflows

# Workflows A workflow is a named, reusable agent pipeline. One directory bundles an orchestrator system prompt with optional subagents, skills, and plugins; invoke it like any other agent: `agents run <workflow-name> "<prompt>"`. ## "I want to bottle up a task I keep repeating" A workflow is a directory with `WORKFLOW.md` at the root: ``` ~/.agents/workflows/code-review/ WORKFLOW.md ``` `WORKFLOW.md` is YAML frontmatter (the workflow's metadata) plus a Markdown body (the orchestrator's system prompt): ```markdown --- name: Code Review description: Evidence-grounded PR review with file:line citations. model: claude-opus-4-7 tools: - Read - Grep - Glob - Bash - WebFetch --- You are Code Reviewer. Read every AGENTS.md/CLAUDE.md/GEMINI.md in touched directories first. Then identify scope, read full files, trace data flow, run the project's tests, and produce a review with file:line citations. Output sections: Summary / Critical / Concerns / Nits / Tests run / Verdict. Do not commit or modify files. ``` Run it: ```bash agents run code-review "review PR #42 on acme/api" ``` The workflow name goes in the agent slot. agents-cli resolves it (project `.agents/workflows/` > user `~/.agents/workflows/` > system), launches Claude, and prepends the WORKFLOW.md body to your prompt as the system instructions. ## "My workflow needs multiple specialized agents, not one" Add a `subagents/` subdirectory. Each `.md` file is a named subagent the orchestrator can dispatch ...