# Roslyn Analyzer Doc Rule Change

> Use esta skill ao criar ou atualizar documentacao de regras REL###, ARC### ou TST### em docs/rules e referencias publicas no README.

- Skill: `rodri-oliveira-dev/roslyn-analyzer-doc-rule-change` (Agent Skill)
- Install (CLI): `npx skillmds@latest add rodri-oliveira-dev/roslyn-analyzer-doc-rule-change`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rodri-oliveira-dev/roslyn-analyzer-doc-rule-change/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: rodri-oliveira-dev (https://skillmd.com/u/rodri-oliveira-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rodri-oliveira-dev/roslyn-analyzer-doc-rule-change

---


# Objetivo

Manter a documentacao das regras consistente com o comportamento real dos analyzers, sem prometer heuristicas, configuracoes ou garantias que nao existem no codigo.

# Quando usar

Use esta skill quando a tarefa envolver:

- novo arquivo `docs/rules/<grupo>/<ID>.md`;
- ajuste de comportamento documentado;
- exemplos conformes e nao conformes;
- documentacao de configuracoes por `.editorconfig`;
- atualizacao da tabela de regras no `README.md`.

# Estrutura recomendada

Cada regra deve conter, quando aplicavel:

1. Titulo com ID e resumo.
2. Objetivo.
3. Codigo nao conforme.
4. Codigo conforme.
5. Configuracao.
6. Heuristica.
7. Limitacoes conhecidas.
8. Impacto esperado.

# Regras de escrita

- Documente apenas comportamento implementado.
- Seja claro sobre o que a regra nao valida.
- Use o mesmo ID, titulo e semantica do `DiagnosticDescriptor`.
- Quando a regra aceitar `.editorconfig`, mostre chaves e valores aceitos.
- Quando houver fallback de configuracao, documente o fallback.
- Atualize o README se mudar lista de regras, severidade, categoria, nome publico ou configuracao publica.