Offside.Tool gera catálogos de erro e instala skills de agente para que assistentes de código trabalhando no seu repositório conheçam as convenções do Offside.
dotnet tool install -g Offside.Tool
A ferramenta tem como alvo net8.0 e faz roll-forward para majors posteriores, então uma máquina com apenas .NET 10 instalado consegue executá-la.
offside init [--dir <caminho>] [--force]
| Opção | Efeito |
|---|---|
--dir <caminho> |
Raiz do projeto de destino. Padrão: diretório atual. |
--force |
Sobrescreve arquivos existentes. Sem ela, arquivos existentes são preservados. |
offside --help imprime o mesmo resumo.
Três skills, em cada um dos três diretórios de agente:
.cursor/skills/offside-setup/ .agents/skills/offside-setup/ .claude/skills/offside-setup/
.cursor/skills/offside-domain/ .agents/skills/offside-domain/ .claude/skills/offside-domain/
.cursor/skills/offside-aspnet/ .agents/skills/offside-aspnet/ .claude/skills/offside-aspnet/
| Skill | Cobre |
|---|---|
offside-setup |
Integrar o Offside a um projeto existente: pacotes, catálogos, DI, camadas |
offside-domain |
Factories, Custom, regras de Result, escape hatch |
offside-aspnet |
Mapeamento de endpoints, formato da resposta, severidade, sanitização de 500 |
Mais dois templates de catálogo:
errors/errors.json invariante (inglês)
errors/errors.pt-BR.json português do Brasil
Todo caminho escrito é ecoado no stdout, seguido dos comandos de pacote a rodar em seguida.
Sem --force, arquivos existentes são pulados, nunca sobrescritos — rodar offside init duas vezes é inofensivo, e não vai destruir um catálogo que você já traduziu. --force sobrescreve tudo que de outra forma seria pulado, então só use quando quiser as versões originais de volta.
O comando sai com 1 e escreve no stderr quando as skills não são encontradas ou o destino não pode ser escrito; caso contrário, 0.
Nada aqui é obrigatório. A ferramenta é uma conveniência — você pode escrever errors/errors.json à mão a partir do template em Mensagens e culturas e dispensar as skills inteiramente.