GenCodeDoc

🚀 GenCodeDoc

---

⚡ Início Rápido

# 1. Install
cd /path/to/gencodedoc
poetry install

# 2. Initialize your project
poetry run gencodedoc init --preset python

# 3. Create your first snapshot
poetry run gencodedoc snapshot create -m "Initial version" -t v1.0

# 4. Generate documentation (Smart Split)
poetry run gencodedoc doc generate --limit 5000

# 5. Visualize Tree
poetry run gencodedoc tree

🎯 Para Assistentes de IA (Claude/Gemini): Veja Integração MCP

✨ Recursos 🎯 Recursos Principais 📸 Snapshots Inteligentes - Crie snapshots inteligentes com economia de ~70% de espaço via deduplicação SHA256 🔄 Salvamento Automático Inteligente - 3 modos (timer/diff/hybrid) com limites configuráveis 📝 Documentação Bonita - Gere documentação Markdown com realce de sintaxe, árvores de diretórios e divisão inteligente 🔍 Diff Avançado - Compare versões com diffs unificados, JSON ou baseados em AST 🗜️ Armazenamento Eficiente - compressão zstd (~3x de redução) + SQLite com índices otimizados 🎨 Predefinições de Projeto - Pré-configurado para projetos Python, Node.js, Go e Web 🔌 Integração MCP (Model Context Protocol) 26 Ferramentas MCP - Funcionalidade completa da CLI exposta via MCP para Assistentes de IA 3 Transportes - stdio (Gemini CLI) + SSE (Claude Desktop) + API REST Multi-Projeto - Gerencie múltiplos projetos simultaneamente Inteligência de Código - Histórico de arquivos, busca e geração de changelog Status ao Vivo - Estatísticas do projeto em tempo real e gerenciamento de snapshots 📦 Instalação Pré-requisitos Python 3.10+ Poetry (gerenciador de dependências) Instalar Poetry Bash

Linux/macOS

curl -sSL https://install.python-poetry.org | python3 -

Windows (PowerShell)

(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py - Instalar GenCodeDoc Bash

Clone ou navegue até o projeto

cd /home/fkomp/Bureau/oracle/utilitaires/gencodedoc/gencodedoc

Instale as dependências

poetry install

Verifique a instalação

poetry run gencodedoc --help 🎯 Uso 📋 Uso da CLI Inicializar um Projeto Bash

Inicialização básica

gencodedoc init

Com predefinição Python (recomendado para projetos Oracle)

gencodedoc init --preset python

Predefinições disponíveis: python, nodejs, go, web

Gerenciamento de Snapshots Bash

Criar snapshot

gencodedoc snapshot create --message "Feature X completed" --tag v1.0

Listar snapshots

gencodedoc snapshot list --limit 10

Mostrar detalhes do snapshot

gencodedoc snapshot show v1.0

Ver conteúdo do arquivo em versão específica (NOVO)

gencodedoc snapshot cat v1.0 src/main.py

Listar arquivos em um snapshot (NOVO)

gencodedoc snapshot files v1.0 --pattern "*.py"

Comparar versões

gencodedoc snapshot diff v1.0 v2.0

Restaurar snapshot (completo ou parcial)

gencodedoc snapshot restore v1.0 --force gencodedoc snapshot restore v1.0 --filter "src/*.py" # Restauração parcial

Exportar snapshot (NOVO)

gencodedoc snapshot export v1.0 ./dist-v1 --archive # Cria .tar.gz

Excluir snapshot

gencodedoc snapshot delete old-version --force

Limpar dados órfãos (NOVO)

gencodedoc snapshot cleanup Geração de Documentação Bash

Documentação completa

gencodedoc doc generate

Saída personalizada

gencodedoc doc generate --output docs/API.md

Apenas caminhos específicos

gencodedoc doc generate --include src/api/ --include README.md

Pré-visualização da estrutura

gencodedoc doc preview --max-depth 3

Estatísticas do projeto

gencodedoc doc stats Configuração Bash

Visualizar configuração

gencodedoc config show

Editar configuração

gencodedoc config edit

Definir valores específicos

gencodedoc config set autosave.enabled true gencodedoc config set autosave.mode hybrid

Aplicar predefinição

gencodedoc config preset python

Gerenciar regras de ignorar

gencodedoc config ignore --add-dir dist gencodedoc config ignore --add-ext .tmp gencodedoc config ignore --list-all

Predefinições Personalizáveis

As predefinições agora são definidas em arquivos YAML (gencodedoc/config/presets/*.yaml)

e podem ser modificadas diretamente no código-fonte.

Status do Projeto Bash

Mostrar status do projeto

gencodedoc status 🔌 Integração MCP O GenCodeDoc expõe 22 ferramentas poderosas via Model Context Protocol, compatível com Claude Desktop, Gemini CLI e qualquer cliente compatível com MCP.

🎯 Modos de Transporte

Transporte	Caso de Uso	Assistentes de IA	Porta
stdio	Integração CLI	Gemini CLI, scripts personalizados	stdin/stdout
SSE	Aplicativos Web/Desktop	Claude Desktop, UIs web	8000 (HTTP)
REST	Integração de API	Qualquer cliente HTTP	8000 (HTTP)
🚀 Configuração para Gemini CLI (stdio)

1. Encontre o caminho do seu venv do Poetry:

Bash

cd /home/fkomp/Bureau/oracle/utilitaires/gencodedoc/gencodedoc poetry env info --path

Copie o caminho e adicione /bin/python

2. Adicione em ~/.config/gemini-desktop-app/settings.json:

JSON

{ "mcpServers": { "gencodedoc": { "command": "/path/to/your/venv/bin/python", "args": ["-m", "gencodedoc.mcp.server_stdio"], "env": { "PROJECT_PATH": "/home/fkomp/Bureau/oracle/utilitaires/gencodedoc/gencodedoc" } } } } 3. Reinicie o Gemini CLI e pronto! 🎉

🚀 Configuração para Claude Desktop (SSE)

1. Inicie o servidor SSE:

Bash

Terminal 1: Inicie o servidor

poetry run python -m gencodedoc.mcp.server_sse

O servidor roda em http://127.0.0.1:8000

2. Adicione à configuração do Claude Desktop:

Localização:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json Configuração:

JSON

{ "mcpServers": { "gencodedoc": { "url": "http://127.0.0.1:8000/mcp/sse", "transport": "sse", "description": "GenCodeDoc - Smart documentation and versioning" } } } 3. Reinicie o Claude Desktop e o servidor deve permanecer em execução!

🚀 API REST Bash

Inicie o servidor REST

poetry run python -m gencodedoc.mcp.server

Endpoints disponíveis

GET http://127.0.0.1:8000/ # Informações do servidor GET http://127.0.0.1:8000/mcp/tools # Listar ferramentas POST http://127.0.0.1:8000/mcp/execute # Executar ferramenta 🛠️ Ferramentas MCP (26 Ferramentas)

🧠 Inteligência de Código (3 ferramentas)

Ferramenta	Descrição	Parâmetros Principais
get_file_history	Rastrear alterações de arquivos entre versões	file_path
search_snapshots	Buscar texto em todos os snapshots	query, case_sensitive, file_filter
generate_changelog	Gerar Keep-a-Changelog	from_ref, to_ref

📸 Gerenciamento de Snapshots (11 ferramentas)

Ferramenta	Descrição	Parâmetros Principais
create_snapshot	Criar um novo snapshot	message, tag, include_paths
list_snapshots	Listar todos os snapshots	limit, include_autosave
get_snapshot_details	Obter informações completas do snapshot	snapshot_ref
restore_snapshot	Restaurar um snapshot (completo ou parcial)	snapshot_ref, force, file_filters
restore_files	Restaurar arquivos específicos	snapshot_ref, file_filters
delete_snapshot	Excluir um snapshot	snapshot_ref
diff_versions	Comparar duas versões	from_ref, to_ref, format, file_filters
get_file_at_version	Obter conteúdo de um único arquivo	snapshot_ref, file_path
list_files_at_version	Listar arquivos em um snapshot	snapshot_ref, pattern
export_snapshot	Exportar snapshot para pasta/arquivo	snapshot_ref, output_path, archive
cleanup_orphaned_contents	Limpar dados não utilizados	none

📝 Documentação (3 ferramentas)

Ferramenta	Descrição	Parâmetros Principais
generate_documentation	Gerar documentação Markdown	output_path, split_limit, ignore_tree_patterns
preview_structure	Mostrar árvore de diretórios	max_depth, ignore_add, limit, page
get_project_stats	Obter estatísticas do projeto	none

🎯 Gerenciamento de Projetos (2 ferramentas)

Ferramenta	Descrição	Parâmetros Principais
init_project	Inicializar gencodedoc	project_path, preset
get_project_status	Obter status do projeto	project_path

⚙️ Configuração (4 ferramentas)

Ferramenta	Descrição	Parâmetros Principais
get_config	Visualizar configuração	project_path
set_config_value	Modificar valor de configuração	key, value
apply_preset	Aplicar configuração predefinida	preset (python/nodejs/go/web)
manage_ignore_rules	Gerenciar regras de ignorar	add_dir, add_file, add_ext, list_all

🔄 Salvamento Automático (3 ferramentas)

Ferramenta	Descrição	Parâmetros Principais
start_autosave	Iniciar versionamento automático	project_path, mode
stop_autosave	Parar versionamento automático	project_path
get_autosave_status	Obter status de todos os salvamentos automáticos	none

---

🤝 Contribuindo Contribuições são bem-vindas! 🎉

🐛 Reporte bugs via GitHub Issues 💡 Sugira recursos via Discussions 🔧 Envie Pull Requests

Fluxo de trabalho de desenvolvimento:

1. Faça um fork do repositório
2. Crie uma branch de recurso (git checkout -b feature/amazing)
3. Faça suas alterações
4. Execute os testes (make test)
5. Envie o PR

📄 Licença Licença MIT - Veja o arquivo LICENSE

🐛 Problemas: GitHub Issues 💬 Discussões: GitHub Discussions 🌐 Site: esprit-artificiel.com 📧 E-mail: support@esprit-artificiel.com

🤖 "Inicie o salvamento automático em modo híbrido para este projeto" → Chama: start_autosave(project_path="...", mode="hybrid")

🤖 "Pare todos os salvamentos automáticos e mostre-me o status deles" → Chama: stop_autosave(...) + get_autosave_status() ⚙️ Configuração Arquivo de Configuração (.gencodedoc.yaml) YAML

project_name: "my-project"

Arquivos/diretórios para ignorar

ignore: dirs: - node_modules - venv - .venv - pycache - .git - dist - build files: - "*.log" - package-lock.json - .DS_Store extensions: - .pyc - .pyo - .exe - .jpg - .png - .pdf patterns: [] # Padrões estilo gitignore

Salvamento automático inteligente

autosave: enabled: false # Defina como true para ativar mode: hybrid # timer | diff | hybrid (recomendado)

Modo timer: intervalo fixo

timer: interval: 300 # segundos (5 minutos)

Modo diff: baseado em limite

diff_threshold: threshold: 0.05 # Salvar se 5% dos arquivos mudaram check_interval: 60 # Verificar a cada 60 segundos ignore_whitespace: true ignore_comments: false

Modo híbrido: combina timer + diff (RECOMENDADO)

hybrid: min_interval: 180 # Mínimo de 3 minutos entre salvamentos max_interval: 600 # Máximo de 10 minutos entre salvamentos threshold: 0.03 # Salvar se 3% dos arquivos mudaram

Política de retenção

retention: max_autosaves: 50 # Manter no máximo 50 salvamentos automáticos compress_after_days: 7 # Comprimir após 7 dias delete_after_days: 30 # Excluir após 30 dias keep_manual: true # Sempre manter snapshots manuais

Saída de documentação

output: default_name: "{project}doc{date}.md" include_tree: true include_code: true tree_full_code_select: false # Árvore completa, apenas código selecionado language_detection: true max_file_size: 1000000 # Máximo de 1 MB por arquivo

Formato de saída do diff

diff_format: default: unified # unified | json | ast unified_context: 3 json_include_content: true ast_enabled: false # Experimental

Armazenamento

storage_path: .gencodedoc compression_enabled: true compression_level: 3 # 1-22 (3 = bom equilíbrio) Comandos Rápidos de Configuração Bash

Ativar salvamento automático

gencodedoc config set autosave.enabled true gencodedoc config set autosave.mode hybrid

Ajustar limites do salvamento automático

gencodedoc config set autosave.hybrid.min_interval 300 gencodedoc config set autosave.hybrid.max_interval 1800 gencodedoc config set autosave.hybrid.threshold 0.03

Adicionar regras de ignorar

gencodedoc config ignore --add-dir dist gencodedoc config ignore --add-ext .tmp gencodedoc config ignore --add-file debug.log 🏗️ Arquitetura text

┌─────────────────────────────────────────────────────────────┐ │ GenCodeDoc System │ └─────────────────────────────────────────────────────────────┘

┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ CLI (Typer) │ │ MCP stdio │ │ MCP SSE/REST │ │ │ │ (Gemini CLI) │ │ (Claude/Web) │ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │ │ │ └─────────────────┼──────────────────┘ │ ┌──────────▼──────────┐ │ Core Managers │ ├─────────────────────┤ │ • ConfigManager │ │ • VersionManager │ │ • DocGenerator │ │ • AutosaveManager │ └──────────┬──────────┘ │ ┌───────────────┼───────────────┐ │ │ │ ┌────▼─────┐ ┌─────▼──────┐ ┌────▼──────┐ │ Scanner │ │ Differ │ │ Storage │ │ │ │ │ │ │ │ • Scan │ │ • Unified │ │ • SQLite │ │ • Filter │ │ • JSON │ │ • zstd │ │ • Detect │ │ • AST │ │ • Dedup │ └──────────┘ └────────────┘ └───────────┘

┌─────────────────────────────────────────────────────────────┐ │ Storage Layer │ ├─────────────────────────────────────────────────────────────┤ │ .gencodedoc/ │ │ ├── gencodedoc.db ← SQLite (metadata) │ │ │ ├── snapshots ← Snapshot records │ │ │ ├── snapshot_files ← File entries │ │ │ ├── file_contents ← Deduplicated content (SHA256) │ │ │ └── autosave_state ← Autosave status │ │ └── config/ ← Configuration files │ └─────────────────────────────────────────────────────────────┘

Principais recursos: • 🔑 Deduplicação SHA256 → ~70% de economia de espaço • 🗜️ Compressão zstd → ~3x de redução de tamanho • 📊 SQLite indexado → Consultas rápidas • 🔄 Observador watchdog → Monitoramento de arquivos em tempo real Estrutura do Projeto text

gencodedoc/ ├── gencodedoc/ # Código-fonte │ ├── cli/ # Comandos CLI (Typer) │ │ ├── main.py # Ponto de entrada │ │ ├── snapshot_cmd.py │ │ ├── doc_cmd.py │ │ ├── config_cmd.py │ │ └── mcp_cmd.py │ ├── core/ # Lógica de negócio │ │ ├── config.py # Gerenciamento de configuração │ │ ├── scanner.py # Varredura e filtragem de arquivos │ │ ├── versioning.py # Gerenciamento de snapshots │ │ ├── documentation.py │ │ ├── differ.py # Comparação de versões │ │ └── autosave.py # Salvamento automático inteligente │ ├── mcp/ # Servidores MCP │ │ ├── server_stdio.py # Transporte stdio │ │ ├── server_sse.py # Transporte SSE │ │ ├── server.py # Transporte REST │ │ └── tools.py # Definições de ferramentas │ ├── models/ # Modelos de dados (Pydantic) │ │ ├── config.py │ │ └── snapshot.py │ ├── storage/ # Armazenamento e compressão │ │ ├── database.py # Gerenciador SQLite │ │ ├── snapshot_store.py │ │ └── compression.py # Compressão zstd │ └── utils/ # Utilitários │ ├── filters.py │ ├── formatters.py │ └── tree.py ├── config/ # Predefinições de configuração │ └── presets/ │ ├── python.yaml │ ├── nodejs.yaml │ ├── go.yaml │ └── web.yaml ├── tests/ # Testes unitários ├── pyproject.toml # Configuração do Poetry ├── Makefile # Comandos de desenvolvimento └── README.md 🔬 Recursos Avançados 🎯 Deduplicação Inteligente (~70% de economia) O GenCodeDoc usa deduplicação baseada em SHA256:

✅ Arquivos idênticos entre snapshots são armazenados uma única vez ✅ Economia massiva de espaço (~70% em projetos reais) ✅ Compressão zstd para ~3x de redução adicional ✅ SQLite otimizado com índices

Exemplo: 10 snapshots de um projeto de 100 MB

Sem deduplicação: 1 GB Com GenCodeDoc: ~300 MB (dedup + compressão) 🔄 Modos de Salvamento Automático Modo Como funciona Melhor para timer Salvar a cada X segundos Desenvolvimento contínuo diff Salvar quando X% for alterado Projetos críticos hybrid ⭐ Intervalo mínimo/máximo + limite Uso geral (recomendado) Exemplo de modo híbrido:

YAML

hybrid: min_interval: 300 # Não salvar mais de uma vez a cada 5 min max_interval: 1800 # Forçar salvamento após 30 min threshold: 0.03 # OU se 3% dos arquivos forem alterados 📊 Formatos de Diff Formato Descrição Caso de Uso unified Diff estilo Git Leitura humana json Dados estruturados Automação ast Diff semântico Análise de código (experimental) Bash

Diff unificado (padrão)

gencodedoc snapshot diff v1.0 v2.0

JSON para scripts

gencodedoc snapshot diff v1.0 v2.0 --format json > changes.json

AST (semântico)

gencodedoc snapshot diff v1.0 v2.0 --format ast 🐛 Solução de Problemas Problemas Comuns 1️⃣ Erro MCP: notifications/initialized Sintoma: Erro na inicialização do MCP:

text

MCP ERROR: Unknown method: notifications/initialized Causa: O protocolo MCP envia notificações que versões mais antigas não tratavam.

Solução: ✅ Já corrigido na versão atual. O servidor agora ignora silenciosamente as notificações do MCP.

2️⃣ Snapshots criados no local errado Sintoma: Todos os snapshots vão para o diretório do próprio gencodedoc em vez do projeto de destino.

Causa: project_path não era extraído corretamente dos parâmetros de tools/call do MCP.

Solução: ✅ Já corrigido. O servidor agora extrai corretamente o project_path dos argumentos.

Verifique a correção:

Bash

Isso deve criar o snapshot em /path/to/project, não em gencodedoc

/gencodedoc create_snapshot project_path=/path/to/project tag=test 3️⃣ Erros de validação Zod (id=null) Sintoma:

text

Error: Expected string or number, received null (path: ["id"]) Causa: Respostas JSON-RPC com "id": null em vez de "id": 0.

Solução: ✅ Já corrigido. Todas as respostas de erro agora usam request_id ou 0.

4️⃣ Arquivos não varridos corretamente Sintoma: O snapshot mostra um número errado de arquivos ou arquivos de um diretório errado.

Causa: snapshot_store.py usava caminhos relativos em vez de absolutos.

Solução: ✅ Já corrigido. O SnapshotStore agora recebe e usa project_path para caminhos absolutos de arquivos.

5️⃣ Banco de dados não inicializado Sintoma:

text

Error: no such table: snapshots Causa: Projeto não inicializado antes de criar o snapshot.

Solução:

Bash

Sempre inicialize primeiro (cria as tabelas)

gencodedoc init --preset python

Ou via MCP

/gencodedoc init_project project_path=/path/to/project preset=python 6️⃣ Salvamento automático não inicia Sintoma: A ferramenta start_autosave não funciona.

Causa: O salvamento automático exige que o servidor MCP permaneça em execução (é um processo em segundo plano).

Solução:

Modo stdio: O servidor executa por solicitação → o salvamento automático para quando a solicitação termina Modo SSE/REST: ✅ Servidor persistente → o salvamento automático funciona! Recomendado: Use SSE/REST para salvamento automático, stdio para comandos pontuais.

Modo de Depuração Bash

Ativar log detalhado (se implementado)

export GENCODEDOC_DEBUG=1 poetry run gencodedoc snapshot create --message "test"

Verificar o banco SQLite diretamente

sqlite3 /path/to/project/.gencodedoc/gencodedoc.db ".tables" sqlite3 /path/to/project/.gencodedoc/gencodedoc.db "SELECT * FROM snapshots;" 🧪 Testes Bash

Executar todos os testes

poetry run pytest

Com cobertura

poetry run pytest --cov=gencodedoc --cov-report=html

Testes específicos

poetry run pytest tests/test_scanner.py -v poetry run pytest tests/test_versioning.py -v poetry run pytest tests/test_mcp.py -v

Modo de observação (requer pytest-watch)

poetry run ptw 🛠️ Desenvolvimento Configurar Ambiente de Desenvolvimento Bash

Instalar com dependências de desenvolvimento

poetry install

Ativar ambiente virtual

poetry shell

Instalar hooks de pre-commit (se configurados)

pre-commit install Comandos do Makefile Bash

make help # Mostrar todos os comandos make install # Instalar dependências make test # Executar testes make test-cov # Testes com cobertura make lint # Verificar qualidade do código make format # Formatar código (Black) make clean # Remover arquivos temporários make docs # Gerar documentação make serve-mcp-sse # Iniciar servidor SSE make serve-mcp-stdio # Iniciar servidor stdio make all # Lint + teste + build Estilo de Código Formatador: Black (comprimento de linha 100) Linter: Ruff Anotações de tipo: Obrigatórias com Pydantic Docstrings: Estilo Google 🎯 Casos de Uso 1️⃣ Documentação Contínua Bash

Inicializar com salvamento automático

gencodedoc init --preset python gencodedoc config set autosave.enabled true gencodedoc config set autosave.mode hybrid

A documentação está sempre atualizada

gencodedoc doc generate --output docs/API.md 2️⃣ Refatoração Segura Bash

Snapshot antes de mudanças críticas

gencodedoc snapshot create
--message "Antes de refatorar o sistema de autenticação"
--tag before-refactor

... fazer as mudanças ...

Snapshot depois

gencodedoc snapshot create
--message "Depois da refatoração - testes passando"
--tag after-refactor

Comparar

gencodedoc snapshot diff before-refactor after-refactor

Reverter se necessário

gencodedoc snapshot restore before-refactor --force 3️⃣ Documentação Seletiva de API Bash

Documentar apenas módulos específicos

gencodedoc doc generate
--include src/api/
--include src/models/
--include README.md
--output docs/API_Reference.md 4️⃣ Fluxo de Trabalho Assistido por IA (Gemini/Claude) Bash

1. Configurar MCP (uma vez)

Adicione gencodedoc à configuração do seu assistente de IA

2. Usar linguagem natural

"Crie um snapshot com a tag v2.0" "Compare v1.0 e v2.0" "Mostre-me as estatísticas do projeto" "Inicie o salvamento automático no modo híbrido" "Gere documentação completa"

A IA chama automaticamente as ferramentas MCP corretas! 🎉

🌟 Roadmap Integração com Git (snapshot automático no commit) Backup em nuvem (S3, GCS) Painel web Diff semântico baseado em AST (implementação completa) Predefinições multilíngues (Rust, Java, C++) Criptografia de snapshots Recursos colaborativos (snapshots compartilhados) 📄 Licença Licença MIT - Consulte o arquivo LICENSE

🤝 Contribuindo Contribuições são bem-vindas! 🎉

🐛 Reporte bugs via GitHub Issues 💡 Sugira recursos via Discussions 🔧 Envie Pull Requests

Fluxo de trabalho de desenvolvimento:

Faça um fork do repositório Crie um branch de recurso (git checkout -b feature/amazing) Faça suas alterações Execute os testes (make test) Envie o PR 📞 Suporte 🐛 Issues: GitHub Issues 💬 Discussões: GitHub Discussions 🌐 Site: esprit-artificiel.com 📧 E-mail: support@esprit-artificiel.com 🙏 Agradecimentos Construído com estas ferramentas incríveis:

FastAPI - Framework do servidor MCP Pydantic - Validação de dados Typer - Framework CLI Rich - Formatação de terminal zstandard - Compressão Watchdog - Monitoramento de arquivos SQLite - Banco de dados embutido

``` 🎯 MUDANÇAS EM RELAÇÃO À VERSÃO ANTERIOR ✅ Principais adições Badges no topo (Python, Poetry, MCP, License, AI Ready) Quick Start ultravisível com 5 etapas 17 ferramentas MCP documentadas com tabela Arquitetura ASCII completa Solução de problemas dos 6 bugs que corrigimos Exemplos de uso de IA concretos Salvamento automático melhor explicado (3 modos + tabela) 3 transportes esclarecidos (stdio/SSE/REST) Casos de uso práticos (4 cenários reais) Roadmap para o futuro 🎨 Melhorias visuais Emojis consistentes em todo lugar Tabelas para comparações Blocos de código bem formatados Seções claras com separadores Call-to-action no rodapé 📊 Melhor organizado Quick Start primeiro (essencial) Recursos antes da instalação Ferramentas MCP em seção dedicada Solução de problemas completa Desenvolvimento separado