asop-studio-sop-authoring

ASOP Studio SOP Authoring Skill

This skill is the definitive specification and authoring guide for designing agentic Standard Operating Procedure (SOP) workflows in the ASOP Studio YAML format (SOP Version 2). It provides rules, syntax patterns, best practices, and anti-patterns for generating high-quality, actionable, and testable multi-file SOP projects optimized for graph-guided agent execution.

1. How Graph-Guided Execution Works

Before generating SOPs, you must understand how they are executed by the underlying runtime engine (enter_node). At every turn, the engine executes actions and routes deterministically:

1. Programmatic Action Execution: Upon entering a node, the engine sequentially runs all backend tool calls defined in the actions block. Their outputs are stored in action_results (e.g., action_results.get_pizza_menu.result).
2. Programmatic Condition Evaluation: The engine then evaluates any condition_routes. If a condition evaluates to true (based on variables in session state), the engine automatically traverses to the target node within the same turn without asking the LLM or user. It repeats steps 1 and 2 for the target node. It does this up to a depth of 10 nodes.
3. LLM Instruction and Intent Prep: Traversal pauses only when it reaches a node requiring user interaction (meaning it has intent_routes or is END). The engine returns the accumulated instructions, the action results, and the available user intent transitions.
4. LLM Presentation & Input Parsing: The LLM presents the information to the user using the accumulated instructions and action results. When the user replies, the LLM maps their response to one of the active intent_routes. If the route contains set_variables, the LLM extracts those parameters into session state, and initiates the next enter_node turn at the target node.

2. SOP Project Structure & Naming Conventions

To keep complex workflows maintainable, clean, and decoupled, ASOP Studio uses a multi-file project directory instead of a single monolithic file.