# Concepts

These pages explain the design of domyn-swarm. Read them before you change the
related code.

- [Architecture](architecture.md): Components and their relationships
- [Serving vs compute backends](backends.md): Separate protocols for serving and compute
- [The SwarmJob lifecycle](swarmjob-lifecycle.md): From CLI invocation to output file
- [Watchdog and collector](watchdog-collector.md): Health reporting processes
- [Configuration precedence](configuration.md): Sources and priority of values

```{toctree}
:hidden:

architecture
backends
swarmjob-lifecycle
watchdog-collector
configuration
```