Agenda

  • 01 El Momento + Octoverse — 4 min
  • 02 Pair → Peer + 70/30 — 10 min
  • 03 Los 6 Elementos — 14 min
  • 04 Demo: Agent Team — 8 min
  • 05 Standards + Control — 17 min
  • 06 Quick Wins — 7 min
01

El Momento

Los números que importan ahora

Los números

  • 180 millones de developers en GitHub
  • 80% de nuevos usuarios adoptan Copilot en semana 1
  • 1.1M+ repos usando LLM SDKs (+178% YoY)
El desarrollo con agentes ya no es experimental.

Agent HQ: El nuevo hogar

  • Workflow unificado para flotas de agentes
  • Múltiples vendors, un control plane
  • agents.md como fuente de verdad
"Orquesta una flota de especialistas, no malabarear herramientas."

El problema real

  • La mayoría usa AI como autocomplete glorificado
  • Copian prompts de Twitter
  • "You are a helpful assistant" no funciona
Los agentes efectivos son especialistas con instrucciones precisas.
02

De Pair a Peer

El modelo que cambió todo

De Pair a Peer

PAIR

Humano ←→ Copilot

"Dame una función que ordene este array"

→

PEER

Humano → @test-agent.sgent

"Estos 3 endpoints necesitan tests"

De micromanagear → Delegar tareas completas

70% rápido, 30% difícil

  • 70%: CRUD, boilerplate, docs → minutos
  • 30%: Legacy, edge cases, debugging → humano
  • El 30% requiere juicio y contexto
AI te da velocidad. Tú aportas el craft.

AI Boost vs AI Drag

  • Seniors: productividad multiplicada
  • Juniors: luchan sin contexto para verificar
  • "The narrowing pyramid hypothesis"
Russinovich & Hanselman: preceptorship explícito — seniors enseñan a juniors a auditar, no solo a aceptar.
03

Los 6 Elementos

Anatomía de un agente que funciona

Por qué el 80% falla

😱 Esto es lo que vemos:

# Agent Instructions
You are a helpful coding assistant.
Be clear and concise.
Follow best practices.
Eso es decirle a un junior: "escribe buen código".

1) Persona específica

😱 Malo

You are a helpful assistant.

😌 Bueno

You are a test engineer
specializing in React and 
Node.js applications.
Rol claro = mejores decisiones.

2) Comandos ejecutables

## Quick Commands
- @test component [path] — genera tests para un componente
- @test api [endpoint] — genera tests para un endpoint  
- @test coverage — ejecuta el reporte de cobertura
Comandos > párrafos. Ponlos al principio.

3) Ejemplo de output esperado

describe('UserCard', () => {
  it('displays user email', () => {
    // Arrange
    const user = { name: 'Andrea' };
    // Act
    render(<UserCard user={user} />);
    // Assert
    expect(screen.getByText('Andrea')).toBeInTheDocument();
  });
});
Un ejemplo vale más que tres párrafos.

4) Always / Ask / Never

## Always Do
- Usar Jest + React Testing Library
- Seguir AAA: Arrange, Act, Assert

## Ask First
- Antes de testear integraciones third-party

## Never Do
- Modificar código fuente
- Eliminar tests que fallan

Cicatriz → Regla

"Arregla tests"

→ Interpretó: hacer que pasen
→ Borró los que fallaban
→ CI pasó ✓
→ Producción falló ✗
Never delete failing tests.

Los boundaries no son burocracia. Son cicatrices convertidas en reglas.

5) Tech stack + versiones

## Tech Stack
- React 18.2.0
- Jest 29.5.0
- React Testing Library 14.0.0
- TypeScript 5.1.0
- Node.js 20 LTS
Versiones específicas previenen sugerencias obsoletas.

6) Context & Knowledge (NUEVO)

## Project Context
### Architecture
- Monorepo con Turborepo
- /packages/ui — componentes React

### Where You Operate
- Can write: /__tests__
- Can read: anywhere
- Cannot touch: source code
Context reduce 70% de errores de integración.
04

Demo: Agent Team

4 agentes especializados

El equipo de agentes

Agente Función Límite crítico
@docs-agent Genera y mantiene docs Nunca modifica código fuente
@test-agent Escribe y mantiene tests Nunca borra tests que fallan
@api-agent Crea/edita endpoints Pregunta antes de schema
@dev-deploy Deploy a dev Nunca deploya a prod
Cada agente = junior con manual perfecto.
📺 DEMO / SCREEN SHARE

@test-agent completo

  • .github/agents/test-agent.agent.md
  • Quick Commands
  • Tech Stack con versiones
  • Always / Ask / Never
  • Code Style Examples

Bonus: Skills y Subagents

  • Skills: capacidades modulares (coverage-report, mock-apis)
  • Subagents: agentes que orquestan otros
  • @release-agent → coordina test + docs + deploy
Arquitectura modular = más mantenible.
05

Standards
Before Speed

El patrón de los equipos que ganan

Métricas equivocadas

  • 😱 PRs merged por semana
  • 😱 Líneas de código generadas
  • 😱 Features por sprint
Explotan con agentes pero no significan calidad.

Métricas correctas

  • 😌 Developer satisfaction ("¿Te sientes productivo?")
  • 😌 Time-to-first contribution de nuevos devs
  • 😌 Incidentes post-merge + retención de juniors
Mide experiencia, no volumen.

Lo que cambia con agentes

  • Fallas más rápido, pero más grande
  • El trabajo se mueve al review
  • Security: logs, supply chain, secrets
Si no arreglas review, solo cambias dónde sufres.

Branch Strategy

Branch Protección Agentes
main Require 2 approvals No pueden mergear
staging Require 1 approval Pueden abrir PRs
feature/* No protection Pueden commitear
Define esto hoy. Blast radius controlado.
06

Quick Wins

3 cosas para esta semana

Quick Win #1

Crea tu primer agents.md

  • Elige UN solo agente: @test-agent
  • Usa los 6 elementos
  • Guarda en .github/agents/
Tests = scope claro, riesgo bajo, impacto alto.
Quick Win #2

Audita tu primer agente

  • Ejecuta en 5-10 archivos pequeños
  • ¿Qué hizo bien? ¿Dónde falló?
  • Actualiza agents.md con feedback
Esta retroalimentación es valiosa. Itera.
Quick Win #3

Prepara tu branch strategy

  • ¿Quién puede mergear qué?
  • ¿Dónde opera un agente sin supervisión?
  • ¿Dónde necesitas approval humana?
Documenta antes de que sea urgente.

Si recuerdas 3 cosas

1

Fundamentals first, always

Si tus estándares son claros para humanos, funcionan para agentes.

2

Mide experiencia, no output

Velocidad sin calidad = deuda técnica con mejor marketing.

3

Fluency over dependency

El mejor dev sabe cuándo NO usar agentes.

¡Gracias!

Andrea Griffiths

Senior Developer Advocate, GitHub

𝕏 @acolombiadev

LinkedIn: in/acolombiadev

"Fundamentals first, always"

1 / 35