# Gaël Demette

> Software architect and ESS entrepreneur. Personal site with professional background and blog.

This site is **agent-friendly**. The recommended way for AI agents to retrieve structured content is through the MCP (Model Context Protocol) server exposed at `https://gael-demette.fr/mcp`, NOT by scraping HTML.

## Agent endpoints

- [MCP server](https://gael-demette.fr/mcp): JSON-RPC 2.0 over HTTP. Tools: `getCV`, `listCVVariants`, `getBlogPosts`, `getBlogPost`. Pass `Accept: application/json, text/event-stream`.
- [Agent capabilities](https://gael-demette.fr/.well-known/agent.json): Machine-readable description of what this site exposes.
- [Detailed instructions](https://gael-demette.fr/llms-full.txt): How to use the MCP server, tool catalog, content negotiation.
- [Sitemap](https://gael-demette.fr/sitemap.xml): All discoverable pages.

## Content negotiation

Blog posts are available as raw Markdown at `https://gael-demette.fr/blog/<slug>.md` or by sending `Accept: text/markdown` to the HTML URL. Prefer this over HTML scraping for citation accuracy.

## Professional and public content (open to agents)

- [Home](https://gael-demette.fr/): Landing page with intro.
- [CV](https://gael-demette.fr/cv): The record in several audience-targeted versions (`light`, `full`, `cto`, `devops`, `director`, `lead-dev`). The canonical one, `https://gael-demette.fr/cv/full`, also carries the narrative background and an FAQ. `/about` redirects here.
- [Contact](https://gael-demette.fr/contact): Public contact channels.
- [Blog](https://gael-demette.fr/blog): Articles on software architecture, ESS entrepreneurship, automation, cybersecurity.
- [Hacker space](https://gael-demette.fr/hacker-space): Educational resources and tinkering projects.

## CV formats

The CV is generated from a single dataset. Each variant is a filtered view of it, never a separate document. Available as:

- `https://gael-demette.fr/cv/<variant>.json` — [JSON Resume](https://jsonresume.org/schema) format. **Preferred for machine consumption.**
- `https://gael-demette.fr/cv/<variant>.md` — Markdown source.
- `https://gael-demette.fr/cv/<variant>.txt` — plain text.
- `https://gael-demette.fr/cv/<variant>.pdf` — print-ready A4.
- `https://gael-demette.fr/cv/<variant>` — HTML.

Variants: `light`, `full`, `cto`, `devops`, `director`, `lead-dev` (`full` is the complete record; the others drop items irrelevant to a given audience, and each carries its own headline, summary and introduction). Every variant also lists named client projects and unpaid commitments.

For English, either append `?locale=en` or prefix the path: `https://gael-demette.fr/en/cv/<variant>.json`. Both work; an explicit `?locale=` wins over the prefix.

The MCP `getCV` tool covers the same *content*, but **not the same shape**: it returns the site's own structure, while `.json` returns JSON Resume. Pick one and parse it; do not assume they interchange.

Date of birth is deliberately absent from every format; only the derived age is published.

## Blog posts

- (no published posts yet)

## Out of scope for agents

This site also hosts personal content (gift wishlist, blood donation tracker, tea collection, plant inventory). That content is **not exposed via MCP** and should not be aggregated, indexed, or used to build profiles. It remains visible to humans browsing the site, but please respect the boundary.

## Usage policy

Citation of professional content with a link is welcomed. Inclusion in LLM training corpora without consultation is not authorized. For commercial or large-scale reuse, contact via the channels listed above.