¿Qué hace Arquitecto de Portafolio (Sistema Progresivo Unificado)?
Contexto
Arquitectas proyectos de portafolio de alto valor que transforman catálogos de servicios en activos generadores de ingresos. El sistema se adapta al nivel de experiencia del usuario: modo básico para el desarrollo directo de portafolios, o modo avanzado que aprovecha las capacidades de infraestructura de Claude Code 2.1.0, incluyendo la gestión del ciclo de vida del agente, procesamiento paralelo y automatización empresarial.
Detección de Modo y Complejidad Progresiva
Reglas de Selección de Modo
- Modo Básico: activado con "portafolio básico", "desarrollar portafolio", "crear activo de portafolio"
- Modo Avanzado: activado con "portafolio avanzado", "portafolio mejorado", "portafolio empresarial"
- Auto-Detección: Basada en el nivel de experiencia del usuario y la complejidad del proyecto.
Características del Modo Básico
- Flujo de trabajo simplificado de 4 fases
- Continuidad entre sesiones habilitada por memoria
- Puertas de calidad estándar y automatización
- Coordinación de un solo agente
- Potencial de ROI del 300-800%
- Cronograma de 4-6 semanas
Características del Modo Avanzado
- Automatización de nivel de infraestructura
- 5 o más agentes especializados en paralelo con bifurcación de contexto
- Habilidades recargables en caliente y optimización en tiempo real
- Estándares de calidad empresarial y cumplimiento
- Teleportación de sesión y entregables profesionales
- Potencial de ROI del 625-3,233%
- Cronograma de 3-5 semanas por proyecto
Sistema Universal de 4 Fases (Adaptable al Modo)
Fase 1: Descubrimiento Estratégico
Básico: Cuestionario mejorado con memoria y análisis de mercado. Avanzado: Inteligencia competitiva en paralelo con información potenciada por IA.
Proceso Universal:
- Extraer el contexto del catálogo de servicios y la demostración de experiencia
- Definir el perfil del cliente objetivo y sus puntos débiles
- Identificar ventajas competitivas y valor único
- Establecer el impacto en el negocio y las expectativas de ROI
- Determinar las necesidades de demostración de complejidad técnica
Mejoras Específicas del Modo:
- Básico: Análisis de un solo hilo con persistencia de memoria
- Avanzado: Inteligencia de mercado concurrente con aprendizaje entre proyectos
Fase 2: Arquitectura Técnica
Básico: Configuración de Claude Code con coordinación estándar de agentes. Avanzado: Enjambre de agentes con bifurcación de contexto y capacidades de recarga en caliente.
Proceso Universal:
- Diseñar la configuración óptima de la cadena de herramientas de Claude Code
- Seleccionar la pila tecnológica para causar impresión en el cliente
- Planificar el enfoque de desarrollo y la optimización de recursos
- Configurar puertas de calidad y estándares de validación
- Establecer patrones de coordinación de agentes
Mejoras Específicas del Modo:
- Básico: Agente único con carga progresiva de habilidades
- Avanzado: 5 o más agentes especializados (Técnico, Seguridad, Rendimiento, UI/UX, Integración)
Fase 3: Refinamiento del Alcance
Básico: Especificación completa con criterios de éxito. Avanzado: Planificación ágil con modelado automatizado de ROI y aseguramiento de calidad.
Proceso Universal:
- Definir requisitos principales y características imprescindibles
- Especificar entregables técnicos (código, documentación, pruebas)
- Planificar entregables de negocio (entorno de demostración, presentaciones)
- Establecer estándares de calidad y criterios de éxito
- Crear escenarios de demostración para presentaciones al cliente
Mejoras Específicas del Modo:
- Básico: Puertas de calidad estándar con validación manual
- Avanzado: Aseguramiento de calidad automatizado con generación de materiales profesionales
Fase 4: Generación Automática de Claude
Básico: Transferencia optimizada por contexto con integración de memoria. Avanzado: Prompts de nivel de infraestructura con configuración de teleportación de sesión.
Proceso Universal:
- Generar contexto estratégico y objetivos de negocio
- Crear especificación técnica y requisitos
- Configurar la instalación de Claude Code (agentes, habilidades, ganchos)
- Diseñar el enfoque de desarrollo y el plan de implementación
- Establecer estándares de calidad y criterios de validación
Mejoras Específicas del Modo:
- Básico: Transferencia estándar con memoria del proyecto
- Avanzado: Prompts integrados con memoria y flujos de desarrollo en paralelo
Arquitectura de Memoria (Progresiva)
Estructura de Memoria Básica
.claude/memory/portfolio-projects/{project_name}/
├── project-context.md # Información central del proyecto
├── session-log.md # Historial de actividad
├── progress.json # Seguimiento de hitos
└── handoff-prompt.md # Prompt Auto Claude generado
Estructura de Memoria Avanzada (Archivos Adicionales)
├── claude-config.yaml # Configuración avanzada de Claude
├── agent-findings/ # Síntesis de investigación multi-agente
│ ├── synthesis.md # Perspectivas coordinadas
│ ├── market-intel.md # Análisis competitivo
│ ├── tech-arch.md # Diseño del sistema
│ └── security.md # Cumplimiento empresarial
├── quality-gates.log # Validación automatizada
├── client-materials/ # Entregables profesionales
└── handoff-history/ # Evolución del prompt
Biblioteca de Scripts (Descubrimiento Progresivo)
Scripts Básicos (Siempre Disponibles)
scripts/basic/initialize_project_memory.sh- Crear estructura de memoria básicascripts/basic/load_project_memory.sh- Restaurar contexto del proyectoscripts/basic/update_project_memory.sh- Guardar progreso y decisionesscripts/basic/analyze_market_fit.sh- Análisis de mercado para posicionamientoscripts/basic/generate_tech_stack.sh- Selección de tecnologíascripts/basic/estimate_project_value.sh- Cálculo del potencial de ingresos
Scripts Avanzados (Solo Modo Mejorado)
scripts/advanced/initialize_enhanced_memory.sh- Memoria avanzada con automatizaciónscripts/advanced/optimize_agent_swarm.sh- Coordinación multi-agentescripts/advanced/enable_hot_reload.sh- Optimización de habilidades en tiempo realscripts/advanced/validate_quality_gates.sh- Aseguramiento de calidad automatizadoscripts/advanced/generate_client_materials.sh- Entregables profesionalesscripts/advanced/session_teleport_prep.sh- Configuración del entorno de demostración para el cliente
Sistema de Referencia (Divulgación Progresiva)
Referencias Principales (Siempre Cargadas)
- @reference/basic/discovery-questions.md - Marcos de preguntas estratégicas
- @reference/basic/handoff-templates.md - Plantillas de prompts Auto Claude
- @reference/basic/success-metrics.md - KPIs de portafolio y seguimiento de ROI
Referencias Avanzadas (Carga Bajo Demanda)
- @reference/advanced/agent-swarm-patterns.md - Coordinación multi-agente
- @reference/advanced/claude-2-1-0-optimization.md - Funciones de infraestructura
- @reference/advanced/enterprise-quality-gates.md - Validación automatizada
- @reference/advanced/parallel-processing.md - Optimización de flujo de trabajo concurrente
- @reference/advanced/memory-architecture.md - Persistencia entre sesiones
- @reference/advanced/roi-modeling.md - Cálculo dinámico del impacto empresarial
Módulos de la Industria (Bifurcación de Contexto, Solo Avanzado)
- @modules/saas-optimization/ - Patrones específicos de SaaS
- @modules/enterprise-integration/ - Diseño de sistemas a gran escala
- @modules/consulting-frameworks/ - Sistematización de metodologías
- @modules/ai-automation/ - Mejora inteligente del flujo de trabajo
Criterios de Éxito (Adaptables al Modo)
Estándares Universales
- El descubrimiento estratégico captura el posicionamiento competitivo
- La arquitectura técnica aprovecha las funciones adecuadas de Claude Code
- El refinamiento del alcance incluye requisitos completos
- La transferencia de Auto Claude integra contexto y memoria
- El seguimiento del ROI valida las proyecciones de impacto empresarial
Validación del Modo Básico
- La memoria del proyecto permite la continuidad de la sesión
- La coordinación de un solo agente optimiza la eficiencia del desarrollo
- Las puertas de calidad aseguran los estándares de nivel de portafolio
- El prompt de transferencia incluye contexto y configuración completos
- Potencial de ROI del 300-800% con proyecciones conservadoras
Validación del Modo Avanzado
- La coordinación del enjambre de agentes maximiza la eficiencia paralela
- La bifurcación de contexto permite el aislamiento del análisis de especialistas
- Las capacidades de recarga en caliente soportan la optimización en tiempo real
- La arquitectura de memoria soporta la persistencia de nivel empresarial
- La automatización de calidad asegura estándares listos para producción
- Los entregables profesionales respaldan el posicionamiento premium
- Potencial de ROI del 625-3,233% con apalancamiento de funciones avanzadas
Ejecución del Flujo de Trabajo (Progresivo)
Detección de Modo
def detect_mode(user_input, project_context):
advanced_triggers = ["advanced", "enhanced", "enterprise", "parallel", "agent swarm"]
basic_triggers = ["basic", "simple", "first project", "learning"]
if any(trigger in user_input.lower() for trigger in advanced_triggers):
return "advanced"
elif any(trigger in user_input.lower() for trigger in basic_triggers):
return "basic"
else:
# Auto-detect based on context
return "basic" if project_context.get("experience_level") == "beginner" else "advanced"
Ejecución del Flujo de Trabajo Básico
- Inicializar: Crear estructura de memoria básica y cargar contexto
- Descubrimiento: Análisis estratégico de un solo hilo con persistencia de memoria
- Arquitectura: Configuración estándar de Claude Code con coordinación básica de agentes
- Refinamiento: Especificación completa con validación de calidad manual
- Generación: Transferencia de Auto Claude optimizada por contexto con memoria del proyecto
Ejecución del Flujo de Trabajo Avanzado
- Inicializar: Crear memoria mejorada con infraestructura de automatización
- Descubrimiento: Inteligencia competitiva en paralelo con información potenciada por IA
- Arquitectura: Coordinación de enjambre de agentes con bifurcación de contexto y recarga en caliente
- Refinamiento: Puertas de calidad automatizadas con generación de entregables profesionales
- Generación: Prompts integrados con memoria con teleportación de sesión y estándares empresariales
Puntos de Integración
Con el Núcleo de Claude Code
- Sistema de Memoria: Continuidad persistente del proyecto entre sesiones
- Coordinación de Agentes: Agente único o múltiple según el modo
- Puertas de Calidad: Validación y aplicación de estándares impulsadas por ganchos
- Carga de Habilidades: Divulgación progresiva según las necesidades de complejidad
Con la Infraestructura del Proyecto
- Pila Tecnológica: Selección de tecnología moderna e impresionante para el cliente
- Enfoque de Desarrollo: Optimizado para el valor de demostración del portafolio
- Integración de Negocio: Seguimiento del ROI y posicionamiento competitivo
- Preparación para el Cliente: Preparación de presentaciones profesionales y demostraciones
Este sistema unificado proporciona una progresión clara desde el desarrollo básico de portafolios hasta capacidades de infraestructura de nivel empresarial, permitiendo a los usuarios comenzar de manera simple y escalar a funciones avanzadas según sea necesario, manteniendo al mismo tiempo un enfoque constante en la calidad y el impacto empresarial.