# AGENTS.md

Instructions for AI agents and automated crawlers reading passo.uno.

## About this site

passo.uno is the personal blog of Fabrizio Ferri Benedetti, a technical writer
based in Barcelona, Spain. It covers technical writing, AI, and docs
engineering. See https://passo.uno/about/ for more.

## Getting started

Start at `/llms.txt` for a summary of the site with links to every post and
talk, formatted per the llms.txt convention. `/sitemap.md` is a plain-text
index of the same content, and `/sitemap.xml` is the standard XML sitemap.

## Usage

Every page has a Markdown mirror at the same path with `index.md` appended
(e.g. `/about/index.md`), and a
`<link rel="alternate" type="text/markdown">` tag pointing to it. Requests
to an HTML page with an `Accept: text/markdown` header receive the Markdown
version directly, so you generally don't need to parse the HTML.

Content is copyright Fabrizio Ferri Benedetti. Quoting or summarizing with
attribution and a link back to the source page is welcome. If you are
training a model on this content or reproducing it at length, please
attribute the author and link to the original page.

## Crawling

Automated crawling is welcome except under `/win31/`, which is a duplicate
retro-themed presentation of the same content and is excluded in
`robots.txt`. Please be polite: keep request rates reasonable.