Brownfield
Brownfield describe un proyecto que se desarrolla sobre un sistema, producto o codebase ya existente. En desarrollo con IA y Spec-Driven Development (SDD), los contextos brownfield requieren especial cuidado porque el agente debe respetar arquitectura, deuda técnica, contratos existentes y decisiones previas.
Un proyecto brownfield no empieza desde cero. Parte de algo que ya existe: código, usuarios, datos, integraciones, procesos, deuda técnica, restricciones y decisiones acumuladas.
Esto cambia profundamente la forma de trabajar.
Diferencia con greenfield
| Contexto | Característica principal |
|---|---|
| Greenfield | Se parte de cero o casi cero. |
| Brownfield | Se trabaja sobre un sistema existente. |
En brownfield, el reto no es solo construir. Es construir sin romper.
Riesgos habituales
- Dependencias ocultas.
- Código legacy difícil de entender.
- Tests insuficientes.
- Contratos públicos que no pueden cambiar.
- Deuda técnica acumulada.
- Documentación incompleta.
- Integraciones con terceros.
- Usuarios que dependen de comportamientos existentes.
- Restricciones de datos o migraciones.
Brownfield e IA
Los agentes de IA pueden ser peligrosos en brownfield si no reciben suficiente contexto. Pueden generar código plausible que encaja mal con la arquitectura, duplica lógica existente o rompe comportamientos no documentados.
Antes de asignar tareas a IA en brownfield, conviene proporcionar:
- arquitectura relevante;
- patrones del repositorio;
- tests existentes;
- restricciones;
- contratos públicos;
- zonas que no deben tocarse;
- criterios de regresión;
- boundaries Always / Ask First / Never.
Buenas prácticas
- Empezar por tareas pequeñas.
- Usar specs más explícitas.
- Aumentar revisión humana.
- Ejecutar tests de regresión.
- Pedir al agente que lea antes de modificar.
- Proteger zonas críticas del código.
- Mantener trazabilidad de cambios.
- Evitar refactorizaciones amplias sin aprobación.
Error frecuente
Tratar un sistema existente como si fuera un lienzo en blanco. En brownfield, cada cambio convive con decisiones previas, usuarios reales y restricciones acumuladas. Ignorar ese contexto produce roturas, deuda técnica y regresiones.
Recursos
🏦 Harness EngineeringSkill Arena · Scrum Manager
🏦 Scrum en equipos con IASkill Arena · Scrum Manager
🏦 SDD - Spec Driven Development en equipos ágilesSkill Arena · Scrum Manager
📊 Guía didáctica SDDRecursos · Scrum Manager
📊 Guía didáctica Scrum en equipos con IARecursos · Scrum Manager
Véase también
¿Quieres avanzar en agilidad? Puedes buscar convocatorias de cursos y exámenes o ir a tu ritmo haciéndote miembro del Club Agile. Esta membresía incluye recursos exclusivos, aulas e-learning y acceso a Skill Arena: un espacio para practicar y medir tus habilidades ágiles a tu ritmo.