Bruno collection
Backend projects describe their HTTP API as a Bruno collection in bruno/, updated in the PR that changes an endpoint.
Bruno collection
Installation
npx @aura-design/cli@latest blueprint .Blueprint writes this rule to .agents/rules/bruno.mdc on backend projects, together with bruno/bruno.json, bruno/environments/local.bru, and a health.bru request. Force it with --with bruno or skip it with --without bruno. It is not in the registry.
The HTTP API of this project is described by the Bruno collection in bruno/. One .bru request per endpoint, grouped in one folder per resource.
- MUST: When a PR adds, changes, or removes an HTTP endpoint, add, update, or delete its
.brurequest in that PR. - MUST: Use
{{baseUrl}}and environment variables frombruno/environments/for hosts, ids, and tokens. - MUST: Add an
assertblock with the expected status for each request. - MUST NOT: Write secrets into
.brufiles. Mark themvars:secretin an environment, or read them with{{process.env.NAME}}frombruno/.env, which is git-ignored. - Run the collection from
bruno/withnpx @usebruno/cli run --env local.