# madhugb.com developer docs

## Overview

This site is a static personal website with Cloudflare Pages Functions for agent-friendly content negotiation and blog JSON endpoints.

## Primary routes

- `/` — home
- `/about` — profile
- `/projects` — current and past products
- `/work` — work history
- `/now` — current shipping log
- `/writing` — writing index
- `/writing/:slug` — post page
- `/contact` — contact links
- `/developers` — developer portal

## Machine-readable routes

- `/sitemap.xml` — canonical URL discovery
- `/robots.txt` — crawler policy
- `/llms.txt` — compact LLM overview
- `/docs.md` — this document
- `/api/blog` — JSON list of posts
- `/api/blog/:slug` — JSON post detail
- `/blog/posts/:slug.md` — source markdown for public posts

## Quickstart

```bash
curl -s https://madhugb.com/sitemap.xml
curl -s https://madhugb.com/api/blog
curl -s https://madhugb.com/api/blog/hermes-needs-a-window
curl -H 'Accept: text/markdown' https://madhugb.com/about
```

## Errors

Unknown routes return `404 Not Found`. Agent probes should treat that as a real missing resource and use `/sitemap.xml`, `/llms.txt`, or this docs index for discovery.

## Authentication

No public write API exists. No API keys are required for the read-only endpoints.