Komputer.AI
ConceptsSquads

GitOps

Declaring squad members declaratively — prefer ref over embedded spec to avoid controller drift.

Members can be declared two ways in the squad CRD:

spec:
  members:
    - ref:
        name: my-agent           # reference to an existing KomputerAgent
    - spec:                      # embedded spec — operator creates the agent
        task: "..."

Prefer ref for GitOps. When a member is declared with an embedded spec, the operator creates a KomputerAgent CR and rewrites the squad spec to a ref on first reconcile. This in-place mutation can surprise GitOps controllers (e.g. Argo CD, Flux) that detect drift. Declare agents separately and reference them by name to keep the squad spec stable.