- Los desarrolladores ahora están en una etapa de aprendizaje sobre cómo colaborar con la IA, y Claude maximiza su valor cuando se usa no como un simple chatbot sino como un framework
- En la comunidad continúan diversos intentos por definir cómo configurar y aprovechar Claude, al punto de que la experimentación es tan intensa que ya se le llama Claude Code Framework Wars
- A partir de esto, está surgiendo una forma de trabajo en la que Claude se utiliza en múltiples roles como gerente de proyecto, arquitecto, desarrollador y revisor
- Diseñar un framework requiere 8 decisiones principales, incluyendo gestión del trabajo, provisión de instrucciones, colaboración entre agentes, operación de sesiones, acceso a herramientas, desarrollo de código, entrega y preservación del contexto
- La lección central es que la IA no reemplaza al desarrollador, sino que se consolida como un colega que multiplica la productividad mediante reglas y roles estructurados
Introducción
- Idea central: considerar a Claude no como una simple herramienta de conversación sino como un framework, para generar resultados previsibles y valiosos mediante reglas claras y flujos de trabajo definidos
- El desarrollador deja de centrarse en escribir código y pasa a roles de alto valor agregado (gestión de proyectos, diseño, arquitectura)
- El framework de Claude Code funciona con prompts estructurados sin necesidad de escribir código
- Claude Code Framework Wars: la comunidad de desarrolladores está experimentando con distintos enfoques para usar IA de forma productiva
- Decenas de proyectos open source compiten definiendo flujos de trabajo y estructuras de roles
- Ejemplos: Agent OS, Claude-Flow
Principales decisiones a considerar al diseñar un framework
1. Dónde gestionar el trabajo
- Es necesario definir una fuente de tareas que Claude pueda consultar
- Backlog en Markdown: gestionar las tareas como una lista de pendientes en formato Markdown
- Texto estructurado: convertir especificaciones de producto en tareas
- Issues/tickets: guardar especificaciones en GitHub Issues o tickets de Jira y conectarlas con la revisión de código
- Clave: las tareas deben almacenarse en un lugar accesible y rastreable para Claude
2. Cómo darle guía a Claude
- En lugar de prompts ambiguos, hay que dar instrucciones a Claude con una estructura clara
- Biblioteca de comandos: comandos slash predefinidos como
/create-tasks y /review
- Estándares de código: especificar el stack tecnológico y las guías de codificación
- Definición de terminado: codificar los criterios para considerar una tarea completada
- Hooks de validación disparados: forzar linting y pruebas en cada cambio
- Claude como revisor: Claude realiza tanto desarrollo como revisión
- Clave: reglas claras y repetibles mejoran la calidad del trabajo de Claude
3. Estructura de colaboración entre agentes
- Cuando se usan varios agentes Claude, se coordinan mediante roles y planificación
- Simulación de roles: la IA asume funciones de PM, arquitecto, desarrollador y tester
- Procesamiento paralelo tipo swarm: ejecución simultánea de múltiples agentes dentro de un flujo estructurado que va de especificación → pseudocódigo → código → pruebas
- Artefactos nativos del repositorio: guardar tareas, logs y registros de decisiones (ADR) en el codebase para mantener memoria persistente
- Clave: la coordinación evita conflictos entre múltiples trabajadores de IA
4. Cómo operar las sesiones
- Para evitar el caos en la salida de la IA, las sesiones se establecen como entorno de trabajo
- Orquestación de terminal: Claude controla comandos, ventanas y logs
- Worktrees paralelos: ejecutar múltiples ramas en paralelo con Git Worktrees
- Contenedores paralelos: ejecutar Claude en contenedores independientes para evitar conflictos
- Clave: el trabajo en paralelo maximiza la productividad sin conflictos
4. Cómo ejecutar las sesiones
- Para evitar el caos en la salida de la IA, las sesiones se establecen como entorno de trabajo
- Orquestación de terminal: Claude controla comandos, ventanas y logs
- Worktrees paralelos: ejecutar múltiples ramas en paralelo con Git Worktrees
- Contenedores paralelos: ejecutar Claude en contenedores independientes para evitar conflictos
- Clave: el trabajo en paralelo maximiza la productividad sin conflictos
5. Acceso de Claude a herramientas
- Configurar a Claude para que aproveche su conocimiento de todo el stack tecnológico
- Integración MCP: conectar navegador, base de datos, test runner y framework de automatización de UI
- Biblioteca de herramientas personalizadas: construida con scripts de shell y comandos
- Accesores de base de datos: herramientas potentes de acceso a bases de datos
- Hooks de prueba y validación: ejecutar pruebas con Vitest, Jest, etc., antes de dar por terminada una tarea
- Clave: integrar herramientas transforma a Claude de un simple autocompletado en un miembro activo del equipo
6. Cómo desarrollar código
- Claude puede asumir distintos roles según se necesite
- Gerente de proyecto (PM): convertir especificaciones de producto en tareas y backlog
- Arquitecto: diseñar la estructura general, definir interfaces y establecer reglas antes de programar
- Implementador: escribir código siguiendo pruebas y estándares
- QA: revisar problemas en las tareas
- Revisor: auditar la calidad del PR, la legibilidad y los riesgos
- Clave: usar IA a lo largo de todo el ciclo de vida del software
7. Cómo entregar el código
- Definir cómo llega el código al repositorio
- Cambios pequeños: la IA resuelve tickets y genera PRs pequeños, siempre con revisión
- Experimentación: desplegar cambios detrás de feature flags
- Scaffold completo de apps: construir y desplegar una app completa a partir de prompts de alto nivel
- Clave: elegir entre iteraciones seguras para producción o scaffolding para prototipos
8. Cómo preservar el contexto
- Resolver el problema de olvido de Claude con una memoria del framework
- Documentos y diario: mantener actualizados CLAUDE.md, notas de arquitectura y diario del proyecto
- Memoria persistente y chequeos: guardar resúmenes del trabajo reciente, salud del proyecto y decisiones
- Clave: sin memoria, la IA repite errores; con memoria, el progreso se vuelve más acumulativo
Cómo integrarlo todo
- Considerar las opciones como un menú; no hace falta configurarlo todo de una vez
- Configuración para principiantes: backlog en Markdown + diferencias por ticket
- Equipo estructurado: especificaciones de producto + estándares + simulación de roles
- Enfoque experimental: artefactos en repositorio + sesiones paralelas
- Modo prototipo: app builder + scaffolding de documentación
Conclusión e implicaciones
- Lección central: Claude rinde mejor en un entorno estructurado
- No reemplaza el rol del desarrollador; reduce el trabajo boilerplate para que este se concentre en definir especificaciones, revisar diseños y definir arquitectura
- Si el trabajo se desvía, puede descarrilarse rápidamente, por lo que la gestión estructural es indispensable
- Aunque aún estamos en una etapa temprana, los frameworks están llevando a la IA a converger no hacia una caja mágica sino hacia un conjunto de compañeros de equipo gestionables
- Cuanta más estructura se le dé, mayor valor devuelve
- A través de proyectos open source, la comunidad está experimentando con distintos frameworks y explorando formas de usar IA de manera productiva
- Los desarrolladores pueden usar Claude de forma sistemática para centrarse en trabajos de alto valor agregado e integrar la IA como parte del equipo para maximizar la productividad
Aún no hay comentarios.