Diego Alejandro Gil Rave
¡Hola comunidad de Platzi! 🚀 Emocionado de compartir mi proyecto para este reto.
🛡️ Proyecto: CodeShield Agent
¿Qué hice? Construí un "Arquitecto de Software Virtual" en formato CLI (Terminal). Es un agente de IA que audita repositorios de GitHub enteros buscando violaciones a los principios de Clean Code, SOLID, DRY y KISS. Está construido con Python, LangGraph y Claude 3.5 Sonnet.
¿Por qué lo hice? Las revisiones de código manuales consumen mucho tiempo y herramientas tradicionales (como los linters) solo ven la sintaxis, no el "diseño". Quería un agente que pudiera razonar sobre la arquitectura completa de un proyecto y dar sugerencias de refactorización como lo haría un Tech Lead.
¿Qué lo hace único? Tiene dos superpoderes principales que lo diferencian de un simple prompt:
- Conexión vía MCP (Model Context Protocol): En lugar de programar integraciones tediosas con la API de GitHub, el agente se conecta al servidor MCP oficial de GitHub, permitiéndole navegar, buscar y leer archivos de forma autónoma.
- Freno de mano interactivo (Human-in-the-loop): Usando el enrutamiento condicional de LangGraph, si el agente detecta una violación de KISS (ej. sobreingeniería extrema para un CRUD simple), pausa su ejecución en la terminal y te pregunta: "¿Existe una regla de negocio que justifique esta complejidad?". Dependiendo de tu respuesta (Sí/No), ajusta su evaluación antes de emitir el reporte final en Markdown.
🔗 Link a mi proyecto (GitHub):
¡Hola comunidad de Platzi! 🚀 Emocionado de compartir mi proyecto para este reto.
🛡️ Proyecto: CodeShield Agent
¿Qué hice? Construí un "Arquitecto de Software Virtual" en formato CLI (Terminal). Es un agente de IA que audita repositorios de GitHub enteros buscando violaciones a los principios de Clean Code, SOLID, DRY y KISS. Está construido con Python, LangGraph y Claude 3.5 Sonnet.
¿Por qué lo hice? Las revisiones de código manuales consumen mucho tiempo y herramientas tradicionales (como los linters) solo ven la sintaxis, no el "diseño". Quería un agente que pudiera razonar sobre la arquitectura completa de un proyecto y dar sugerencias de refactorización como lo haría un Tech Lead.
¿Qué lo hace único? Tiene dos superpoderes principales que lo diferencian de un simple prompt:
- Conexión vía MCP (Model Context Protocol): En lugar de programar integraciones tediosas con la API de GitHub, el agente se conecta al servidor MCP oficial de GitHub, permitiéndole navegar, buscar y leer archivos de forma autónoma.
- Freno de mano interactivo (Human-in-the-loop): Usando el enrutamiento condicional de LangGraph, si el agente detecta una violación de KISS (ej. sobreingeniería extrema para un CRUD simple), pausa su ejecución en la terminal y te pregunta: "¿Existe una regla de negocio que justifique esta complejidad?". Dependiendo de tu respuesta (Sí/No), ajusta su evaluación antes de emitir el reporte final en Markdown.
🔗 Link a mi proyecto (GitHub):
¡Me encantaría que lo clonen, lo prueben con sus propios repositorios y me dejen su feedback! 👇