# Automático (via git hook)
git commit -m "Add endpoint"
# Hook pergunta se quer atualizar docs

# Manual
./scripts/auto-update-docs.sh --last-commit

# Via Makefile
make update-docs

Atualizar docs/api.md para refletir mudanças no router '{router_name}' ({router_file}).

Endpoints encontrados:
{endpoints_list}

Para cada endpoint novo/modificado:
1. Adicione/atualize descrição do que faz
2. Liste parâmetros (query, path, body) com tipos
3. Exemplo de request (curl ou httpie)
4. Exemplo de response (JSON)
5. Códigos de status possíveis (200, 201, 404, etc.)

IMPORTANTE:
- Mantenha formato existente em docs/api.md
- NÃO remova outros endpoints já documentados
- Apenas adicione/atualize seção do router '{router_name}'
- Use exemplos reais baseados nos schemas Pydantic do router

Atualizar docs/architecture.md para refletir mudanças no service '{service_class}' ({service_file}).

Verifique e atualize:
1. O service está listado na seção 'Service Layer'?
2. Responsabilidades estão documentadas corretamente?
3. Dependências (repositories, infra clients) estão corretas?
4. Fluxo de dados está atualizado?

Se necessário:
- Atualize diagramas ASCII-art mostrando fluxo
- Adicione service à tabela de services
- Documente novos métodos principais públicos

IMPORTANTE:
- Preserve estrutura e conteúdo existente
- Apenas adicione/atualize seção relacionada a '{service_class}'
- Mantenha consistência com outros services documentados

Atualizar docs/database.md para refletir mudanças no model ORM ({model_file}).

Classes detectadas: {classes}

Para cada tabela:
1. Atualize schema (colunas, tipos, constraints)
2. Documente relacionamentos (FK, One-to-Many, Many-to-Many)
3. Adicione índices se houver
4. Marque campos obrigatórios (NOT NULL) vs opcionais

IMPORTANTE:
- Use schema REAL do banco (analise o código SQLAlchemy Column())
- Mantenha formato de tabela markdown existente
- NÃO remova outras tabelas já documentadas
- Se campos foram removidos do código, remova da doc também

Atualizar docs/architecture.md para refletir mudanças na página '{page_name}' ({page_file}).

Página: {page_name}
Rota inferida: {route}

Verifique e atualize:
1. Tabela de rotas (path, componente, descrição)
2. Componentes principais usados pela página
3. Hooks utilizados (useQuery, useMutation, custom hooks)
4. Fluxo de dados (API calls, state management)

IMPORTANTE:
- Mantenha formato existente
- NÃO remova outras páginas
- Se for nova página, adicione descrição clara do propósito

Atualizar docs/architecture.md para refletir mudanças no hook '{hook_name}' ({hook_file}).

Hook: {hook_name}

Adicione/atualize na seção 'Custom Hooks':
1. Nome e propósito do hook
2. Parâmetros aceitos (com tipos TypeScript)
3. Retorno (com tipos TypeScript)
4. Exemplo de uso em componente

IMPORTANTE:
- Mantenha lista de hooks organizada
- Use formato consistente com hooks existentes

# Verifica sintaxe markdown
markdownlint docs/**/*.md

# Verifica que arquivo foi modificado
git diff docs/

graph TD
    A[Commit código] --> B{Git Hook}
    B --> C[Detecta mudanças]
    C --> D{Afeta docs?}
    D -->|Sim| E[Gera prompts]
    D -->|Não| Z[Fim]
    E --> F[Claude Code]
    F --> G[Valida doc]
    G --> H{Auto-commit?}
    H -->|Sim| I[Commit docs]
    H -->|Não| J[Revise manual]
    I --> Z
    J --> Z

# 1. Adiciona endpoint em router
vim src/synth_lab/api/routers/research.py

# 2. Commit
git add src/synth_lab/api/routers/research.py
git commit -m "feat: add GET /research/batch endpoint"

# 3. Hook detecta mudança
📚 SUGESTÃO: Atualizar documentação
...
Escolha (1/2/3): 1

# 4. Script gera prompt e chama Claude Code
📡 Routers modificados detectados
📝 Prompts gerados: 1

Prompt 1/1 - Tipo: api
Doc: docs/api.md
...

Executar este prompt com Claude Code? (y/n) y

🤖 Executando Claude Code...
✅ Claude Code executado com sucesso
📖 Validando atualização de doc...
✅ docs/api.md atualizado com sucesso

# 5. Revisa e commita
git diff docs/api.md
git commit -m "docs: add GET /research/batch to API docs"

# 1. Cria novo service
vim src/synth_lab/services/email_service.py

# 2. Commit
git commit -m "feat: add email notification service"

# 3. Hook sugere atualizar docs
⚙️  Services modificados detectados
...

# 4. Claude Code atualiza docs/architecture.md
# Adiciona EmailService na seção de services
# Documenta responsabilidades
# Atualiza diagrama de camadas

./scripts/auto-update-docs.sh --last-commit --dry-run

# Output:
📚 Auto-Update Docs com Claude Code

Arquivos modificados:
  - src/synth_lab/api/routers/synthetics.py

🔍 Analisando mudanças...
📡 Routers modificados detectados

📝 Prompts gerados: 1

════════════════════════════════════════
Prompt 1/1 - Tipo: api
Doc: docs/api.md
════════════════════════════════════════

Atualizar docs/api.md para refletir mudanças no router 'synthetics'...
[prompt completo]

[DRY-RUN] Pulando execução