🏗️ Project Architect AI

Analise a arquitetura de qualquer projeto usando Inteligência Artificial

📋 Sobre

Project Architect AI é uma extensão para VS Code que utiliza modelos de linguagem (LLMs) para analisar automaticamente a estrutura e arquitetura de seus projetos de software, gerando relatórios técnicos detalhados em segundos.

✨ Funcionalidades

📊 Análises de Projeto Multilíngues

🇧🇷 Relatório: Resumo do Projeto (PT-BR)

Gera um resumo executivo em português contendo:

Visão geral do projeto
Principais tecnologias e bibliotecas
Estrutura de pastas
Pontos-chave da arquitetura

Comando: Project Architect: Project Summary (PT)

🇺🇸 Report: Project Summary (EN)

Generates an executive summary in English including:

Project overview
Main technologies and libraries
Folder structure
Architecture key points

Command: Project Architect: Project Summary (EN)

🔍 Análises Técnicas Detalhadas e Profundas

🇧🇷 Relatório: Análise Técnica Detalhada (PT-BR)

Análise arquitetural EXTREMAMENTE COMPLETA em português com:

📋 Visão geral e tipo de aplicação
🛠️ Stack tecnológica completa (todas as dependências)
🏗️ Arquitetura e padrões de design com trechos de código
📂 Estrutura de pastas detalhada
💾 Banco de dados e persistência
🔌 APIs, integrações e comunicação
🚀 Build, deploy e DevOps
✅ Boas práticas (SOLID, DRY, Clean Code)
🔒 ANÁLISE DE SEGURANÇA PROFUNDA:
- Vulnerabilidades (SQL Injection, XSS, CSRF)
- Secrets hardcoded
- Dependências vulneráveis
- Código problemático + correções sugeridas
💡 Sugestões de melhoria ESPECÍFICAS:
- Performance e otimização
- Arquitetura e escalabilidade
- Segurança
- Manutenibilidade
- Exemplos de código ANTES/DEPOIS
- Prioridades (🔴 Alta / 🟡 Média / 🟢 Baixa)
📊 Métricas e indicadores

Comando: Project Architect: Technical Analysis (PT)

🇺🇸 Report: Detailed Technical Analysis (EN)

EXTREMELY COMPREHENSIVE architectural analysis in English with:

📋 Overview and application type
🛠️ Complete tech stack (all dependencies)
🏗️ Architecture and design patterns with code snippets
📂 Detailed folder structure
💾 Database and persistence
🔌 APIs, integrations, and communication
🚀 Build, deploy, and DevOps
✅ Best practices (SOLID, DRY, Clean Code)
🔒 DEEP SECURITY ANALYSIS:
- Vulnerabilities (SQL Injection, XSS, CSRF)
- Hardcoded secrets
- Vulnerable dependencies
- Problematic code + suggested fixes
💡 SPECIFIC improvement suggestions:
- Performance and optimization
- Architecture and scalability
- Security
- Maintainability
- BEFORE/AFTER code examples
- Priorities (🔴 High / 🟡 Medium / 🟢 Low)
📊 Metrics and indicators

Command: Project Architect: Technical Analysis (EN)

🚀 Geração Inteligente de Commits

📝 Gerar Commit Inteligente (Conventional Commits)

Analisa suas mudanças no Git e gera automaticamente mensagens de commit seguindo o padrão Conventional Commits:

✅ Detecta mudanças staged ou unstaged
🤖 Gera mensagem semântica com tipo, escopo e descrição
📋 Inclui corpo e rodapé quando necessário
📎 Copia para clipboard automaticamente
⚡ Opção de inserir direto no Source Control

Tipos suportados: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert

Comando: Project Architect: Generate Smart Commit

⚡ Características Gerais

🔍 Varredura Automática: Escaneia todo o projeto identificando arquivos relevantes
🤖 Análise com IA: Utiliza GPT-4o para análise profunda
📊 Trechos de Código Reais: Mostra exemplos do seu projeto
⚡ Rápido e Eficiente: Análise completa em poucos segundos
🎯 Suporte Multi-linguagem: TypeScript, JavaScript, Python, Java, Go, Rust e mais

🚀 Como Usar

📊 Gerar Análises de Projeto

Abra qualquer projeto no VS Code
Pressione Ctrl+Shift+P (ou Cmd+Shift+P no Mac)
Escolha um dos comandos:
- Project Architect: Project Summary (PT) - Resumo em português
- Project Architect: Project Summary (EN) - Resumo em inglês
- Project Architect: Technical Analysis (PT) - Análise técnica detalhada em português
- Project Architect: Technical Analysis (EN) - Detailed technical analysis in English
Aguarde a análise (pode levar 10-30 segundos)
Visualize o relatório em Markdown gerado automaticamente

📝 Como Usar Smart Commit

O Smart Commit analisa suas mudanças no Git e gera automaticamente mensagens de commit seguindo o padrão Conventional Commits.

Passo-a-Passo:

Faça suas alterações no código
```
# Edite seus arquivos normalmente
```
Stage suas mudanças (opcional)
```
git add .
# ou selecione arquivos específicos
git add src/meu-arquivo.ts
```
💡 Nota: O Smart Commit também funciona com mudanças unstaged! Se você não tiver feito git add, ele analisará todas as mudanças detectáveis.
Execute o comando Smart Commit
- Pressione Ctrl+Shift+P (ou Cmd+Shift+P no Mac)
- Digite: Project Architect: Generate Smart Commit
- Aguarde alguns segundos
Revise a mensagem gerada
- Uma notificação aparecerá mostrando a mensagem de commit
- A mensagem já estará copiada para seu clipboard 📋
- Revise se está adequada
Escolha como proceder:

Opção A - Inserir diretamente no Source Control:
- Clique no botão "Inserir no Source Control"
- A mensagem será inserida automaticamente no campo de commit do Git
- Clique em "Commit" para finalizar
Opção B - Commit manual via terminal:
```
# Cole do clipboard (Ctrl+V)
git commit -m "feat(auth): add JWT token validation"
```

Exemplos de Mensagens Geradas:

feat(api): add user authentication endpoint

Implemented POST /api/auth/login with JWT token generation
and refresh token support.

BREAKING CHANGE: API now requires authentication header

fix(database): resolve connection pool timeout issue

Updated pool max connections from 10 to 50 to handle
increased load during peak hours.

refactor(components): extract reusable Button component

Moved Button logic to separate component for better
code reusability and maintainability.

⚙️ Configuração

Requisitos

VS Code 1.85.0 ou superior
API Key da OpenAI (obtenha aqui)
Git instalado e repositório inicializado (necessário apenas para Smart Commit)

Configurar API Key

Abra as Settings (Ctrl+,)
Busque por "Project Architect AI"
Cole sua API Key da OpenAI no campo "Api Key"

Ou adicione diretamente no settings.json:

{
  "projectArchitectAI.apiKey": "sk-proj-sua-chave-aqui",
  "projectArchitectAI.provider": "openai"
}

📦 Instalação

Via Marketplace (em breve)

Abra a aba de Extensions no VS Code (Ctrl+Shift+X)
Busque por "Project Architect AI"
Clique em "Install"

Manual (VSIX)

Baixe o arquivo .vsix da página de releases
No VS Code: Ctrl+Shift+P → "Install from VSIX..."
Selecione o arquivo baixado

🛠️ Tecnologias

TypeScript
VS Code Extension API
OpenAI GPT-4
esbuild

🤝 Contribuindo

Contribuições são bem-vindas! Veja como você pode ajudar:

Fork o projeto
Crie uma branch: git checkout -b feature/minha-feature
Commit suas mudanças: git commit -m 'feat: minha nova feature'
Push para a branch: git push origin feature/minha-feature
Abra um Pull Request

📝 Roadmap

[x] ✅ Geração inteligente de commits (Conventional Commits)
[x] ✅ Análises multilíngues (PT-BR e EN)
[x] ✅ Análise de segurança profunda
[ ] Suporte para Claude (Anthropic)
[ ] Suporte para modelos locais (Ollama)
[ ] Exportar relatório em PDF
[ ] Comparação de arquiteturas entre versões
[ ] Dashboard interativo
[ ] Análise de performance e complexidade ciclomática
[ ] Integração com GitHub Actions para análise automática em PRs

📄 Licença

🔗 Links

Desenvolvido com ❤️ no Brasil 🇧🇷

Project Architect AI

Rafael Degolin da Silva