# SDRs — Especificações (`sdr-*.md`)

> **Eixo:** `Ambos` — esta pasta abriga SDRs do **Modelo de Serviços de TI** (Eixo 1) e da **Arquitetura Contratual** (Eixo 2). Cada `sdr-*.md` declara seu eixo no campo **Eixo** em metadados. Ver [`glossario-eixos.md`](./glossario-eixos.md) e [`README` da raiz](../README.md).

Esta pasta concentra **orientações e especificações** em arquivos nomeados **`sdr-<NNNN>-<descricao-curta>.md`** (quatro dígitos sequenciais + slug), para o trabalho de contratação e alinhamento com o modelo técnico.

No processo deste repositório, o **SDR** é a camada de referência usada por agentes de IA para criar, revisar e manter os documentos `.md`, os documentos da contratação, as informações auxiliares e o site HTML. Cada `sdr-*` deve dizer ao agente: qual é o escopo do tema, quais regras são canônicas, quais documentos consomem a regra e quais validações impedem divergência.

## Fonte única (o que isso **significa**)

- A regra **“cada coisa em um único lugar”** aplica-se **aqui, entre arquivos `sdr-*.md`**: um tópico / regra **não** deve ser copiado em **dois** SDR ao mesmo tempo como se houvesse dois donos. Usar **um** `sdr-*.md` dono (registrado no [índice](./sdr-0003-indice-fonte-unica.md)) e, nos outros SDRs, **só** links ou uma linha de contexto.
- **Não** implica, por si, que a Proposta, a IMR, o ANS ou o HTML tenham de ser só remissão sem texto — isso seria outra decisão de governança. **Fora** da pasta `SDRs/`, pode haver tanta cópia narrativa quanto fizer sentido.

## Nome dos arquivos

- Formato: **`sdr-<NNNN>-<descricao-curta>.md`** — **NNNN** = `0001`…`9999` (ordem de criação no repositório; novos SDR: maior número existente + 1).
- **Hífens**, minúsculas, sem espaços no slug: ex. `sdr-0020-imr-unidades.md`, `sdr-0021-parque-92-loc.md`
- Cada arquivo agrupa especificações **do mesmo domínio**; o [índice](./sdr-0003-indice-fonte-unica.md) diz **qual** SDR é dono de **qual** tópico (evitando o mesmo tópico em dois SDR).

## O que entra aqui

- Especificações e decisões de desenho que a equipe quiser tratar de forma **disciplinada** entre `sdr-*.md`
- Instruções para agentes gerarem DFD, ETP, TR, ANS, IMR, matriz de riscos, pesquisa de preços, planos de transição, rotinas de fiscalização e páginas HTML
- Regras canônicas que devem ser propagadas para Proposta, ANS, TR, documentos Markdown e site quando o processo pedir alinhamento
- O [índice](./sdr-0003-indice-fonte-unica.md) e as [regras](./REGRAS-AGENTE-E-PROMPTS.md) para respeitar **uma** cópia por tópico **entre SDRs**

## O que **não** fazer (entre SDRs)

- **Não** duplicar o **mesmo** bloco normativo em dois arquivos `sdr-*.md` em paralelo. **Sim** remeter com link ao dono.
- Se houver conflito, **atualizar** o dono único e ajustar remissões nos outros SDR.

## Governança SDR (conformidade, rastreabilidade, anti-vibecoding)

Além da **fonte única entre `sdr-*.md`**, o repositório adota processo para alinhar especificação e código:

| Recurso | Função |
|---------|--------|
| [governance/README.md](./governance/README.md) | Fluxo, relatórios, quando rodar checagens |
| [governance/rules/](./governance/rules/) | Normas detalhadas (conformidade, detector de implementação sem SDR, trava anti-vibecoding) |
| [governance/reports/](./governance/reports/) | Relatórios baseline e datados (conformidade, gaps de vínculo) |
| [templates/](./templates/) | Modelo completo de SDR, proposta de alteração, exceção temporária |
| [traceability.md](./traceability.md) | Tabela mestre Item ↔ arquivo ↔ SDR ↔ requisito ↔ teste |

Regras Cursor: ver [AGENTS.md](../AGENTS.md) (seção SDR / governança).

## Documentos de governação (esta pasta)

| Arquivo | Função |
|----------|--------|
| [REGRAS-AGENTE-E-PROMPTS.md](./REGRAS-AGENTE-E-PROMPTS.md) | Regras (âmbito: unicidade **entre** `sdr-*.md`) |
| [sdr-0003-indice-fonte-unica.md](./sdr-0003-indice-fonte-unica.md) | Mapa: tópico → **um** SDR dono; ligações entre SDRs e documentos relacionados |

## Ligação à árvore do processo

- [README do repositório de contratação](../processo-contratacao/README.md) (seção *SDRs*)
- [INDICE_PROCESSO.md](../processo-contratacao/00_controle_geral/INDICE_PROCESSO.md)

## Modelo técnico (outra pasta)

- Textos longos: `arquitetura-contratual/` (Proposta, IMR, ANS, HTML) — **coexistem** com os SDRs; a relação (quem puxa quem) é do processo, **não** a “única cópia” no sentido deste README (que é **só** entre SDRs).

## Sincronização com o site

- A seção **Especificações (SDR)** em [`modelo-central-servicos.html`](../../arquitetura-contratual/modelo-central-servicos.html#SDRs) inclui: tabela de rastreio, cartões-resumo, e **artigos HTML** (`<article id="sdr-arquitetura">` …) com o **texto integral** de cada `sdr-*.md` principal. Ao alterar esses arquivos Markdown, **atualize os blocos “Texto integral”** (e, se necessário, resumos/índice) no HTML para o site permanecer alinhado.