LightSOPLang Documentation

Hub for the scripting language that powers Achilles Agents orchestration.

How to Use this Guide

The overview introduces the goals of LightSOPLang and its relationship with the Achilles Agents skill families. The syntax chapter explains the textual form of commands, variable declarations, literal arguments, and the optional #!english translation mode. The semantics chapter explores evaluation order, value propagation, cancellation, and English regeneration. Use dependency optimisation to understand value propagation, execution monitoring to instrument runs, and worked examples to see real scripts in context.

The interpreter accepts an optional input argument when instantiated. If provided, it becomes an automatically declared $input variable for scripts and is forwarded to any English regeneration prompts, giving orchestrator or code skills a simple way to pass the current execution context. Tutorials reference these chapters whenever they describe embedded scripts; consult the syntax and semantics pages to ensure scripts execute deterministically and respect dependency semantics.