Susan

Glossary

AI software factory. The whole Susan suite: development agents run workflows on your code in containers, a dashboard follows every run, and a person of your team answers the questions the runs ask.

Workflow. A YAML file that describes the steps an AI agent follows, executed by AWF.

Run. One execution of a workflow, in its own container. A run ends as completed, failed, cancelled or lost (its container disappeared).

Item. A unit of work the dashboard follows, such as a request. An item can start several runs.

Operator. The nexus-operator service. It starts runs as Kubernetes Jobs or Docker containers and follows them until they end.

Dashboard. The nexus-dashboard service. It shows items and runs, and the questions runs ask a person.

Project. A set of repositories and runs. On a cluster, a project is a prepared namespace; on a workstation, a name in NEXUS_PROJECTS.

Pack. A set of workflows installed together, such as packs/factory.

Access. A cluster account with limited rights and a fixed duration, granted in a confirmation window with nexusadm grant request.

Setup. One of the two ways to install Susan: workstation or homelab.