The documentation is split by purpose: use the CLI reference to run Kostral, the system model to understand its behavior, and the architecture guide to understand implementation boundaries.
Commands, syntax, options, output formats, and copy-paste examples.
Read CLI Reference →Conceptual model: preparation, execution, engine responsibilities, and workflow composition.
Read system-model.md →How to add rules and work inside an independent engine without creating responsibility overlap.
Contributor guide →Run engines as separate HTTP services and compose them with koss remote. Experimental demonstration with a static registry.
Future direction and planned capabilities. Future concepts are kept separate from current implementation.
Read vision.md →The reading order for the whole documentation set, from the mental model to contribution rules.
Read docs/README.md →Independent engines. Composable workflow. Engine ownership defines what a module is responsible for; workflow composition defines when it runs.
Workflow composition also covers where an engine runs. Engines can be invoked locally or through remote HTTP clients; that changes the invocation mechanism, not the engine’s responsibility. See remote-engines.md.