Agent workflows

Audience: LLM agents. Companion: How we work

There are no iteration templates or spec files to fill. Use this page as a shape reference when aligning with the developer in chat.

Default loop

1. Read Task board — pick task-NNN (or a milestone from Roadmap).
2. Confirm in chat: goal, in/out scope, acceptance criteria (from the task entry).
3. Implement + tests + docs + CHANGELOG bullet.
4. Mark the task [x] on the task board.

Task shapes (informal)

Feature — new or changed public API; update /api/ + /guide/; extend public-api.test.ts if exports change.

Bugfix — failing test first when practical; minimal diff; CHANGELOG under Fixed.

Docs only — no packages/core behaviour changes; pnpm --filter docs build.

Release — move CHANGELOG Unreleased → ## [x.y.z], bump packages/core/package.json, tag, publish.