# SirenSpec

## Docs

- [Agents](https://docs.sirenspec.dev/assistant.md): Agents are the building blocks of a SirenSpec workflow — each one wraps an LLM with a system prompt and optional guardrails.
- [CLI Reference](https://docs.sirenspec.dev/cli-reference.md): Complete reference for the sirenspec command-line interface.
- [1000 Monkeys](https://docs.sirenspec.dev/cookbook/1000-monkeys/README.md): Five agents tackle the same prompt independently; a curator picks the best result. Tests output variance and emergent quality from parallelism.
- [Adversarial Pair](https://docs.sirenspec.dev/cookbook/adversarial-pair/README.md): Two agents argue opposing sides of a topic; a judge scores the debate. Also exercises the injection guardrail as prompts turn combative.
- [Blind Code Review](https://docs.sirenspec.dev/cookbook/blind-code-review/README.md): Write, review, revise — a three-agent refinement loop where the reviewer never sees the original spec.
- [Compression Gauntlet](https://docs.sirenspec.dev/cookbook/compression-gauntlet/README.md): A document passes through four summarizer agents, each halving the length. Demonstrates the length guardrail under sustained pressure.
- [Conditional Pipeline](https://docs.sirenspec.dev/cookbook/conditional-pipeline/README.md): A triage agent routes each request to one of two handlers using `when:` expressions on edges.
- [Graphic Design Firm](https://docs.sirenspec.dev/cookbook/graphic-design-firm/README.md): Five agents simulate a real agency handoff — brief, copy, design, critique, revision. A stress test for context passing across a long pipeline.
- [Market Analysis (Swrm)](https://docs.sirenspec.dev/cookbook/market-analysis/README.md): Three specialist agents analyze a report in parallel; a synthesis agent combines their findings into an investment recommendation.
- [News Desk](https://docs.sirenspec.dev/cookbook/news-desk/README.md): Reporter → editor → headline writer → publisher. A clean editorial pipeline that newcomers can follow at a glance.
- [PR Summarizer](https://docs.sirenspec.dev/cookbook/pr-summarizer/README.md): Fetches a GitHub pull-request diff via the HTTP tool, then an LLM writes a developer-friendly summary.
- [Sequential Pipeline](https://docs.sirenspec.dev/cookbook/sequential-pipeline/README.md): Two agents run in order — classify intent, then compose a reply. The foundational multi-agent pattern.
- [Simple Agent](https://docs.sirenspec.dev/cookbook/simple-agent/README.md): A single agent answers one question — the smallest valid SirenSpec workflow.
- [Telephone Game](https://docs.sirenspec.dev/cookbook/telephone-game/README.md): Five agents relay a message in sequence — each rewriting only what it received. Watch semantic drift accumulate across hops.
- [Guardrails](https://docs.sirenspec.dev/guardrails.md): Guardrails protect every agent call with input validation and output filtering.
- [Introduction](https://docs.sirenspec.dev/introduction.md): SirenSpec is a YAML-first agent orchestration SDK for defining and running multi-agent workflows.
- [Providers](https://docs.sirenspec.dev/providers.md): SirenSpec supports OpenAI, Anthropic, and Ollama as LLM backends.
- [Quickstart](https://docs.sirenspec.dev/quickstart.md): Install SirenSpec and run your first workflow in under five minutes.
- [Retry Policies](https://docs.sirenspec.dev/retry-policies.md): Configure automatic retries and failure handling to make SirenSpec workflows resilient to transient provider errors.
- [Python SDK](https://docs.sirenspec.dev/sdk.md): Use SirenSpec programmatically from Python code.
- [Swrm — Parallel Agent Fan-Out](https://docs.sirenspec.dev/swrm.md): Run multiple specialist LLM agents in parallel and optionally synthesise their outputs with a committee-of-experts pattern.
- [Tool Nodes](https://docs.sirenspec.dev/tool-nodes.md): Invoke HTTP endpoints and Python callables as first-class workflow nodes.
- [YAML Reference](https://docs.sirenspec.dev/yaml-reference.md): Complete reference for all fields in a SirenSpec workflow file.

## OpenAPI Specs

- [openapi](https://docs.sirenspec.dev/api-reference/openapi.json)