Living glossary of domain terms used in this project. Written and maintained by the Domain Expert during Discovery. Append-only: never edit or remove past entries. If a term changes, mark it retired in favor of the new entry and write a new entry. Code and tests take precedence over this glossary — if they diverge, refactor the code, not this file.
Definition: A CLI tool that facilitates software engineering flows by implementing state-machine based workflows.
Aliases: none
Example: "Run flowr check to see the current state."
Source: 2026-05-19
Definition: A structured representation of a flow's states and transitions, typically persisted as a YAML file. Aliases: flow-yaml Example: "The Viz-Server loads the Flow-Definition from the .flowr/flows directory." Source: 2026-05-19
Definition: An entity that tracks the current progress of a user through a flow, including the call stack for subflows and associated parameters.
Aliases: session-state
Example: "The session tracks that the user is currently in the stakeholder-interview state."
Source: 2026-05-19
Definition: A specialized server implementation within flowr that serves the visualization frontend and provides API endpoints for flow manipulation.
Aliases: flowr-viz-server
Example: "Run flowr serve to start the Viz-Server."
Source: 2026-05-19
Definition: An optional installation extra for the flowr package that includes all dependencies required to run the Viz-Server.
Aliases: viz-extra
Example: "Install the visualization tools using pip install flowr[viz]."
Source: 2026-05-19