Skip to content

README.es.md

Latest commit

 

History

History
358 lines (261 loc) · 14.5 KB

README.es.md

File metadata and controls

358 lines (261 loc) · 14.5 KB

English | 한국어 | 中文 | 日本語 | Español

Codingbuddy

CI npm version License: 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:

# 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 Instalación y configuración
Referencia Rápida Comandos y modos de un vistazo
Arquitectura 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:

# Inicializa tu proyecto
npx codingbuddy init

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

{
  "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 →

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

# 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

# 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 →

Configuración

Configuración del Modelo de IA

Configure el modelo de IA predeterminado en codingbuddy.config.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:

{
  "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 Instalación y configuración rápida
Filosofía Visión y principios de diseño
Sistema de Agentes Referencia completa de agentes
Biblioteca de Skills Skills de flujo de trabajo reutilizables (TDD, depuración, PR, etc.)
Herramientas Compatibles Guías de integración de herramientas IA
Configuración Opciones del archivo de configuración
Referencia API Capacidades del servidor MCP

Contribuir

¡Damos la bienvenida a las contribuciones! Consulta CONTRIBUTING.md para las directrices.

Licencia

MIT © Codingbuddy