People first. AI native.
Uma é a promessa antiga: desenvolvedor primeiro — docs legíveis, SDK bem tipado, exemplos que rodam. A outra é a consequência inevitável: se a stack é legível pra humano, ela é legível pro agente dele. O resto são detalhes de engenharia.
Não tem AI sem humano primeiro.
A narrativa "AI-ready" virou um chavão. Toda empresa publica um arquivo llms.txt de 200 linhas e se declara pronta pra era dos agentes. Dá pra fazer a lição de casa em uma tarde e marcar posição em marketing.
A gente discorda da premissa. AI-ready de verdade é resultado, não ato. É o que acontece quando, durante seis anos, você tomou cada decisão de arquitetura — de documentação a SDK a exemplos a servidor MCP — pensando num único leitor: o desenvolvedor que vai ler aquilo às duas da manhã, com uma prefeitura bizarra pra integrar.
Esse desenvolvedor, em 2020, era humano. Em 2026, metade do trabalho dele é feito por um agente de IA. A stack boa pra um é a stack boa pro outro. A diferença é só quem lê.
Se a stack precisa ser boa pra pessoa, ela já é boa pra agente.
Quando você otimiza doc pra ser colada num issue do GitHub, ela funciona colada num prompt do Claude. Quando você tipa direito pra IDE autocompletar, o LLM entende. Quando você escreve exemplos que rodam, o agente também roda. Não é dualidade — é coerência.
Desenvolvedor, antes do tráfego
Cada decisão feita pensando em quem vai abrir o repo num sábado tentando emitir a primeira nota:
- 417 páginas em Markdown puro — cola no Notion, no Linear, no editor favorito
- SDK TypeScript nativo, zero runtime deps, types discriminados
- 24 exemplos rodáveis direto do examples/
- Documentação em PT-BR — não assumimos que dev brasileiro precisa ler em inglês
- 14 specs OpenAPI versionadas — single source of truth pros tipos
Agente consegue, porque humano conseguiu
A mesma arquitetura, agora legível pra Claude, Cursor, GPT-5, Gemini:
- Botão "Copiar como Markdown" em todas as 417 páginas
- CLAUDE.md no root do SDK — instruções nativas pra Claude Code
- Skill Claude pré-construída, auto-ativa ao detectar nfe-io
- Servidor MCP oficial em mcp.nfe.io — 3 transportes (stdio, HTTP, Docker)
- Schemas Zod validados, descrições longas pro agente saber quando chamar
Enquanto API fiscal tradicional publicou um llms.txt pra marcar posição, a NFE.io publicou uma plataforma inteira pensada pra agentes — e continuou fazendo o trabalho chato de documentar 4.000 prefeituras brasileiras uma por uma.
Seis anos de decisões. Zero retroatividade.
Cada camada foi construída antes do mercado adotar o termo. Nenhuma foi feita pra responder lançamento de concorrente. O servidor MCP é a consequência mais recente de uma tese que já tinha sido escolhida.
→Docs em Markdown desde o primeiro commit
Decidimos que toda doc viveria como .md puro antes de ser renderizada. Hoje isso chama "LLM-friendly". Na época chamava "dev-friendly". Mesma coisa.
→Pipeline OpenAPI → SDK automático
14 specs YAML como fonte única da verdade. Tipos do SDK TypeScript gerados automaticamente. Impossível divergir spec e código — nenhum contexto pra LLM alucinar.
→SDK v3 com CLAUDE.md no root
Quando Anthropic lançou CLAUDE.md como convenção, nosso SDK já tinha docstrings ricas e arquitetura explícita. Adicionar o arquivo foi uma consequência natural — 78 linhas de instruções nativas.
→Skill Claude pré-construída + botão Copy-as-Markdown
A primeira API fiscal brasileira com skill Claude nativa. Auto-ativa quando o agente detecta nfe-io em package.json. Botão de copiar MD em cada URL da doc.
→Servidor MCP oficial em mcp.nfe.io
A quarta camada da stack AI-native. Primeira API fiscal brasileira com servidor Model Context Protocol hospedado. Três transportes (stdio, HTTP, Docker), cinco tools, autenticação Bearer por cliente, stateless. Conecte Claude Desktop direto.
O que é concreto hoje — verificável em 5 minutos.
Nada aqui é roadmap. É estado atual do repositório, da doc, do npm e do ghcr.io. Clicou, conferiu.
417 páginas em Markdown
Docs.nfe.io serve .md puro em cada URL. Botão "Copy as Markdown" integrado. Pipeline in-house de conversão.
nfe-io v3.1.0 · 126★
TypeScript 5.3+, zero runtime deps, 17 recursos, 7 classes de erro tipadas, CLAUDE.md, 24 exemplos rodáveis.
14 OpenAPI YAML
NFSe, NFe produto e consumidor, CTe, CNPJ, CPF, endereços, cálculo de impostos. Públicas, versionadas, spec-driven dev.
mcp.nfe.io · 5 tools
Servidor MCP oficial. 3 transportes. Multi-arch Docker em ghcr.io. Auth por cliente, stateless, ~$5/mês de hospedagem.
Se você escolhe fornecedor fiscal hoje,
escolhe também a arquitetura AI da sua empresa.
O time que escreve sua próxima integração fiscal é em parte humano, em parte agente. Os dois precisam de uma stack que respeite o tempo deles. A NFE.io respeita.