---
title: Projeto existente
description: Como instalar a camada SDD em um repositório brownfield.
context: Sequência de instalação, discovery, adapters e risco.
---

# Projeto existente

Use este caminho quando o projeto já tem código, padrões e documentação próprios.

## 1. Instale em modo compacto

```bash
cd /caminho/do/projeto
sdd init --dry-run
sdd init
```

Revise o plano antes de escrever. Use `--preset` apenas quando a detecção automática não refletir a stack.

## 2. Rode doctors

```bash
sdd doctor
sdd clients doctor --strict
sdd skills doctor --strict
sdd capabilities doctor --targets all
```

## 3. Faça discovery

```bash
sdd discover --name "onboarding inicial"
sdd context recommend
```

O discovery deve registrar stack, comandos, paths, riscos, CI, adapters e lacunas.

## 4. Ajuste `sdd.config.yaml`

Preencha:

- stack real;
- paths de código, teste, docs, migrations e infra;
- comandos de install, lint, typecheck, test e build;
- sistemas de issue, docs, repo, CI e chat;
- providers, modelos, efforts e auth methods;
- regras de risco.

## 5. Materialize contexto sob revisão

```bash
sdd context materialize --name "onboarding inicial" --json
sdd context materialize --name "onboarding inicial" --write
```

O comando aplica apenas blocos gerenciados `sdd-context`, preservando texto humano fora dos marcadores.
