OSOP Examples

April 14, 2026 ยท View on GitHub

Part of SOP Doc. 113 workflow templates across 20+ domains.

API SOPs (Stripe, GitHub, MediRank), DevOps pipelines, AI agent chains, business processes, data pipelines, compliance workflows. Each example is a valid .osop.yaml file. Browse them at osop.ai/sop-doc.

Quick Start

# Clone
git clone https://github.com/Archie0125/osop-examples.git
cd osop-examples

# Validate any example
osop validate devops/github-actions-cicd.osop.yaml

# Dry-run (see what would execute, no side effects)
osop record demo/simple-agent-chain.osop.yaml --dry-run

# Real execution with LLM calls (requires ANTHROPIC_API_KEY)
export ANTHROPIC_API_KEY=sk-ant-...
osop record demo/simple-agent-chain.osop.yaml

# Execute CLI nodes (requires explicit opt-in)
osop record devops/github-actions-cicd.osop.yaml --allow-exec

# Generate execution log
osop record demo/simple-agent-chain.osop.yaml --log output.osoplog.yaml

Security

  • CLI nodes (shell commands) are blocked by default. Use --allow-exec after reviewing commands.
  • LLM costs are capped at $1.00 by default. Override with --max-cost.
  • Risk assessment runs before execution. Critical findings block without --allow-exec.

Demo Workflow

The demo/simple-agent-chain.osop.yaml runs a 3-agent chain: generate an idea, critique it, refine it. Each node calls Claude and passes output to the next.

osop record demo/simple-agent-chain.osop.yaml

Examples by Domain

DevOps (6 examples)

FileDescription
devops/ci-build-test-deploy.osop.yamlFull CI/CD pipeline: build, unit test, integration test, approval, deploy
devops/rollback-on-failure.osop.yamlDeployment with automatic rollback via error edges
devops/multi-env-promotion.osop.yamlPromote through dev, staging, production with approval gates
devops/hotfix-release.osop.yamlEmergency hotfix: branch, fix, fast-track review, deploy
devops/infrastructure-drift-check.osop.yamlScheduled Terraform plan to detect infrastructure drift
devops/secret-rotation.osop.yamlRotate secrets across services with validation steps

Testing (4 examples)

FileDescription
testing/e2e-test-suite.osop.yamlEnd-to-end test suite with parallel browser tests
testing/load-test-ramp.osop.yamlProgressive load testing with ramp-up stages and thresholds
testing/canary-validation.osop.yamlCanary deployment with automated health check validation
testing/regression-gate.osop.yamlRegression test gate with retry on flaky tests

Infrastructure (4 examples)

FileDescription
infrastructure/provision-cluster.osop.yamlProvision a Kubernetes cluster with networking and monitoring
infrastructure/database-migration.osop.yamlDatabase schema migration with backup and rollback
infrastructure/ssl-cert-renewal.osop.yamlAutomated SSL certificate renewal with DNS validation
infrastructure/disaster-recovery-failover.osop.yamlDR failover: health check, DNS switch, data sync verification

AI Agent (3 examples + 1 execution log)

FileDescription
ai-agent/rag-pipeline.osop.yamlRAG pipeline: ingest, chunk, embed, index, query
ai-agent/model-evaluation.osop.yamlLLM evaluation: generate, judge, aggregate scores, report
ai-agent/agent-tool-selection.osop.yamlMulti-tool agent: decide tool, execute, validate output, retry
ai-agent/research-and-summarize.osoplog.yamlExample .osoplog execution record: research workflow with retries, cost tracking, and human approval

Data (4 examples)

FileDescription
data/etl-pipeline.osop.yamlExtract-Transform-Load with validation and error handling
data/data-quality-check.osop.yamlData quality checks: schema, nulls, outliers, freshness
data/batch-export.osop.yamlBatch data export with chunking and progress tracking
data/data-anonymization.osop.yamlPII detection and anonymization pipeline for compliance

API (3 examples)

FileDescription
api/api-versioning-release.osop.yamlAPI version release: generate docs, update gateway, notify consumers
api/webhook-retry-handler.osop.yamlWebhook delivery with exponential backoff retry
api/rate-limit-monitor.osop.yamlMonitor API rate limits and alert on threshold breach

Mobile (2 examples)

FileDescription
mobile/app-store-release.osop.yamlMobile release: build, sign, screenshot, submit, monitor reviews
mobile/beta-distribution.osop.yamlBeta build distribution to TestFlight and Firebase App Distribution

Platform (2 examples)

FileDescription
platform/feature-flag-rollout.osop.yamlGradual feature flag rollout: 1%, 10%, 50%, 100% with monitoring
platform/tenant-onboarding.osop.yamlSaaS tenant onboarding: provision, configure, seed data, notify

Business (3 examples)

FileDescription
business/employee-onboarding.osop.yamlEmployee onboarding: accounts, access, equipment, orientation
business/invoice-approval.osop.yamlInvoice approval workflow with amount-based routing
business/incident-response.osop.yamlIncident response: detect, triage, mitigate, resolve, postmortem

Structure

devops/
testing/
infrastructure/
ai-agent/
data/
api/
mobile/
platform/
business/

Each domain directory contains self-contained .osop.yaml files. Every example includes:

  • A clear name and description
  • Proper use of OSOP node types (start, end, step, decision, fork, join, etc.)
  • Connected edges forming a valid graph
  • Realistic actions and conditions
  • Comments explaining non-obvious logic

Contributing

We welcome community-contributed examples. Please ensure your workflow:

  1. Passes osop validate
  2. Uses descriptive node IDs (kebab-case)
  3. Includes a description on the workflow and non-trivial nodes
  4. Targets a real-world use case

Open a pull request with your example in the appropriate domain directory.

License

Apache License 2.0 โ€” see LICENSE for details.