---
title: "Agent Usage Guide"
type: guide
id: "agent-usage-guide"
description: "Concrete fetch patterns for AI agents using AI Future Ready: discovery, raw markdown, schema, per-item JSON, recommendations, changes, and hashes."
last_updated: "2026-04-24"
tags:
- "agents"
- "api"
- "discovery"
- "markdown"
- "schema"
---

# Agent Usage Guide

This site is meant to be read by agents directly. Start with discovery, then choose the smallest endpoint that answers your task.

## 1. Discover the site

```bash
curl https://ai-future-ready.com/.well-known/ai.json
curl https://ai-future-ready.com/llms.txt
```

Use `/.well-known/ai.json` to find available protocols. Use `/llms.txt` when you want a compact content map.

## 2. Fetch the whole corpus

```bash
curl https://ai-future-ready.com/llms-full.txt
```

Use this when you want a single-file snapshot for indexing, embedding, or offline reasoning.

## 3. Fetch one content item as markdown

```bash
curl https://ai-future-ready.com/content/models/claude-opus-4.6.md
```

The markdown file is canonical. It includes YAML frontmatter and body text in one self-contained document.

## 4. Fetch one content item as JSON

```bash
curl https://ai-future-ready.com/api/v1/models/claude-opus-4.6.json
```

Use per-item JSON when you need typed metadata, generated relationship data, content hashes, and the markdown body without parsing frontmatter yourself.

## 5. Learn the schema

```bash
curl https://ai-future-ready.com/api/v1/schema.json
```

Use the schema endpoint before assuming field names. It lists observed fields, value types, coverage, examples, and generated fields.

## 6. Search by structured index

```bash
curl https://ai-future-ready.com/search-index.json
```

Use the search index for lightweight discovery across titles, descriptions, tags, providers, routes, hashes, and generated relationships.

## 7. Get recommendations

```bash
curl https://ai-future-ready.com/api/v1/recommend.json
curl https://ai-future-ready.com/api/v1/recommend/coding.json
curl https://ai-future-ready.com/api/v1/recommend/cheap.json
curl https://ai-future-ready.com/api/v1/recommend/local.json
curl https://ai-future-ready.com/api/v1/recommend/agentic.json
```

Use recommendation endpoints when your task is "choose the best model for X" rather than "read every model page."

## 8. Track changes

```bash
curl "https://ai-future-ready.com/api/v1/changes.json?since=2026-04-01"
curl "https://ai-future-ready.com/api/v1/changes.json?type=model"
curl https://ai-future-ready.com/feed.json
```

Use `changes.json` for queryable deltas. Use `feed.json` or `feed.xml` for feed readers and polling workflows.

## 9. Verify cached content

Every generated JSON item includes:

```json
{
"content_hash": "sha256-of-raw-markdown",
"sha256": "same-value"
}
```

Compare this value against your cached copy before re-reading large content.

## 10. Common workflows

Find the best model for coding:

```bash
curl https://ai-future-ready.com/api/v1/recommend/coding.json
```

Fetch details for the top result:

```bash
curl https://ai-future-ready.com/api/v1/models/claude-opus-4.6.json
```

Check whether content changed since your last crawl:

```bash
curl "https://ai-future-ready.com/api/v1/changes.json?since=2026-04-10"
```

Fetch raw source for citation or summarization:

```bash
curl https://ai-future-ready.com/content/models/claude-opus-4.6.md
```

Agent Usage Guide

This site is meant to be read by agents directly. Start with discovery, then choose the smallest endpoint that answers your task.

1. Discover the site

curl https://ai-future-ready.com/.well-known/ai.json
curl https://ai-future-ready.com/llms.txt

Use /.well-known/ai.json to find available protocols. Use /llms.txt when you want a compact content map.

2. Fetch the whole corpus

curl https://ai-future-ready.com/llms-full.txt

Use this when you want a single-file snapshot for indexing, embedding, or offline reasoning.

3. Fetch one content item as markdown

curl https://ai-future-ready.com/content/models/claude-opus-4.6.md

The markdown file is canonical. It includes YAML frontmatter and body text in one self-contained document.

4. Fetch one content item as JSON

curl https://ai-future-ready.com/api/v1/models/claude-opus-4.6.json

Use per-item JSON when you need typed metadata, generated relationship data, content hashes, and the markdown body without parsing frontmatter yourself.

5. Learn the schema

curl https://ai-future-ready.com/api/v1/schema.json

Use the schema endpoint before assuming field names. It lists observed fields, value types, coverage, examples, and generated fields.

6. Search by structured index

curl https://ai-future-ready.com/search-index.json

Use the search index for lightweight discovery across titles, descriptions, tags, providers, routes, hashes, and generated relationships.

7. Get recommendations

curl https://ai-future-ready.com/api/v1/recommend.json
curl https://ai-future-ready.com/api/v1/recommend/coding.json
curl https://ai-future-ready.com/api/v1/recommend/cheap.json
curl https://ai-future-ready.com/api/v1/recommend/local.json
curl https://ai-future-ready.com/api/v1/recommend/agentic.json

Use recommendation endpoints when your task is "choose the best model for X" rather than "read every model page."

8. Track changes

curl "https://ai-future-ready.com/api/v1/changes.json?since=2026-04-01"
curl "https://ai-future-ready.com/api/v1/changes.json?type=model"
curl https://ai-future-ready.com/feed.json

Use changes.json for queryable deltas. Use feed.json or feed.xml for feed readers and polling workflows.

9. Verify cached content