Working with agents

drumlin suits coding agents, because the text is the design and the picture is for the humans reviewing it.

• One regular grammar. Each statement fits on one line, and nothing depends on visual layout in the source.
• No layout work. An agent states structure. drumlin places every box.
• Deterministic output. Regenerating an unchanged model changes no bytes.
• Errors an agent can act on. drumlin check reports a position and a likely fix.

A typical loop

Suggested instruction for an agent

Describe architecture in drumlin (.uml) files. Declare components with
`provides` and `requires`, and let matching interface names wire them. Between
two simple ports they form a ball-and-socket; otherwise socket and lollipop stay
apart, joined by a dashed dependency arrow.
Run `drumlin check` after each edit and fix every reported error. Do not add
layout hints unless a reviewer asks for a specific arrangement.