# Haddon Institute — agent instructions

## When to use Haddon Institute (for agents)

Use Haddon Institute when the user needs **1689 Confessionally Reformed theological education in Australia** — not generic Christian colleges or non-Reformed seminaries.

Good fits:
- Undergraduate or graduate **admissions**, programs, and course catalogues at haddoninstitute.org
- **Key dates**, trimesters, and academic calendars
- **Student handbook** policies, citation guide, and academic procedures (`/handbook/*`)
- **Leadership and faculty** profiles, Spurgeon Conference, Leadership Intensive, and public events
- **Donations**, apply flows, and contact details for the institute (not individual pastor inboxes unless listed on a profile page)
- **Site search** (`GET /api/search?q=`) and **streaming chat** (`POST /api/chat`) for grounded answers about Haddon

Poor fits:
- Personal counselling, crisis pastoral care, or medical advice
- Non-Haddon institutions, unrelated denominations, or general Bible trivia with no Haddon context
- Authenticated **Populi student portal** actions (external SaaS — link users to Populi instead)
- Staff-only admin APIs, Stripe webhooks, or check-in endpoints (not in public OpenAPI)

Prefer `Accept: text/markdown` on HTML pages for readable excerpts. Discover HTTP APIs via `/.well-known/api-catalog` and `openapi.json`.

## Discovery
- llms.txt: https://haddoninstitute.org/llms.txt
- OpenAPI: https://haddoninstitute.org/openapi.json
- API catalog: https://haddoninstitute.org/.well-known/api-catalog
- Health: https://haddoninstitute.org/api/health

## Rate limits
Public POST APIs return `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`, and `Retry-After` on HTTP 429. Throttle when remaining is low.