---
title: "Guia para agentes"
description: "Como ler ronanrodrigo.dev por máquina: mapa, formatos e contato."
canonical: "https://ronanrodrigo.dev/agent-guide"
markdown: "https://ronanrodrigo.dev/agent-guide.md"
last-updated: "2026-09-09"
---

# Guia para agentes

Este site é agent-readable por desenho: cada página HTML tem um
espelho Markdown (`<url>.md`, `text/markdown`) com frontmatter
(`title`, `description`, `canonical`, `last-updated`) e link
`rel="alternate" type="text/markdown"`.

## Formatos

- `llms.txt` (/llms.txt): resumo do site com links.
- `api-docs` (/api-docs + /api-docs.md): lista estável de endpoints.
- `sitemap.xml` (/sitemap.xml): todas as URLs indexáveis.
- `sitemap.md` (/sitemap.md): mesmo índice em Markdown.
- `index.json` (/notes/index.json): notas no formato legado Jekyll.
- `list-tags.json` (/notes/list-tags.json): tags com 2+ posts.
- Espelhos `.md`: `/notes/<slug>.md`, `/lab/<slug>.md`,
  `/notes.md`, `/lab.md`, `/index.md`, `/agent-guide.md`,
  `/api-docs.md`, `/about.md`, `/contact.md`, `/privacy.md`.
- Servidor MCP (`/mcp`, Streamable HTTP, somente leitura):
  `search_notes`, `read_note`, `list_lab_entries`, `resolve_redirect`.
  Manifesto em `/.well-known/mcp`, cartão em
  `/.well-known/mcp/server-card.json`.

## When to use

Best-fit jobs (all read-only HTTPS GET, no auth; cite the canonical HTML URL):
- Notes by topic/tag: `GET /notes/index.json`, filter with
  `GET /notes/list-tags.json`, read with `GET /notes/<slug>.md`,
  browse `/notes/tags/<tag>`.
- Lab catalog: `GET /lab`, read with `GET /lab/<slug>.md`.
- Profile redirects: `GET /<path>` (e.g. `/univille`,
  `/github`, `/linkedin`) — plain GET that redirects (308); no JSON.

## Quando usar

Os mesmos jobs em PT-BR: notas por tema/tag, catálogo de labs e
redirects de perfil — tudo via HTTPS GET read-only, sem auth.

## Contato

- E-mail: email@ronanrodrigo.dev
- GitHub: https://github.com/ronanrodrigo
- LinkedIn: https://www.linkedin.com/in/ronanrodrigo

## Mapa

- Início: https://ronanrodrigo.dev/
- Notas (120): https://ronanrodrigo.dev/notes
- Lab (14): https://ronanrodrigo.dev/lab