https://futurewithml.netlify.app
|
Esta es una fuente web, también conocida como fuente Atom. Suscríbete copiando la URL de la barra de direcciones en tu lector de noticias. Visita About Feeds para aprender más y empezar. Es gratis.
Visita la web
Publicaciones recientes
Actualizado el $DATE
date
Productividad
Future With ML - Productividad
Patrones de Diseño en Machine Learning, MLOps e Ingeniería de IA por Christian Picon Calderon
Zola2026-01-06T10:00:00+00:00https://futurewithml.netlify.app/es/tags/productividad/atom.xml
Claude Code Plugin Journey Parte 0: Agent Team Creator
2026-01-06T10:00:00+00:00
2026-01-06T10:00:00+00:00
Christian Picon Calderon
https://futurewithml.netlify.app/es/posts/claude-code-plugin-journey-part0/
<h1 id="claude-code-plugin-journey-parte-0-agent-team-creator">Claude Code Plugin Journey Parte 0: Agent Team Creator</h1>
<p>¿Qué pasaría si pudieras apuntar una IA a tu proyecto y hacer que genere especialistas que realmente entienden tu stack? No asistentes genéricos—agentes que conocen tu arquitectura, tus patrones, tus convenciones.</p>
<p>Eso es lo que hace <code>agent-team-creator</code>. Déjame mostrarte el flujo de trabajo.</p>
<span id="continue-reading"></span>
<hr />
<h2 id="escenario-1-genera-tu-equipo-de-agentes">Escenario 1: Genera tu Equipo de Agentes</h2>
<p>Comienzas un nuevo proyecto—o te unes a uno existente. El código base es desconocido. Necesitas ayuda, pero los consejos genéricos de IA no son suficientes.</p>
<p><strong>Paso 1: Genera tu equipo de agentes</strong></p>
<pre class="z-code"><code><span class="z-text z-plain">/generate-agent-team
</span></code></pre>
<p>Observa cómo el plugin analiza tu proyecto:</p>
<pre class="z-code"><code><span class="z-text z-plain">Analizando código base...
</span><span class="z-text z-plain">├── Lenguajes: Python (75%), TypeScript (20%), SQL (5%)
</span><span class="z-text z-plain">├── Frameworks: FastAPI, React, SQLAlchemy
</span><span class="z-text z-plain">├── Arquitectura: Monorepo con separación backend/frontend
</span><span class="z-text z-plain">├── Patrones: Patrón repository, inyección de dependencias
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">Generando agentes especializados...
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">✓ fastapi-expert
</span><span class="z-text z-plain"> Conoce: Tus patrones de endpoints, modelos Pydantic, stack de middleware
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">✓ react-specialist
</span><span class="z-text z-plain"> Conoce: Tu librería de componentes, gestión de estado, patrones de hooks
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">✓ database-architect
</span><span class="z-text z-plain"> Conoce: Tus modelos SQLAlchemy, patrones de migración, convenciones de consultas
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">✓ test-strategist
</span><span class="z-text z-plain"> Conoce: Tus fixtures de pytest, patrones de mocking, utilidades de testing
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">Equipo guardado en .claude/agents/
</span></code></pre>
<p><strong>Paso 2: Usa tus agentes inmediatamente</strong></p>
<p>Ahora tienes especialistas conscientes del proyecto. Así es como usarlos:</p>
<p><strong>Pregunta sobre arquitectura:</strong></p>
<pre class="z-code"><code><span class="z-text z-plain">Usa el agente fastapi-expert para explicar cómo funciona
</span><span class="z-text z-plain">la autenticación en este proyecto
</span></code></pre>
<p><strong>Implementa una funcionalidad:</strong></p>
<pre class="z-code"><code><span class="z-text z-plain">Usa el agente react-specialist para ayudarme a añadir un nuevo
</span><span class="z-text z-plain">componente de dashboard siguiendo nuestros patrones existentes
</span></code></pre>
<p><strong>Depura un problema:</strong></p>
<pre class="z-code"><code><span class="z-text z-plain">Usa el agente database-architect para ayudarme a entender por qué
</span><span class="z-text z-plain">esta consulta es lenta - revisa src/repositories/user_repo.py
</span></code></pre>
<p><strong>Escribe tests:</strong></p>
<pre class="z-code"><code><span class="z-text z-plain">Usa el agente test-strategist para escribir tests de integración para
</span><span class="z-text z-plain">el nuevo endpoint de pagos siguiendo nuestras convenciones de testing
</span></code></pre>
<p><strong>¿La diferencia?</strong> Estos agentes no dan consejos genéricos. Referencian <em>tus</em> archivos, <em>tus</em> patrones, <em>tus</em> convenciones.</p>
<hr />
<h2 id="escenario-2-flujo-de-trabajo-avanzado-de-depuracion">Escenario 2: Flujo de Trabajo Avanzado de Depuración</h2>
<p>Después de generar tu equipo de agentes, puedes crear un <strong>Project Debugger</strong>—un orquestador que coordina a tus especialistas para diagnosticar problemas complejos.</p>
<p><strong>Paso 1: Genera el Project Debugger</strong></p>
<pre class="z-code"><code><span class="z-text z-plain">/generate-debugger
</span></code></pre>
<pre class="z-code"><code><span class="z-text z-plain">Descubriendo agentes del proyecto...
</span><span class="z-text z-plain">├── Encontrados: fastapi-expert, react-specialist, database-architect, test-strategist
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">Analizando arquitectura del proyecto...
</span><span class="z-text z-plain">├── Puntos de entrada identificados
</span><span class="z-text z-plain">├── Patrones de manejo de errores mapeados
</span><span class="z-text z-plain">├── Convenciones de logging detectadas
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">Generando project-debugger.md...
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">✓ Creado: .claude/agents/project-debugger.md
</span><span class="z-text z-plain"> - Orquesta tus 4 agentes especialistas
</span><span class="z-text z-plain"> - Produce informes de depuración estructurados
</span><span class="z-text z-plain"> - Identifica causas raíz con referencias archivo:línea
</span></code></pre>
<p><strong>Paso 2: Usa el Debugger para investigar</strong></p>
<p>Cuando encuentres un bug, invoca el project debugger:</p>
<pre class="z-code"><code><span class="z-text z-plain">Usa el agente project-debugger para investigar: Los usuarios están
</span><span class="z-text z-plain">recibiendo errores 500 cuando envían el formulario de checkout
</span></code></pre>
<p>El debugger orquesta a tus especialistas:</p>
<pre class="z-code"><code><span class="z-text z-plain">Consultando fastapi-expert...
</span><span class="z-text z-plain">├── Trazado flujo de request a través de api/routes/checkout.py
</span><span class="z-text z-plain">├── Encontrado: PaymentService.process() lanza excepción no manejada
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">Consultando database-architect...
</span><span class="z-text z-plain">├── Verificado manejo de transacciones en repositories/order_repo.py
</span><span class="z-text z-plain">├── Encontrado: Falta rollback en fallo de pago
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">Consultando test-strategist...
</span><span class="z-text z-plain">├── Revisada cobertura de tests para flujo de checkout
</span><span class="z-text z-plain">├── Encontrado: No hay test para escenario de fallo de pago
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">Generando informe de depuración...
</span></code></pre>
<p><strong>Paso 3: Genera un informe de depuración</strong></p>
<p>El debugger produce un informe estructurado guardado en <code>.claude/reports/debugging/</code>:</p>
<pre data-lang="markdown" class="language-markdown z-code"><code class="language-markdown" data-lang="markdown"><span class="z-text z-html z-markdown"><span class="z-meta z-block-level z-markdown"><span class="z-markup z-heading z-1 z-markdown"><span class="z-punctuation z-definition z-heading z-begin z-markdown">#</span> </span><span class="z-markup z-heading z-1 z-markdown"><span class="z-entity z-name z-section z-markdown">Informe de Depuración: Errores 500 en Checkout</span><span class="z-meta z-whitespace z-newline z-markdown">
</span></span></span></span><span class="z-text z-html z-markdown">
</span><span class="z-text z-html z-markdown"><span class="z-meta z-block-level z-markdown"><span class="z-markup z-heading z-2 z-markdown"><span class="z-punctuation z-definition z-heading z-begin z-markdown">##</span> </span><span class="z-markup z-heading z-2 z-markdown"><span class="z-entity z-name z-section z-markdown">Causa Raíz</span><span class="z-meta z-whitespace z-newline z-markdown">
</span></span></span></span><span class="z-text z-html z-markdown"><span class="z-meta z-paragraph z-markdown">Falta manejo de excepciones en PaymentService.process()
</span></span><span class="z-text z-html z-markdown"><span class="z-meta z-paragraph z-markdown">(src/services/payment.py:45) combinado con falta de
</span></span><span class="z-text z-html z-markdown"><span class="z-meta z-paragraph z-markdown">rollback de transacción (src/repositories/order_repo.py:78)
</span></span><span class="z-text z-html z-markdown"><span class="z-meta z-paragraph z-markdown">
</span></span><span class="z-text z-html z-markdown"><span class="z-meta z-block-level z-markdown"><span class="z-markup z-heading z-2 z-markdown"><span class="z-punctuation z-definition z-heading z-begin z-markdown">##</span> </span><span class="z-markup z-heading z-2 z-markdown"><span class="z-entity z-name z-section z-markdown">Evidencia</span><span class="z-meta z-whitespace z-newline z-markdown">
</span></span></span></span><span class="z-text z-html z-markdown"><span class="z-markup z-list z-unnumbered z-bullet z-markdown"><span class="z-punctuation z-definition z-list_item z-markdown">-</span></span><span class="z-markup z-list z-unnumbered z-markdown"> <span class="z-meta z-paragraph z-list z-markdown">Archivo: src/services/payment.py:45-52
</span></span></span><span class="z-text z-html z-markdown"><span class="z-markup z-list z-unnumbered z-markdown"><span class="z-meta z-paragraph z-list z-markdown"></span></span><span class="z-markup z-list z-unnumbered z-bullet z-markdown"><span class="z-punctuation z-definition z-list_item z-markdown">-</span></span><span class="z-markup z-list z-unnumbered z-markdown"><span class="z-meta z-paragraph z-list z-markdown"> Archivo: src/repositories/order_repo.py:78-85
</span></span></span><span class="z-text z-html z-markdown"><span class="z-markup z-list z-unnumbered z-markdown"><span class="z-meta z-paragraph z-list z-markdown"></span></span><span class="z-markup z-list z-unnumbered z-bullet z-markdown"><span class="z-punctuation z-definition z-list_item z-markdown">-</span></span><span class="z-markup z-list z-unnumbered z-markdown"><span class="z-meta z-paragraph z-list z-markdown"> Test faltante: tests/integration/test_checkout.py
</span></span></span><span class="z-text z-html z-markdown"><span class="z-markup z-list z-unnumbered z-markdown"><span class="z-meta z-paragraph z-list z-markdown"></span></span><span class="z-markup z-list z-unnumbered z-markdown">
</span></span><span class="z-text z-html z-markdown"><span class="z-markup z-list z-unnumbered z-markdown"></span><span class="z-meta z-block-level z-markdown"><span class="z-markup z-heading z-2 z-markdown"><span class="z-punctuation z-definition z-heading z-begin z-markdown">##</span> </span><span class="z-markup z-heading z-2 z-markdown"><span class="z-entity z-name z-section z-markdown">Corrección Recomendada</span><span class="z-meta z-whitespace z-newline z-markdown">
</span></span></span></span><span class="z-text z-html z-markdown"><span class="z-markup z-list z-numbered z-bullet z-markdown">1<span class="z-punctuation z-definition z-list_item z-markdown">.</span></span><span class="z-markup z-list z-numbered z-markdown"> <span class="z-meta z-paragraph z-list z-markdown">Añadir try/except en payment.py:45
</span></span></span><span class="z-text z-html z-markdown"><span class="z-markup z-list z-numbered z-markdown"><span class="z-meta z-paragraph z-list z-markdown"></span></span><span class="z-markup z-list z-numbered z-bullet z-markdown">2<span class="z-punctuation z-definition z-list_item z-markdown">.</span></span><span class="z-markup z-list z-numbered z-markdown"><span class="z-meta z-paragraph z-list z-markdown"> Implementar rollback en order_repo.py:78
</span></span></span><span class="z-text z-html z-markdown"><span class="z-markup z-list z-numbered z-markdown"><span class="z-meta z-paragraph z-list z-markdown"></span></span><span class="z-markup z-list z-numbered z-bullet z-markdown">3<span class="z-punctuation z-definition z-list_item z-markdown">.</span></span><span class="z-markup z-list z-numbered z-markdown"><span class="z-meta z-paragraph z-list z-markdown"> Añadir test de escenario de fallo
</span></span></span><span class="z-text z-html z-markdown"><span class="z-markup z-list z-numbered z-markdown"><span class="z-meta z-paragraph z-list z-markdown"></span></span><span class="z-markup z-list z-numbered z-markdown">
</span></span><span class="z-text z-html z-markdown"><span class="z-markup z-list z-numbered z-markdown"></span><span class="z-meta z-block-level z-markdown"><span class="z-markup z-heading z-2 z-markdown"><span class="z-punctuation z-definition z-heading z-begin z-markdown">##</span> </span><span class="z-markup z-heading z-2 z-markdown"><span class="z-entity z-name z-section z-markdown">Efectos Secundarios</span><span class="z-meta z-whitespace z-newline z-markdown">
</span></span></span></span><span class="z-text z-html z-markdown"><span class="z-markup z-list z-unnumbered z-bullet z-markdown"><span class="z-punctuation z-definition z-list_item z-markdown">-</span></span><span class="z-markup z-list z-unnumbered z-markdown"> <span class="z-meta z-paragraph z-list z-markdown">Los pedidos pueden estar en estado inconsistente (necesita migración)
</span></span></span></code></pre>
<p><strong>Paso 4: Crea un ticket de Jira desde el informe</strong></p>
<p>Ahora convierte ese informe en una tarea de Jira. El comando encuentra automáticamente el informe de depuración más reciente:</p>
<pre class="z-code"><code><span class="z-text z-plain">/generate-jira-task
</span></code></pre>
<pre class="z-code"><code><span class="z-text z-plain">Buscando último informe de depuración...
</span><span class="z-text z-plain">├── Encontrado: .claude/reports/debugging/report-2026-01-06-1430.md
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">Cargando informe de depuración...
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">Buscando issues similares...
</span><span class="z-text z-plain">├── Buscando: "checkout payment exception rollback"
</span><span class="z-text z-plain">├── Encontrados 2 issues potencialmente relacionados:
</span><span class="z-text z-plain">
</span><span class="z-text z-plain"> PROJ-234: "Payment processing timeout errors"
</span><span class="z-text z-plain"> Estado: En Progreso
</span><span class="z-text z-plain">
</span><span class="z-text z-plain"> PROJ-189: "Checkout form validation issues"
</span><span class="z-text z-plain"> Estado: Hecho
</span><span class="z-text z-plain">
</span><span class="z-text z-plain">¿Cómo deseas proceder?
</span><span class="z-text z-plain">> Crear nueva tarea de todos modos
</span><span class="z-text z-plain">> Abortar - Actualizaré un issue existente
</span></code></pre>
<p>Si eliges crear una nueva tarea:</p>
<pre class="z-code"><code><span class="z-text z-plain">Creando issue de Jira...
</span><span class="z-text z-plain">✓ Creado: PROJ-456 "Fix checkout 500 errors: missing exception handling"
</span><span class="z-text z-plain"> https://yourcompany.atlassian.net/browse/PROJ-456
</span></code></pre>
<p>La verificación de duplicados previene llenar tu backlog con issues relacionados. Si el bug es una variante de un issue existente, puedes actualizar ese ticket en lugar de crear uno nuevo.</p>
<p><strong>¿No tienes Jira configurado?</strong> El comando degrada gracefully a generar un archivo markdown listo para copiar en <code>.claude/reports/jira-drafts/</code>.</p>
<hr />
<h2 id="escenario-3-flujo-de-trabajo-repetible-para-multiples-bugs">Escenario 3: Flujo de Trabajo Repetible para Múltiples Bugs</h2>
<p>Cada investigación de bug crea su propio informe de depuración, que lleva a su propio ticket de Jira. Así es como el flujo escala a través de múltiples issues:</p>
<p><strong>Lunes: Problema de rendimiento de API</strong></p>
<pre class="z-code"><code><span class="z-text z-plain">Usa el agente project-debugger para investigar: ¿Por qué están
</span><span class="z-text z-plain">subiendo los tiempos de respuesta de la API durante horas pico?
</span></code></pre>
<p>Informe guardado: <code>.claude/reports/debugging/report-2026-01-06-0900.md</code></p>
<pre class="z-code"><code><span class="z-text z-plain">/generate-jira-task
</span></code></pre>
<p>Creado: <code>PROJ-457 "Optimize database connection pooling for peak load"</code></p>
<hr />
<p><strong>Martes: Bug de renderizado en frontend</strong></p>
<pre class="z-code"><code><span class="z-text z-plain">Usa el agente project-debugger para investigar: El gráfico del
</span><span class="z-text z-plain">dashboard no se actualiza cuando llegan nuevos datos
</span></code></pre>
<p>Informe guardado: <code>.claude/reports/debugging/report-2026-01-07-1100.md</code></p>
<pre class="z-code"><code><span class="z-text z-plain">/generate-jira-task
</span></code></pre>
<p>Creado: <code>PROJ-458 "Fix React state synchronization in DashboardChart component"</code></p>
<hr />
<p><strong>Miércoles: Caso edge de autenticación</strong></p>
<pre class="z-code"><code><span class="z-text z-plain">Usa el agente project-debugger para investigar: Los usuarios están
</span><span class="z-text z-plain">siendo deslogueados aleatoriamente después de cambios de contraseña
</span></code></pre>
<p>Informe guardado: <code>.claude/reports/debugging/report-2026-01-08-1400.md</code></p>
<pre class="z-code"><code><span class="z-text z-plain">/generate-jira-task
</span></code></pre>
<p>Creado: <code>PROJ-459 "Handle session invalidation on password change correctly"</code></p>
<hr />
<p>Cada investigación es independiente. El debugger crea informes con timestamp, y <code>/generate-jira-task</code> siempre toma el más reciente. Tu historial de depuración se acumula en <code>.claude/reports/debugging/</code>, dándote un archivo buscable de investigaciones pasadas.</p>
<hr />
<h2 id="el-flujo-de-trabajo-completo">El Flujo de Trabajo Completo</h2>
<div class="workflow-container" id="workflow">
<canvas class="workflow-canvas" aria-label="Workflow visualization"></canvas>
</div>
<script>
(function() {
const containerId = 'workflow';
// Decode HTML entities (Tera encodes / as /)
function decodeHTML(str) {
const textarea = document.createElement('textarea');
textarea.innerHTML = str;
return textarea.value;
}
const stepsData = [
{ title: decodeHTML('/generate-agent-team'), desc: decodeHTML('Crea agentes especialistas') },
{ title: decodeHTML('Usa agentes diariamente'), desc: decodeHTML('fastapi-expert react-specialist') },
{ title: decodeHTML('/generate-debugger'), desc: decodeHTML('Crea project-debugger') },
{ title: decodeHTML('Depura issues'), desc: decodeHTML('Guarda en .claude/reports/') },
{ title: decodeHTML('/generate-jira-task'), desc: decodeHTML('Crea ticket de Jira') }
];
function initWorkflow() {
const container = document.getElementById(containerId);
if (!container) return;
const canvas = container.querySelector('.workflow-canvas');
const ctx = canvas.getContext('2d');
let particles = [];
let time = 0;
const colors = {
primary: '#00d4ff',
secondary: '#8b5cf6',
accent: '#00ff88',
particle: '#00ff88',
connection: 'rgba(0, 212, 255, 0.4)',
text: '#e0e0e4',
subtext: '#8888a0'
};
function resize() {
const rect = container.getBoundingClientRect();
canvas.width = rect.width;
canvas.height = Math.max(550, stepsData.length * 130 + 100);
container.style.height = canvas.height + 'px';
}
resize();
window.addEventListener('resize', resize);
function getStepPositions() {
const centerX = canvas.width / 2;
const startY = 70;
const stepHeight = 120;
return stepsData.map((step, i) => ({
...step,
x: centerX,
y: startY + i * stepHeight,
width: Math.min(450, canvas.width * 0.85),
height: 90,
color: i % 2 === 0 ? colors.primary : colors.secondary
}));
}
function createParticle(from, to) {
return {
fromX: from.x,
fromY: from.y + from.height / 2,
toX: to.x,
toY: to.y - to.height / 2,
progress: Math.random(),
speed: 0.008 + Math.random() * 0.004
};
}
function draw() {
ctx.clearRect(0, 0, canvas.width, canvas.height);
const positions = getStepPositions();
// Draw connections
ctx.strokeStyle = colors.connection;
ctx.lineWidth = 3;
for (let i = 0; i < positions.length - 1; i++) {
const from = positions[i];
const to = positions[i + 1];
ctx.beginPath();
ctx.moveTo(from.x, from.y + from.height / 2);
ctx.lineTo(to.x, to.y - to.height / 2);
ctx.stroke();
// Arrow
const midY = (from.y + from.height / 2 + to.y - to.height / 2) / 2;
ctx.fillStyle = colors.connection;
ctx.beginPath();
ctx.moveTo(from.x - 6, midY - 4);
ctx.lineTo(from.x, midY + 6);
ctx.lineTo(from.x + 6, midY - 4);
ctx.closePath();
ctx.fill();
}
// Draw step boxes
positions.forEach((pos, i) => {
const x = pos.x - pos.width / 2;
const y = pos.y - pos.height / 2;
// Glow
ctx.shadowColor = pos.color;
ctx.shadowBlur = 20;
// Box with rounded corners
ctx.fillStyle = pos.color;
ctx.beginPath();
const radius = 8;
ctx.moveTo(x + radius, y);
ctx.lineTo(x + pos.width - radius, y);
ctx.quadraticCurveTo(x + pos.width, y, x + pos.width, y + radius);
ctx.lineTo(x + pos.width, y + pos.height - radius);
ctx.quadraticCurveTo(x + pos.width, y + pos.height, x + pos.width - radius, y + pos.height);
ctx.lineTo(x + radius, y + pos.height);
ctx.quadraticCurveTo(x, y + pos.height, x, y + pos.height - radius);
ctx.lineTo(x, y + radius);
ctx.quadraticCurveTo(x, y, x + radius, y);
ctx.closePath();
ctx.fill();
ctx.shadowBlur = 0;
// Border
ctx.strokeStyle = colors.accent;
ctx.lineWidth = 2;
ctx.stroke();
// Step number
ctx.fillStyle = '#0a0a0f';
ctx.font = 'bold 18px JetBrains Mono, monospace';
ctx.textAlign = 'left';
ctx.textBaseline = 'middle';
ctx.fillText((i + 1) + '.', x + 16, pos.y);
// Title
ctx.fillStyle = '#0a0a0f';
ctx.font = 'bold 16px JetBrains Mono, monospace';
ctx.textAlign = 'center';
ctx.fillText(pos.title, pos.x + 12, pos.y - 10);
// Description (if exists)
if (pos.desc) {
ctx.fillStyle = 'rgba(10, 10, 15, 0.8)';
ctx.font = '14px JetBrains Mono, monospace';
ctx.fillText(pos.desc, pos.x + 12, pos.y + 16);
}
});
// Update and draw particles
particles.forEach(p => {
p.progress += p.speed;
if (p.progress >= 1) {
p.progress = 0;
}
const ease = p.progress * p.progress * (3 - 2 * p.progress);
const x = p.fromX + (p.toX - p.fromX) * ease;
const y = p.fromY + (p.toY - p.fromY) * ease;
ctx.fillStyle = colors.particle;
ctx.shadowColor = colors.particle;
ctx.shadowBlur = 12;
ctx.beginPath();
ctx.arc(x, y, 4, 0, Math.PI * 2);
ctx.fill();
ctx.shadowBlur = 0;
});
time++;
requestAnimationFrame(draw);
}
// Initialize particles
const positions = getStepPositions();
for (let i = 0; i < positions.length - 1; i++) {
const p = createParticle(positions[i], positions[i + 1]);
p.progress = i * 0.3;
particles.push(p);
}
if (!window.matchMedia('(prefers-reduced-motion: reduce)').matches) {
draw();
} else {
// Static version
const positions = getStepPositions();
positions.forEach((pos, i) => {
const x = pos.x - pos.width / 2;
const y = pos.y - pos.height / 2;
ctx.fillStyle = pos.color;
ctx.beginPath();
ctx.roundRect(x, y, pos.width, pos.height, 8);
ctx.fill();
ctx.fillStyle = '#0a0a0f';
ctx.font = 'bold 16px JetBrains Mono';
ctx.textAlign = 'center';
ctx.fillText(pos.title, pos.x, pos.y);
});
}
}
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', initWorkflow);
} else {
initWorkflow();
}
})();
</script>
<style>
.workflow-container {
background: var(--bg-0);
border: 1px solid var(--divider-color);
border-radius: 12px;
padding: 1rem;
margin: 1.5rem 0;
position: relative;
min-height: 550px;
}
.workflow-canvas {
width: 100%;
display: block;
}
@media (max-width: 768px) {
.workflow-container {
padding: 0.5rem;
}
}
</style>
<hr />
<h2 id="inicio-rapido">Inicio Rápido</h2>
<h3 id="instalacion">Instalación</h3>
<p>Instala directamente desde el marketplace de GitHub—no requiere clonar:</p>
<pre data-lang="bash" class="language-bash z-code"><code class="language-bash" data-lang="bash"><span class="z-source z-shell z-bash"><span class="z-comment z-line z-number-sign z-shell"><span class="z-punctuation z-definition z-comment z-begin z-shell">#</span></span><span class="z-comment z-line z-number-sign z-shell"> Añade el marketplace (configuración única)</span><span class="z-comment z-line z-number-sign z-shell">
</span></span><span class="z-source z-shell z-bash"><span class="z-meta z-function-call z-shell"><span class="z-variable z-function z-shell">/plugin</span></span><span class="z-meta z-function-call z-arguments z-shell"> marketplace add Cpicon/claude-code-plugins</span>
</span><span class="z-source z-shell z-bash">
</span><span class="z-source z-shell z-bash"><span class="z-comment z-line z-number-sign z-shell"><span class="z-punctuation z-definition z-comment z-begin z-shell">#</span></span><span class="z-comment z-line z-number-sign z-shell"> Instala el plugin</span><span class="z-comment z-line z-number-sign z-shell">
</span></span><span class="z-source z-shell z-bash"><span class="z-meta z-function-call z-shell"><span class="z-variable z-function z-shell">/plugin</span></span><span class="z-meta z-function-call z-arguments z-shell"> install agent-team-creator</span>
</span></code></pre>
<p>Eso es todo. El plugin está listo para usar inmediatamente.</p>
<h3 id="primeros-comandos">Primeros Comandos</h3>
<ol>
<li>Navega a tu proyecto</li>
<li>Ejecuta <code>/generate-agent-team</code> para crear tus agentes especialistas</li>
<li>Comienza a usar tus especialistas: <code>Usa el agente [nombre-agente] para...</code></li>
<li>Ejecuta <code>/generate-debugger</code> para crear tu project debugger</li>
<li>Usa el debugger para investigar bugs: <code>Usa el agente project-debugger para investigar...</code></li>
<li>Ejecuta <code>/generate-jira-task</code> para convertir el informe de depuración en un ticket</li>
</ol>
<hr />
<h2 id="lo-que-obtienes">Lo Que Obtienes</h2>
<table><thead><tr><th>Comando</th><th>Salida</th><th>Valor</th></tr></thead><tbody>
<tr><td><code>/generate-agent-team</code></td><td>3-6 agentes especialistas</td><td>Ayuda consciente del proyecto para features, preguntas, depuración</td></tr>
<tr><td><code>/generate-debugger</code></td><td>Agente orquestador</td><td>Coordina especialistas para investigaciones complejas</td></tr>
<tr><td><code>/generate-jira-task</code></td><td>Ticket Jira o markdown</td><td>Auto-encuentra último informe, crea ticket accionable</td></tr>
</tbody></table>
<h3 id="ahorro-de-tiempo">Ahorro de Tiempo</h3>
<table><thead><tr><th>Tarea</th><th>Antes</th><th>Después</th></tr></thead><tbody>
<tr><td>Obtener ayuda consciente del proyecto</td><td>N/A (solo genérico)</td><td>Inmediato</td></tr>
<tr><td>Depurar issues complejos</td><td>Horas de investigación</td><td>Informes estructurados</td></tr>
<tr><td>Escribir tickets de Jira</td><td>15-30 min</td><td>2-5 min</td></tr>
</tbody></table>
<hr />
<h2 id="pruebalo-tu-mismo">Pruébalo Tú Mismo</h2>
<p>El plugin es open source y está disponible en GitHub: <a href="https://github.com/Cpicon/claude-code-plugins">Cpicon/claude-code-plugins</a></p>
<p>Instálalo con dos comandos, ejecuta <code>/generate-agent-team</code>, y observa qué especialistas emergen para tu proyecto.</p>
<h3 id="contribuir-y-feedback">Contribuir y Feedback</h3>
<p>¿Tienes ideas para mejoras? ¿Encontraste un bug? La pestaña <a href="https://github.com/Cpicon/claude-code-plugins/issues">GitHub Issues</a> es donde puedes:</p>
<ul>
<li><strong>Solicitar features</strong> — Sugerir nuevas capacidades o mejoras</li>
<li><strong>Reportar bugs</strong> — Ayudar a mejorar la fiabilidad reportando issues que encuentres</li>
<li><strong>Discutir mejoras</strong> — Compartir ideas para mantenimiento y desarrollo del plugin</li>
</ul>
<p>Tu feedback da forma al roadmap del plugin.</p>
<p>En la <a href="/posts/claude-code-plugin-journey-part1/">Parte 1</a>, te mostraré cómo construí este plugin—los bugs que encontré, los patrones que descubrí, y por qué la arquitectura funciona como lo hace.</p>
<hr />
<p><strong>Navegación de la Serie:</strong></p>
<ul>
<li><strong>Parte 0</strong> (Estás aquí): Qué hace el plugin y cómo usarlo</li>
<li><strong>Parte 1</strong>: <a href="/posts/claude-code-plugin-journey-part1/">El Patrón de Arquitectura Híbrida</a> — Construyendo el plugin</li>
<li><strong>Parte 2</strong>: <a href="/posts/claude-code-plugin-journey-part2/">La Paradoja de la Herencia</a> — Insights de investigación</li>
</ul>
Claude Code Plugin Journey Parte 0: Agent Team Creator
¿Qué pasaría si pudieras apuntar una IA a tu proyecto y hacer que genere especialistas que realmente entienden tu stack? No asistentes genéricos—agentes que conocen tu arquitectura, tus patrones, tus convenciones.
Eso es lo que hace agent-team-creator. Déjame mostrarte el flujo de trabajo.
…