Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/jeremydev87/codingbuddy

Codingbuddy orchestrates 29 specialized AI agents to deliver code quality comparable to a team of human experts through a PLAN → ACT → EVAL workflow.
https://github.com/jeremydev87/codingbuddy

ai-agents ai-coding ai-coding-assistant ai-rules claude-code code-quality coding-assistant cursor developer-tools github-copilot mcp mcp-server model-context-protocol nestjs tdd typescript

Last synced: about 1 month ago
JSON representation

Codingbuddy orchestrates 29 specialized AI agents to deliver code quality comparable to a team of human experts through a PLAN → ACT → EVAL workflow.

Awesome Lists containing this project

README 

          


  English |

  한국어 |

  中文 |

  日本語 |

  Español




# Codingbuddy



[![CI](https://github.com/JeremyDev87/codingbuddy/actions/workflows/dev.yml/badge.svg)](https://github.com/JeremyDev87/codingbuddy/actions/workflows/dev.yml)

[![npm version](https://img.shields.io/npm/v/codingbuddy.svg)](https://www.npmjs.com/package/codingbuddy)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)





  Arquitectura Multi-Agente de Codingbuddy




## Equipo de Expertos IA para Tu Código



**Codingbuddy orquesta 35 agentes de IA para ofrecer calidad de código a nivel de equipo de expertos humanos.**



Una sola IA no puede ser experta en todo. Codingbuddy crea un equipo de desarrollo de IA—arquitectos, desarrolladores, especialistas en seguridad, expertos en accesibilidad y más—que colaboran para revisar, verificar y refinar tu código hasta que cumpla con los estándares profesionales.



---



## Novedades en v5.6.0 — HUD Statusbar Wave



- **Breathing Buddy Face** — el rostro del Buddy reacciona a la fase de tu sesión (inactivo / pensando / activo / bloqueado / victoria) para que la barra de estado se sienta viva.

- **Cost Velocity Indicator** — un badge de ritmo de gasto de sesión con glifos 🔥 / ↗ / → / 💤 te dice si estás en una pasada de planificación lenta o en una refactorización intensa.

- **Cache Savings Badge** — cuantifica los descuentos de caché de prompts como `💰$N.NN saved` para que veas el valor del caché en tiempo real.

- **Mode Rainbow Coloring** — gradientes ANSI truecolor por modo (PLAN ◇ / ACT ◆ / EVAL ◈ / AUTO ◊) con soporte para la variable de entorno `NO_COLOR` en CI y terminales en escala de grises.

- **Smart Context Bar** — una barra de progreso visual `[████░░░░░░] 42%` reemplaza el texto plano `Ctx:42%` con umbrales de advertencia y peligro.

- **Adaptive Layout Engine** — el HUD se adapta con elegancia a terminales estrechos mediante el truncado adaptativo `fit_segments`.

- **Rate-limit Severity Icons** — advertencias visuales cuando te acercas a los límites de velocidad de la API.



---



## La Visión



### El Problema



Cuando le pides a una IA que escriba código, obtienes una única perspectiva. Sin revisión de seguridad. Sin verificación de accesibilidad. Sin validación de arquitectura. Solo una IA haciendo todo "aceptable" pero nada excelente.



Los equipos de desarrollo humanos tienen especialistas:

- **Arquitectos** que diseñan sistemas

- **Ingenieros de seguridad** que encuentran vulnerabilidades

- **Especialistas en QA** que detectan casos límite

- **Expertos en rendimiento** que optimizan cuellos de botella



### Nuestra Solución



**Codingbuddy trae el modelo de equipo especializado a la programación con IA.**



En lugar de que una sola IA intente hacerlo todo, Codingbuddy coordina múltiples agentes especializados que colaboran:



```

┌─────────────────────────────────────────────────────────────┐

│                       Tu Solicitud                           │

│              "Implementar autenticación de usuario"          │

└─────────────────────────────────────────────────────────────┘

                            │

                            ▼

┌─────────────────────────────────────────────────────────────┐

│ 📋 PLAN: Arquitecto de Soluciones + Especialista en Arquitectura│

│          → Diseñar arquitectura del sistema                  │

│          → Definir requisitos de seguridad                   │

└─────────────────────────────────────────────────────────────┘

                            │

                            ▼

┌─────────────────────────────────────────────────────────────┐

│ 🚀 ACT: Desarrollador Backend + Especialista en Estrategia de Tests│

│         → Implementar con TDD                                │

│         → Seguir estándares de calidad                       │

└─────────────────────────────────────────────────────────────┘

                            │

                            ▼

┌─────────────────────────────────────────────────────────────┐

│ 🔍 EVAL: Revisor de Código + Especialistas en Paralelo       │

│          🔒 Seguridad    → ¿Vulnerabilidades JWT?            │

│          ♿ Accesibilidad → ¿Cumplimiento WCAG?              │

│          ⚡ Rendimiento  → ¿Optimización necesaria?          │

│          📏 Calidad      → ¿Principios SOLID?                │

└─────────────────────────────────────────────────────────────┘

                            │

              ┌─────────────┴─────────────┐

              │                           │

        Critical > 0?              Critical = 0 AND

        High > 0?                  High = 0

              │                           │

              ▼                           ▼

        Volver a PLAN              ✅ Calidad Alcanzada

        con mejoras                Desplegar con confianza

```



---



## Inicio Rápido



**Requiere Node.js 18+ y npm 9+ (o yarn 4+)**



### Plugin de Claude Code (Recomendado)



La forma más rápida de comenzar — framework completo con ingeniería de harness, bucles autónomos y colaboración de agentes:



```bash

# Instalar el plugin

claude plugin install codingbuddy@jeremydev87



# Instalar el servidor MCP para funcionalidad completa

npm install -g codingbuddy



# Inicializar tu proyecto

npx codingbuddy init

```



| Documentación | Descripción |

|---------------|-------------|

| [Guía de Configuración del Plugin](docs/plugin-guide.md) | Instalación y configuración |

| [Referencia Rápida](docs/plugin-quick-reference.md) | Comandos y modos de un vistazo |

| [Arquitectura](docs/plugin-architecture.md) | Cómo funcionan juntos plugin y MCP |



### Servidor MCP (Otras herramientas de IA)



Para Cursor, GitHub Copilot, Antigravity, Amazon Q, Kiro y otras herramientas compatibles con MCP:



```bash

# Inicializa tu proyecto

npx codingbuddy init

```



Añade a la configuración MCP de tu herramienta de IA:



```json

{

  "mcpServers": {

    "codingbuddy": {

      "command": "npx",

      "args": ["codingbuddy", "mcp"]

    }

  }

}

```



### Comenzar a Usar



```

PLAN: Implementar registro de usuario con verificación de email

→ El equipo IA planifica la arquitectura



ACT

→ El equipo IA implementa con TDD



EVAL

→ El equipo IA revisa desde 8+ perspectivas



AUTO: Construir un sistema de autenticación completo

→ El equipo IA itera hasta alcanzar la calidad

```



[Guía Completa de Inicio →](docs/es/getting-started.md)



---



## Arquitectura Multi-Agente



### Sistema de Agentes de 3 Niveles



| Nivel | Agentes | Rol |

|-------|---------|-----|

| **Agentes de Modo** (4) | plan-mode, act-mode, eval-mode, auto-mode | Orquestación de flujo de trabajo |

| **Agentes Principales** (16) | solution-architect, technical-planner, frontend-developer, backend-developer y más | Implementación central |

| **Agentes Especialistas** (15) | security, accessibility, performance, test-strategy y más | Experiencia de dominio |



### Ejemplo de Colaboración de Agentes



Cuando solicitas una funcionalidad, los agentes colaboran automáticamente:



```

🤖 solution-architect    → Diseña el enfoque

   └── 👤 architecture-specialist  → Valida límites de capas

   └── 👤 test-strategy-specialist → Planifica cobertura de tests



🤖 backend-developer     → Implementa el código

   └── 👤 security-specialist      → Revisa patrones de auth

   └── 👤 event-architecture       → Diseña flujos de mensajes



🤖 code-reviewer         → Evalúa calidad

   └── 👤 4 especialistas en paralelo → Revisión multidimensional

```



---



## Ciclo de Aseguramiento de Calidad



### El Bucle PLAN → ACT → EVAL



Codingbuddy implementa un ciclo de desarrollo orientado a la calidad:



1. **PLAN**: Diseñar antes de codificar (arquitectura, estrategia de tests)

2. **ACT**: Implementar con TDD y estándares de calidad

3. **EVAL**: Revisión multi-especialista (seguridad, rendimiento, accesibilidad, calidad)

4. **Iterar**: Continuar hasta alcanzar objetivos de calidad



### Modo AUTO: Logro Autónomo de Calidad



```bash

# Solo describe lo que quieres

AUTO: Implementar autenticación JWT con tokens de refresco



# Codingbuddy automáticamente:

# → Planifica la implementación

# → Escribe código siguiendo TDD

# → Revisa con 4+ especialistas

# → Itera hasta: Critical=0 AND High=0

# → Entrega código listo para producción

```



### Criterios de Salida



| Severidad | Debe Corregirse Antes de Desplegar |

|-----------|-----------------------------------|

| 🔴 Critical | Sí - Problemas inmediatos de seguridad/datos |

| 🟠 High | Sí - Problemas significativos |

| 🟡 Medium | Opcional - Deuda técnica |

| 🟢 Low | Opcional - Mejora |



---



## Lo Que Lo Hace Diferente



| Programación IA Tradicional | Codingbuddy |

|----------------------------|-------------|

| Perspectiva de una sola IA | 35 perspectivas de agentes especialistas |

| "Generar y esperar" | Planificar → Implementar → Verificar |

| Sin puertas de calidad | Critical=0, High=0 requerido |

| Revisión manual necesaria | Revisión multidimensional automatizada |

| Calidad inconsistente | Refinamiento iterativo hasta cumplir estándares |



---



## Panel de Control Terminal (TUI)



Codingbuddy incluye una interfaz de terminal integrada que muestra la actividad de agentes, el progreso de tareas y el estado del flujo de trabajo en tiempo real junto a tu asistente de IA.



### Inicio Rápido



```bash

# Iniciar servidor MCP con TUI habilitado

npx codingbuddy mcp --tui

```



### Características



| Panel | Descripción |

|-------|-------------|

| **FlowMap** | Tubería visual que muestra agentes activos, etapas y progreso |

| **FocusedAgent** | Vista en tiempo real del agente activo con sparkline de actividad |

| **Checklist** | Seguimiento de tareas completadas desde el contexto PLAN/ACT/EVAL |

| **Activity Chart** | Gráfico de barras de invocaciones de herramientas en tiempo real |

| **Multi-sesión** | Múltiples sesiones de Claude Code comparten una sola ventana TUI |



---



## Novedades en v5.4.0



**Planificación con preguntas primero** — Codingbuddy ahora pregunta antes de planificar. Los prompts ambiguos activan una pregunta de clarificación, y los prompts claros avanzan por las etapas Discover→Design→Plan con confirmación del usuario en cada paso.



**Escena del consejo** — Los modos PLAN, EVAL y AUTO comienzan con una escena de apertura que muestra qué agentes especialistas están ensamblados y listos para colaborar.



**Pronóstico de permisos** — Antes de la ejecución, se muestran las clases de permisos necesarias (repo-write, network, external) para preparar los paquetes de aprobación con anticipación.



**Puerta de ejecución** — Cuando la etapa de planificación no ha avanzado más allá del descubrimiento, se suprime el despacho de especialistas para evitar trabajo prematuro.



**Pipeline de estado del consejo** — Insignias en tiempo real muestran transferencias de agentes, transiciones de etapa y bloqueadores durante la ejecución de herramientas.



```

◕‿◕ CB v5.4.0 | PLAN 🟢 | 12m | ~$0.23 | Cache:87% | Ctx:45%

```



---



## Herramientas de IA Compatibles



| Herramienta | Estado |

|-------------|--------|

| Claude Code | ✅ MCP Completo + Plugin |

| Cursor | ✅ Compatible |

| GitHub Copilot | ✅ Compatible |

| Antigravity | ✅ Compatible |

| Amazon Q | ✅ Compatible |

| Kiro | ✅ Compatible |

| OpenCode | ✅ Compatible |



[Guías de Configuración →](docs/es/supported-tools.md)



---



## Configuración



### Configuración del Modelo de IA



Configure el modelo de IA predeterminado en `codingbuddy.config.json`:



```json

{

  "ai": {

    "defaultModel": "claude-sonnet-4-20250514"

  }

}

```



| Modelo | Mejor Para |

|--------|------------|

| `claude-opus-4-*` | Arquitectura compleja, análisis profundo |

| `claude-sonnet-4-*` | Desarrollo general (predeterminado) |

| `claude-haiku-3-5-*` | Consultas rápidas (no recomendado para codificación) |



### Configuración de Verbosidad



Optimice el uso de tokens con niveles de verbosidad:



```json

{

  "verbosity": "compact"

}

```



| Nivel | Caso de Uso |

|-------|-------------|

| `minimal` | Máximo ahorro de tokens, solo información esencial |

| `compact` | Equilibrado, formato reducido (predeterminado) |

| `standard` | Formato completo, respuestas estructuradas |

| `detailed` | Explicaciones extendidas, ejemplos incluidos |



---



## Documentación



| Documento | Descripción |

|-----------|-------------|

| [Primeros Pasos](docs/es/getting-started.md) | Instalación y configuración rápida |

| [Filosofía](docs/es/philosophy.md) | Visión y principios de diseño |

| [Sistema de Agentes](packages/rules/.ai-rules/agents/README.md) | Referencia completa de agentes |

| [Biblioteca de Skills](packages/rules/.ai-rules/skills/README.md) | Skills de flujo de trabajo reutilizables (TDD, depuración, PR, etc.) |

| [Herramientas Compatibles](docs/es/supported-tools.md) | Guías de integración de herramientas IA |

| [Configuración](docs/config-schema.md) | Opciones del archivo de configuración |

| [Referencia API](docs/api.md) | Capacidades del servidor MCP |



---



## Contribuir



¡Damos la bienvenida a las contribuciones! Consulta [CONTRIBUTING.md](CONTRIBUTING.md) para las directrices.



## Licencia



MIT © [Codingbuddy](https://github.com/JeremyDev87/codingbuddy)