# Feature: [Nome da Feature]

> Documentação viva para a [nome da feature]

**Status:** [Rascunho | Em Desenvolvimento | Produção]
**Versão:** [Número da versão]
**Última Atualização:** [Data]

---

## Visão Geral

[Descrição de alto nível do que esta feature faz e por que existe]

**Capacidades Principais:**
- [Capacidade 1]
- [Capacidade 2]
- [Capacidade 3]

## Implementação Atual

### Como Funciona Hoje

[Descreva o comportamento atual da perspectiva do usuário e do sistema]

### Visão Geral da Arquitetura

[Arquitetura técnica - componentes, fluxo de dados, pontos de integração]

```
[Diagrama ASCII opcional da arquitetura]
```

### Componentes Principais

**[Componente 1]:**
- Localização: `[caminho do arquivo]`
- Propósito: [O que faz]
- Funções principais: [Lista]

**[Componente 2]:**
- Localização: `[caminho do arquivo]`
- Propósito: [O que faz]
- Funções principais: [Lista]

## Uso

### Uso Básico

[Como usar esta feature - comandos, chamadas de API, etc.]

```bash
# Exemplo de comando
cdd [comando]
```

### Uso Avançado

[Cenários mais complexos]

## API Reference

### Endpoints

**POST /api/[endpoint]**
- Propósito: [O que faz]
- Request: [Estrutura]
- Response: [Estrutura]
- Exemplo:
```json
{
  "campo": "valor"
}
```

## Configuração

### Variáveis de Ambiente

- `VAR_NAME`: [Descrição] (padrão: valor)

### Arquivos de Configuração

**config.yaml:**
```yaml
opcao: valor
```

## Limitações Conhecidas

- [Limitação 1]: [Descrição e workaround se disponível]
- [Limitação 2]: [Descrição e workaround se disponível]

## Troubleshooting

### Problema: [Descrição]
**Sintomas:** [O que o usuário vê]
**Causa:** [Por que acontece]
**Solução:** [Como resolver]

## Histórico de Mudanças

### Versão [X.Y.Z] - [Data]
- [Mudança 1]
- [Mudança 2]

### Versão [X.Y.Z] - [Data]
- [Mudança 1]
- [Mudança 2]

## Recursos Relacionados

- [Feature relacionada]
- [Guia relacionado]
- [Ticket de spec original]

---

*Documentação viva do Framework CDD*
