akshat goel — developer resources.

DISCOVERY

• MD/llms.txtConcise map of the site: profile, every project, every notebook post, and the URL of each Markdown and JSON representation.
• MD/llms-full.txtExtended knowledge file: the full profile plus the complete prose of every notebook post and an FAQ, in one document.
• JSON/openapi.jsonOpenAPI 3.1 description of every JSON endpoint on the site, including the structured error schema.
• XML/sitemap.xmlEvery indexable page URL.
• TXT/robots.txtCrawler policy, per user-agent, plus the sitemap pointer.

JSON APIS

• JSON/api/profileStructured identity for Akshat Goel: name, role, bio, links, and content counts.
• JSON/api/projectsEvery project and notebook post as JSON, each with the URL of its Markdown representation.

MARKDOWN

• MD/mdMarkdown 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

• markdown from any url. send Accept: text/markdown and you get text/markdown; charset=utf-8 back, with Vary: Accept. the same document is addressable directly under /md.
• errors are json. every failure under /api returns a stable code, a message, and a hint. never an html page.
• unknown paths 404. never a 200 shell. the body lists the sitemap, llms.txt, and this page.

EXAMPLE

curl -H "Accept: text/markdown" https://www.akshatgoel.com/notes/agent-evals
curl https://www.akshatgoel.com/api/projects
curl https://www.akshatgoel.com/openapi.json