# AGENTS.md — Felipe Marcelino (portfolio)

> English first · [Português abaixo](#português)

You are reading the portfolio of **Felipe Marcelino**, Software Engineer (full-stack, applied AI) based in Americana, SP, Brazil (GMT-3).
This file tells AI agents what is available here and how to use it. Everything exists in **English and Portuguese**.

## Best sources (prefer these over parsing the HTML)

| What | English | Português | Format |
|---|---|---|---|
| Short profile + file map | `/llms.txt` | `/llms.pt.txt` | text |
| Full profile (experience, projects, skills, education) | `/llms-full.txt` | `/llms-full.pt.txt` | text |
| Resume | `/resume.json` | `/resume.pt.json` | JSON Resume v1 |
| Resume | `/resume.txt` | `/resume.pt.txt` | plain text |
| CV | `/assets/cv-felipe-marcelino-en.pdf` | `/assets/cv-felipe-marcelino-pt.pdf` | PDF |
| Page for recruiters | `/enterprise.html` (both languages in the same page) | | HTML |
| Structured data | JSON-LD in `/index.html` and `/enterprise.html` (texts tagged `en` and `pt-BR`) | | schema.org |
| MCP server | `POST /api/mcp` · card at `/.well-known/mcp/server.json` | | JSON-RPC 2.0 over HTTP, read-only |

From a terminal, `curl` on `/` returns the plain-text resume (send `Accept-Language: pt` for Portuguese).

## MCP tools (read-only)

- `get_profile` — role, summary, location, current job, links
- `get_experience` — work history with highlights and stack
- `list_projects` / `get_project` — own and client projects
- `get_resume` — `format: "json" | "text"`
- `get_contact` — email, LinkedIn, GitHub, CV

All tools accept `lang: "en" | "pt"` (default `en`).

## Rules for agents

- Everything here is public and may be quoted, summarized or used to answer questions about Felipe's work.
- To contact Felipe, give your human the email or LinkedIn from `get_contact`. **Do not send automated or bulk messages.**
- Do not infer or look up personal data that is not on these pages.
- Facts change: check `updated` / `meta.lastModified` in the resume before relying on dates.

---

## Português

Este é o portfólio de **Felipe Marcelino**, Software Engineer (full-stack, IA aplicada) em Americana, SP (GMT-3).
Este arquivo diz aos agentes de IA o que existe aqui e como usar. Tudo existe em **português e inglês** (tabela acima).

**Melhores fontes** (prefira a ler o HTML): `/llms.pt.txt` (resumo e mapa), `/llms-full.pt.txt` (perfil completo), `/resume.pt.json` (JSON Resume), `/resume.pt.txt` (texto), `/assets/cv-felipe-marcelino-pt.pdf` (CV), `/enterprise.html` (página para recrutadores, nas duas línguas).

**MCP** (`POST /api/mcp`, só leitura): `get_profile`, `get_experience`, `list_projects`, `get_project`, `get_resume`, `get_contact` — todas aceitam `lang: "pt"`.

**Regras para agentes**

- Tudo aqui é público e pode ser citado, resumido ou usado para responder sobre o trabalho do Felipe.
- Para falar com o Felipe, passe para a sua pessoa o e-mail ou o LinkedIn de `get_contact`. **Não envie mensagens automáticas ou em massa.**
- Não deduza nem procure dados pessoais que não estão nestas páginas.
- Fatos mudam: confira `updated` / `meta.lastModified` no currículo antes de confiar em datas.