RundownAPI v0.1 — self-describing endpoint for AI agents

RundownAPI v0.1

An open pattern for self-describing API endpoints that teach AI agents how to integrate.

Key ideas:

• One endpoint (/api/rundown) returns auth, routes, parameters, and behavioral instructions
• No SDK, no agent framework, no MCP server required
• Complements OpenAPI by adding “when and why” via ai_instructions
• Designed for AI agents that can read JSON and act on it

Includes:

• README with full explanation and examples
• SPEC.md as a minimal technical contract
• AGENTS.md with explicit agent behavior and attribution rules

Reference implementation:
https://github.com/threadbaire/server

Spec:
https://github.com/threadbaire/rundownapi