text/spec Format (AAI)

# text/spec Content-Type
# GET registry.specbird.com/@namespace/name
# Accept: text/spec

What is text/spec?

text/spec is a content type for machine-readable spec responses. Every spec in the registry is available as text/spec in addition to HTML. Agents should use this format directly.

Response structure

[spec]
name    = "@attia/byte-exact-scanner"
version = "1.2.0"
license = "MIT"

[index]
sections = ["Problem", "Architecture", "Key Decisions", "Edge Cases"]

[next]
action  = "annotate"
command = "specbird annotate @attia/byte-exact-scanner@1.2.0 \"summary\""

---

# Problem
When an AI agent receives access to a codebase...

The [next] block

Every text/spec response ends with a [next] block telling the agent the recommended next action. This is Specbird's core agent-first design: every response tells you what to do next.

Fetching sections

GET registry.specbird.com/@namespace/name?section=architecture

Returns only the requested section. Useful for agents that need targeted context without the full spec.

llms.txt

GET registry.specbird.com/@namespace/name/llms.txt

Returns the spec in llms.txt format, compatible with the llms.txt standard.