Documentação para agentes

Este é um portfólio pessoal. Tudo que um cliente automatizado consegue ler aqui já está publicado como HTML na mesma origem — as interfaces legíveis por máquina existem para que um agente não precise raspar uma página estilizada para responder a uma pergunta sobre o trabalho desta pessoa.

Todas as representações são geradas a partir de um único dataset tipado no repositório. A página HTML, o equivalente em Markdown, a API JSON, a descrição OpenAPI, as ferramentas MCP e o JSON-LD leem da mesma fonte, então não podem discordar sobre um fato.

HTML e Markdown usam URLs distintas para manter inequívoco o comportamento de caches intermediários. Use `/api/v1/markdown/en` ou `/api/v1/markdown/pt` para Markdown.

As rotas explícitas tornam a representação retornada independente dos cabeçalhos da requisição.

Pública, anônima e somente leitura. As respostas são `{ data, meta }`; `meta.contentRevision` é um digest do conteúdo, então um cliente consegue saber se sua cópia em cache continua atual sem comparar payloads.

Todos os endpoints aceitam `?locale=en|pt`, com padrão `en`. Um idioma não reconhecido recebe `400` em vez de um fallback silencioso. Slugs de projeto inexistentes retornam `404` com a lista de slugs reais. Métodos não suportados retornam `405` com um cabeçalho `Allow`.

O caminho da API carrega a versão maior (`/api/v1`). `meta.schemaVersion` carrega o semver do payload: um incremento menor adiciona campos, um maior altera ou remove. Slugs de projeto são identificadores estáveis e nunca são reaproveitados para outro projeto.

`meta.updatedAt` é o timestamp de build do deploy em execução, não uma data editada à mão.

O conteúdo só muda quando um novo build é publicado, então os recursos JSON usam `public, max-age=600, s-maxage=3600, stale-while-revalidate=86400` e os documentos de descoberta têm cache mais longo. `/api/health` é `no-store` — um health check em cache reporta a saúde do cache.

Páginas HTML são `private, max-age=0, must-revalidate`. As rotas Markdown explícitas têm cache público e não variam por cabeçalhos da requisição.

O `robots.txt` declara uma única política — `ai-train=no, search=yes, ai-input=yes` — no grupo curinga e, de forma idêntica, em um grupo que nomeia os crawlers de IA conhecidos, porque um crawler obedece apenas ao grupo mais específico que corresponde a ele. Nada é bloqueado: este é um portfólio, e ser encontrado é o objetivo.

Leia isso como: indexe, cite, use para responder perguntas sobre esta pessoa. Nenhuma permissão é concedida para uso como dado de treinamento. O `robots.txt` é uma declaração de preferência para clientes bem-comportados, não um controle de acesso, e não é tratado como tal aqui.

Não há, e isso é uma decisão em vez de uma omissão. Nada aqui é protegido, nada é gravável e nenhuma operação age em nome de alguém — portanto não existe recurso que um authorization server pudesse proteger. Nenhum documento de descoberta OAuth ou OpenID Connect é publicado, porque publicar um anunciaria um fluxo que não existe.

A descoberta MCP está adiada até que o ciclo de vida do transporte e os controles de edge passem por uma auditoria de produção separada. Os endpoints GET somente leitura são cacheáveis e não têm limite separado.

Deliberadamente não implementados: descoberta OAuth e OpenID Connect, metadados de recurso protegido, diretórios de assinatura Web Bot Auth, WebMCP e os protocolos de comércio para agentes. Cada um é inaplicável a um site sem recursos protegidos ou depende de uma especificação instável demais para publicar. O repositório documenta o raciocínio item a item.

Se um endpoint aqui estiver errado, inacessível ou descrever algo de forma imprecisa, o caminho mais rápido é o e-mail — o mesmo endereço publicado na seção de contato do portfólio.