Applying SHAPR in AI-Assisted Research Software Development: Lessons Learnt from Building a Share Trading System
Este artículo presenta un caso de estudio sobre la aplicación del marco SHAPR en el desarrollo de un sistema de negociación de acciones asistido por IA, demostrando cómo una configuración de trabajo estructurada con documentación continua y herramientas específicas mejora la trazabilidad, la coherencia y la generación de conocimiento en la investigación de software.
Artículo original bajo licencia CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Esta es una explicación generada por IA del artículo a continuación. No ha sido escrita ni avalada por los autores. Para mayor precisión técnica, consulte el artículo original. Leer descargo de responsabilidad completo
Imagina que estás construyendo una casa muy compleja, pero en lugar de hacerlo solo con tus manos, tienes un asistente robótico superinteligente (la Inteligencia Artificial) que puede poner ladrillos, pintar paredes e incluso diseñar muebles en segundos.
El problema es que este robot es tan rápido y creativo que a veces:
- Cambia el color de la puerta sin avisarte.
- Olvida por qué puso una ventana en un lugar extraño.
- Deja notas desordenadas en el suelo que nadie entiende.
Si solo te fijas en la velocidad, al final tendrás una casa que funciona, pero no sabrás cómo se hizo, quién tomó qué decisión, ni podrás arreglarla fácilmente si algo se rompe.
Este artículo trata sobre cómo evitar ese caos.
El autor, Ka Ching Chan, desarrolló un sistema para negociar acciones (como un videojuego de bolsa) usando esta "mano de obra robótica". Para no perder el control, creó un método llamado SHAPR.
¿Qué es SHAPR? (La analogía del Capitán y el Navegante)
Piensa en SHAPR como un manual de navegación para un barco.
- Tú eres el Capitán (Humano): Tienes la última palabra, decides a dónde ir y por qué. Eres responsable de la dirección.
- La IA es el Navegante (Asistente): Es increíblemente rápido, puede calcular rutas, sugerir atajos y escribir el diario de a bordo, pero no toma las decisiones finales.
El método SHAPR asegura que, aunque el navegante haga el trabajo pesado, el capitán siempre tenga un mapa claro, un registro de por qué se tomaron ciertas decisiones y la capacidad de explicar el viaje a otros.
Las 5 Lecciones Clave (Simplificadas)
El autor aprendió cinco cosas importantes mientras construía su sistema de trading con la ayuda de la IA:
1. Las "Reglas del Juego" (Contratos) evitan el caos
- La analogía: Imagina que le dices al robot: "Hazme una mesa". El robot podría hacer una mesa de madera, una de metal o una de hielo.
- La solución: Antes de empezar, el autor escribió "contratos" (reglas claras): "La mesa debe ser de madera, con 4 patas y un tamaño específico".
- El resultado: La IA no se desvía. El código se mantiene estable porque todos (humano y máquina) saben exactamente qué se espera.
2. El "Cuaderno Maestro" (Fuente de la Verdad)
- La analogía: Si tienes notas sueltas en 100 papeles diferentes, te perderás. Necesitas un solo cuaderno donde se escriba lo que realmente importa.
- La solución: El autor mantuvo un "Cuaderno Maestro" actualizado en tiempo real. Si el robot cambiaba algo, se actualizaba el cuaderno inmediatamente.
- El resultado: Nunca hubo confusión sobre en qué estado estaba el proyecto. Todo el mundo (incluso el robot) miraba la misma hoja de ruta.
3. Las "Fotos de los Hitos" (Instantáneas)
- La analogía: Cuando viajas, tomas fotos en cada ciudad importante para no olvidar cómo llegaste allí.
- La solución: Al terminar cada etapa del proyecto (cada "ciclo"), el autor tomaba una "foto" (guardaba el estado del código y las notas) antes de empezar la siguiente.
- El resultado: Si algo salía mal en la etapa 5, podía volver atrás a la foto de la etapa 4 y saber exactamente dónde estaba bien.
4. Escribir mientras se construye (Captura Rápida)
- La analogía: Es como tener una grabadora de voz en el bolsillo. Cuando tienes una idea brillante o ves un error, lo grabas al instante en lugar de esperar a escribir un informe largo al final del día.
- La solución: El autor usaba notas rápidas ("quick captures") para anotar ideas al vuelo. Luego, la IA ayudaba a ordenar esas notas rápidas en documentos bonitos y claros.
- El resultado: No se perdían ideas geniales por pereza de escribir, y el trabajo final estaba bien organizado.
5. Preparar la cocina antes de cocinar (El Entorno)
- La analogía: Un chef no empieza a cortar verduras si no tiene los cuchillos afilados y las tablas listas.
- La solución: El tiempo que se dedicó a configurar las herramientas (el software, las carpetas, las reglas) no fue tiempo perdido; fue parte de la investigación.
- El resultado: Al tener todo organizado desde el principio, el proceso de construcción fue mucho más fluido y generó más conocimiento.
¿Qué herramientas usaron? (La "Trinidad" Tecnológica)
El autor no usó una sola herramienta mágica, sino que conectó tres herramientas que trabajaban juntas:
- ChatGPT (El Navegante): Para conversar, razonar y escribir código.
- PyCharm (El Taller): Donde se construía el código real.
- Obsidian (El Cuaderno de Bitácora): Donde se guardaban todas las notas, decisiones y el "Cuaderno Maestro".
En Resumen
Este artículo nos dice que usar Inteligencia Artificial para investigar o crear software es genial, pero no basta con ser rápido.
Para que el trabajo sea útil y científico, necesitas:
- Tener el control: Tú eres el jefe, la IA es tu empleado.
- Escribir mientras trabajas: No dejes las notas para el final.
- Guardar tu progreso: Toma fotos de tu trabajo en cada paso.
- Ser flexible: Puedes usar las herramientas que quieras, siempre que mantengas el orden.
Es como construir una casa con un ayudante robot: si sigues las reglas, tendrás una casa increíble; si no, tendrás un montón de ladrillos y un robot confundido. SHAPR es el manual para que la casa quede perfecta.
¿Ahogado en artículos de tu campo?
Recibe resúmenes diarios de los artículos más novedosos que coincidan con tus palabras clave de investigación — con resúmenes técnicos, en tu idioma.