Core Feature

SOP Doc

API Doc shows each endpoint. SOP Doc shows the sequence — which steps, in what order, who is involved. Click Visual to see the flow.

How SOP Doc Works

sop-doc-browse.osop.yaml
Write .osop Filehuman

Define a process as YAML. Each step is a node (api, agent, human, cli). Connections are edges.

↓sequential→ osop validate
osop validatecli

Check the .osop file against JSON Schema. Catches errors before anyone sees them.

↓sequential→ Browse in SOP Doc
↓fallback→ Write .osop File
Browse in SOP Docmcp

Open osop.ai/sop-doc. Visual tab shows the flow diagram. YAML tab shows the spec.

↓sequential→ Share with Team
Share with Teamhuman

PMs read the Visual tab. Engineers read the YAML. Everyone sees the same process.

Open in Editor

The Optimization Loop

the-loop.osop.yaml
osop runcli

Execute the workflow. Agent nodes call LLMs. API nodes send HTTP requests.

↓sequential→ .osoplog Generated
.osoplog Generatedsystem

Every node: timestamps, duration, cost, tools used, AI reasoning, human decisions.

↓sequential→ osop synthesize
osop synthesizeagent

Feed multiple .osoplog to AI. It writes an optimized .osop.

↓sequential→ osop diff
osop diffcli

Compare old vs new. See what changed: duration, cost, status per step.

↓sequential→ Human Reviews
Human Reviewshuman

Accept, modify, or reject AI suggestions. The human decides.

↓loop→ osop run
Open in Editor

Stripe Payment Flow (API SOP)

stripe-payment-flow.osop.yaml
POST /v1/customersapi

Create a Stripe customer with email and metadata.

↓sequential→ POST /v1/payment_intents
POST /v1/payment_intentsapi

Create a payment intent. Amount, currency, customer ID.

↓sequential→ POST /v1/payment_intents/{id}/confirm
POST /v1/payment_intents/{id}/confirmapi

Confirm the payment with a payment method.

↓sequential→ GET /v1/payment_intents/{id}
↓fallback→ POST /v1/payment_intents
GET /v1/payment_intents/{id}api

Verify the payment succeeded. Check status field.

↓conditional→ AI Generate Receipt
AI Generate Receiptagent

AI generates a personalized receipt email from payment details.

Open in Editor

Import Existing Workflows

import-existing.osop.yaml
Identify Source Formathuman

GitHub Actions, Airflow, n8n, CrewAI, Argo, or LangGraph.

↓sequential→ osop import
osop importcli

Convert to OSOP format. Maps jobs/operators/tasks to OSOP nodes and edges.

↓sequential→ osop validate
osop validatecli

Verify the converted file is valid OSOP.

↓fallback→ osop import
↓sequential→ Review in Editor
Review in Editorhuman

Open in visual editor. Check flow matches original. Adjust if needed.

Open in Editor

Session Log: Full zh-TW i18n

session-i18n-zh-tw.osop.yaml
User Requests Full zh-TW Translationhuman

User reports that switching to Chinese leaves many sections in English.

↓sequential→ Explore i18n Architecture
Explore i18n Architectureagent

Explored next-intl setup, message files, routing config, and all page components.

↓sequential→ Identify Untranslated Strings
Identify Untranslated Stringsagent

Found hardcoded English in home, optimize, sop-doc, hub, OsopCodeBlock, DocsNav, blog.

↓sequential→ Design Translation Plan
Design Translation Planagent

Created 6-step plan: shared UI keys, components, pages, YAML content.

↓sequential→ Create Translation Namespaces
Create Translation Namespacesmcp

Created optimize, sop-doc, hub message files for en and zh-TW.

↓parallel→ Translate Page Content
↓parallel→ Translate UI Components
Translate Page Contentmcp

Added translation keys for home, optimize, sop-doc, hub, layout footer.

↓sequential→ Translate YAML Showcases
Translate UI Componentsmcp

Updated OsopCodeBlock, DocsNav, blog with useTranslations.

Translate YAML Showcasesmcp

8 YAML blocks across 3 pages now render Chinese node names.

↓sequential→ Build Translation Infrastructure
Build Translation Infrastructuremcp

Created translate.ts, get-translated.ts for runtime YAML translation.

↓sequential→ Extract 2126 Strings
Extract 2126 Stringscli

Extracted all translatable strings from 245 workflows.

↓sequential→ Coordinate 4 Parallel Translators
Coordinate 4 Parallel Translatorsagent

Split into 4 batches and dispatched parallel translation agents.

↓sequential→ Merge & Verify
Merge & Verifycli

Merged 245 workflows, fixed garbled chars, verified all pages.

Open in Editor

Add your own SOPs

Write .osop files for your API, your team, your company. Every process becomes visible and shareable.

Browse all .osop in HubGet Started