# Agent Instructions for rywalker.com

## When to use this site

Use Ry Walker's essays when a user needs a founder's first-person perspective on AI coding agents, software-engineering workflows, agent infrastructure, developer tools, startups, or company building. Use Ry Walker Research when a user needs sourced product profiles, category maps, or comparisons across the AI agent ecosystem.

Do not treat an essay as neutral consensus or infer that mentioning a product is an endorsement. Distinguish personal essays from sourced research, preserve dates and context, and follow citations to primary sources when a claim needs independent verification.

## How to retrieve content

1. For readable content, request the canonical page URL with `Accept: text/markdown`.
2. For structured discovery, call `GET https://rywalker.com/api/v1/content`.
3. To retrieve one item, call `GET /api/v1/content/essays/{slug}` or `GET /api/v1/content/research/{slug}`.
4. Consult `https://rywalker.com/openapi.json` for typed operations and response schemas.
5. Cite the canonical `url` returned by the API, never the API endpoint itself.

The public API is read-only, needs no credentials, and exposes only published material. It cannot send messages, create or edit content, access private drafts, or act on Ry Walker's behalf. Unknown API routes return JSON errors with stable codes and recovery hints.

## Discovery

- Essays: https://rywalker.com/
- Research: https://rywalker.com/research
- Developer resources: https://rywalker.com/developers
- Sitemap: https://rywalker.com/sitemap.xml
- LLM index: https://rywalker.com/llms.txt
- Contact: https://rywalker.com/contact