---
title: Manutenção e drift
description: Como manter docs, templates, skills, clients e CLI sincronizados.
context: Rotina operacional para evitar documentação stale.
---

# Manutenção e drift

O `sdd-layer` é declarativo: CLI, templates, skills, clients, schemas e docs precisam contar a mesma história. Drift aparece quando uma superfície muda e as derivadas continuam antigas.

## Rotina curta

```bash
sdd health --json
sdd clients doctor --strict
sdd skills doctor --strict
sdd workflow validate standard-sdd --json
sdd capabilities doctor --targets all
sdd intelligence health --json
cd docs-site
npm run check
```

## Onde corrigir primeiro

| Sintoma | Fonte provável | Corrigir em |
|---|---|---|
| Comando novo sem docs | CLI mudou | `src/main.rs` e `docs-site/content/docs/reference/command-map.md` gerado |
| Skill divergente entre clients | Mirror desatualizado | `.agents/skills/` e `templates/skill-catalog.yaml` |
| Workflow falha em runtime | DSL ou catálogo mudou | `templates/workflows/*.yaml` |
| Página do site stale | Docs editoriais não acompanharam contrato | `docs-site/content/docs/` |
| Context Pack stale | Índice derivado antigo | `sdd context build --write` |
| `missing-memory` ou `stale-learning` | Memória operacional ausente/obsoleta | `sdd intelligence repair --name "<ciclo>" --json` |
| Readiness incerto em client MCP | Sinais espalhados entre health, workflow e quality | `sdd_readiness_summary` |

## Regra de manutenção

Toda mudança de contrato precisa responder:

- Qual é a fonte canônica?
- Quais superfícies derivadas mudam?
- Qual comando prova sincronização?
- Qual página ensina o uso?
- Qual reparo explícito resolve drift derivado sem alterar a fonte canônica?

Sem essas respostas, a mudança ainda não está pronta para release.
