Uso de IA

IA não é monstro. É como se constrói hoje.

Quase todo mundo já usa IA pra programar, e vai usar cada vez mais. Por isso o Nevext não esconde nem julga: mostra. Em cada projeto aparece quanto foi feito com IA, com quais, como você guiou e quantos tokens gastou. Saber guiar a IA é uma habilidade, e é ela que aparece no seu portfólio.

O Nevext acha a IA no repositório

Com o repositório ligado ao projeto, ninguém precisa dizer se usou IA. Os arquivos que cada ferramenta deixa dizem quais foram usadas (CLAUDE.md e .claude/ do Claude Code, .cursorrules do Cursor, .github/copilot-instructions.md do Copilot, GEMINI.md, AGENTS.md...), e os commits assinados por uma IA ("Co-Authored-By: Claude", o bot do Copilot...) dizem quanto do projeto foi feito com ela. Se está no repositório, foi usada.

O que fica com você, se quiser contar: pra que usou a IA e como guiou o trabalho. Sem repositório, você responde ao publicar.

O tokens.md: o arquivo que vale nos campeonatos

Os tokens gastos são a única coisa que o repositório não mostra sozinho. Por isso existe o tokens.md: um arquivo na raiz do repositório onde a própria IA anota, a cada tarefa, a data, a ferramenta, o modelo, os tokens de entrada e de saída e o que foi feito. O Nevext lê o arquivo e mostra na página do projeto o total, quanto foi em cada ferramenta e em quantas tarefas.

Por que é importante

Nos campeonatos do Nevext não ganha só quem constrói, ganha quem constrói bem: o mesmo resultado gastando menos tokens mostra que você sabe guiar a IA, sem desperdício. O tokens.md é a prova disso, e só vale se acompanhar o projeto desde o começo, porque o histórico não dá pra refazer depois. Comece no primeiro dia, mesmo que ainda não pense em competir.

1. Cole isto na sua IA, no começo do projeto

Funciona com agentes que mexem nos arquivos (Claude Code, Cursor, Copilot, Codex...). Num chat como o ChatGPT, peça a linha no fim de cada conversa e cole no arquivo.

Neste projeto, mantenha um registro do seu uso no arquivo tokens.md, na raiz do repositório (crie se não existir, com a tabela abaixo). Ao terminar cada tarefa, adicione uma linha no fim da tabela com: a data (AAAA-MM-DD), o nome da ferramenta, o modelo, os tokens de entrada e de saída que a tarefa usou e uma frase curta do que foi feito. Se não souber o número exato, use a melhor estimativa que tiver e escreva ~ antes do número. Nunca apague nem altere linhas antigas.

| Data | IA | Modelo | Entrada | Saída | O que foi feito |
|---|---|---|---|---|---|

2. O arquivo fica assim

# Uso de IA

| Data | IA | Modelo | Entrada | Saída | O que foi feito |
|---|---|---|---|---|---|
| 2026-10-01 | Claude Code | claude-sonnet-5-5 | 12.400 | 3.100 | Tela de login |
| 2026-10-03 | ChatGPT | gpt-5 | ~2k | 800 | Entender recursão pro algoritmo de busca |
| 2026-10-05 | Ollama | qwen3 | 30k | 9,5k | Gerar os dados de teste |

Os números podem ter ponto, vírgula, "k" ou "M" (12.400, 12,4k, 1,2M), e ~ quando forem estimados. Linha sem número é ignorada.

3. Publique ou atualize o projeto

Com o repositório ligado ao projeto, o Nevext acha o tokens.md sozinho e atualiza a cada hora.

Os números são de quem?

Do arquivo: o Nevext soma o que a IA registrou, não mede por conta própria. Ferramentas como o Claude Code e o Cursor mostram o gasto exato de cada sessão; nas outras, vale a melhor estimativa, marcada com ~.