# Akshat Goel — Developer Resources

> Machine-readable representations of this site: JSON APIs, an OpenAPI specification, and a Markdown twin of every page.

## Discovery

- [llms.txt](https://www.akshatgoel.com/llms.txt) — Concise map of the site: profile, every project, every notebook post, and the URL of each Markdown and JSON representation.
- [llms-full.txt](https://www.akshatgoel.com/llms-full.txt) — Extended knowledge file: the full profile plus the complete prose of every notebook post and an FAQ, in one document.
- [OpenAPI specification](https://www.akshatgoel.com/openapi.json) — OpenAPI 3.1 description of every JSON endpoint on the site, including the structured error schema.
- [Sitemap](https://www.akshatgoel.com/sitemap.xml) — Every indexable page URL.
- [robots.txt](https://www.akshatgoel.com/robots.txt) — Crawler policy, per user-agent, plus the sitemap pointer.

## JSON APIs

- [Profile API](https://www.akshatgoel.com/api/profile) — Structured identity for Akshat Goel: name, role, bio, links, and content counts.
- [Projects API](https://www.akshatgoel.com/api/projects) — Every project and notebook post as JSON, each with the URL of its Markdown representation.

## Markdown

- [Markdown mirror](https://www.akshatgoel.com/md) — Markdown twin of every page: /md mirrors the site tree, so /notes/agent-evals is also at /md/notes/agent-evals. The same content is served from the original URL to any client that sends `Accept: text/markdown`.

## Conventions

- Every page answers `Accept: text/markdown` with `text/markdown; charset=utf-8` and `Vary: Accept`.
- Every endpoint under `/api` returns JSON on failure, with a stable `code`, a `message`, and a `hint`.
- Unknown paths return HTTP 404, never a 200 shell.