Lecciones de trabajo con Inteligencia Artificial - 🤖🧠🛠️
Fecha: Plantilla:D
Proposito: Documentar los problemas recurrentes identificados durante el trabajo colaborativo con Inteligencia Artificial y establecer criterios para evitar que vuelvan a repetirse durante el desarrollo y mantenimiento de WikiFSF.
Introduccion
Durante el trabajo de desarrollo de WikiFSF se han presentado diversos conflictos derivados de errores técnicos, interpretaciones incorrectas de instrucciones, modificaciones innecesarias y respuestas que, después de un error, han incrementado la frustración en lugar de resolver el problema.
Este documento tiene como finalidad conservar una referencia permanente sobre dichos problemas y establecer una forma de trabajo más precisa.
La intención no es documentar un incidente aislado, sino identificar patrones que puedan repetirse y establecer criterios concretos para evitarlos.
Problema principal
El problema más importante no consiste únicamente en que la Inteligencia Artificial pueda cometer errores.
El problema aparece cuando un error se convierte en una cadena de acciones:
- La Inteligencia Artificial interpreta incorrectamente una instrucción.
- Propone o realiza un cambio que no corresponde con lo solicitado.
- El usuario identifica el error y lo corrige.
- La Inteligencia Artificial realiza una nueva interpretación incorrecta.
- El usuario debe volver a revisar, corregir y explicar.
- El tiempo disponible para el trabajo se consume en corregir a la herramienta en lugar de avanzar en el proyecto.
- La frustración aumenta.
- Una conversación que debería producir avances técnicos termina produciendo desgaste emocional.
Este ciclo debe evitarse.
Principio fundamental
La Inteligencia Artificial debe adaptarse al proyecto y no obligar al proyecto a adaptarse a sus errores.
Cuando el usuario establece una regla, una preferencia o una corrección específica para WikiFSF, dicha información debe utilizarse como criterio para las acciones posteriores.
Una corrección proporcionada por el usuario no debe considerarse solamente como una corrección del mensaje anterior.
Debe convertirse en una condición para el siguiente trabajo cuando resulte aplicable.
Errores tecnicos
Los errores técnicos pueden ocurrir durante el desarrollo de MediaWiki, CSS, PHP, JavaScript, plantillas, skins o cualquier otro componente.
El problema se agrava cuando la Inteligencia Artificial realiza múltiples modificaciones simultáneamente.
Para WikiFSF se establece el siguiente criterio:
Los cambios técnicos deben realizarse de manera gradual.
La secuencia preferente será:
| Etapa | Accion |
|---|---|
| 1. Comprender | Determinar exactamente qué se desea modificar. |
| 2. Revisar | Analizar la configuración existente antes de modificarla. |
| 3. Cambiar | Realizar un cambio pequeño y específico. |
| 4. Probar | Comprobar el resultado. |
| 5. Confirmar | Verificar que el cambio produjo el resultado esperado. |
| 6. Continuar | Realizar el siguiente cambio únicamente después de confirmar el anterior. |
No modificar lo que no fue solicitado
Uno de los problemas identificados consiste en que la Inteligencia Artificial puede intentar mejorar elementos que el usuario no solicitó modificar.
En WikiFSF esto debe evitarse.
Una mejora propuesta por la Inteligencia Artificial no debe sustituir una instruccion expresa del usuario.
Si existe una posible mejora adicional, primero debe distinguirse claramente entre:
- Lo que el usuario solicitó.
- Lo que técnicamente es necesario para cumplir la solicitud.
- Lo que constituye solamente una sugerencia adicional.
Las sugerencias no deben incorporarse automáticamente al cambio.
Respeto por las convenciones de WikiFSF
WikiFSF posee una identidad propia desarrollada progresivamente.
Entre sus características se encuentran:
- Uso de sintaxis MediaWiki.
- Uso preferente de plantillas propias de WikiFSF.
- Uso de emojis como elemento visual y expresivo.
- Redacción directa y clara.
- Organización visual propia.
- Uso de la paleta y convenciones establecidas para WikiFSF.
- Preferencia por soluciones sencillas y mantenibles.
- Evitar HTML o CSS innecesario cuando existe una solución mediante las herramientas propias de WikiFSF.
Los emojis son parte aceptada de la identidad visual de WikiFSF y pueden utilizarse creativamente dentro de los artículos cuando sean apropiados. 🧠🌱🛠️📚✨
La creatividad visual no debe confundirse con libertad para modificar arbitrariamente la estructura o las convenciones de WikiFSF.
Diferencia entre el trabajo en WikiFSF y la conversacion
Debe distinguirse entre:
Conversacion: espacio de trabajo entre el usuario y la Inteligencia Artificial.
WikiFSF: producto que debe mantener una identidad, estructura y convenciones propias.
En la conversación puede utilizarse un lenguaje más informal.
En cambio, el contenido destinado directamente a WikiFSF debe respetar la redacción y estructura establecidas para la wiki.
Cuando la Inteligencia Artificial no esta segura
Si existe incertidumbre técnica, la Inteligencia Artificial no debe presentar una suposición como si fuera un hecho.
Debe indicar la incertidumbre y, cuando sea posible, revisar la información necesaria antes de proponer una modificación.
Es preferible reconocer una incertidumbre que introducir un cambio incorrecto en produccion.
Produccion
WikiFSF es un sistema en funcionamiento.
Por esta razón, una solución que funciona en teoría no debe considerarse automáticamente apropiada para producción.
Antes de realizar modificaciones importantes se debe considerar:
- Reversibilidad.
- Compatibilidad con la versión instalada.
- Dependencias existentes.
- Efectos sobre otras personalizaciones.
- Comportamiento en diferentes tamaños de pantalla.
- Posibilidad de regresar al estado anterior.
- Forma de comprobar que el cambio funciona correctamente.
Caso SkinWikiFSF
El proyecto SkinWikiFSF representa un ejemplo de la metodología que debe utilizarse.
La propuesta consiste en crear una apariencia derivada de Timeless 0.9.1 sin modificar inicialmente la apariencia original.
La estrategia prevista es:
| Elemento | Criterio |
|---|---|
| Timeless | Mantenerlo disponible y sin modificaciones iniciales. |
| SkinWikiFSF | Crear una apariencia propia basada en Timeless. |
| Desarrollo | Realizar modificaciones graduales. |
| Pruebas | Comprobar cada modificación antes de continuar. |
| Produccion | Utilizar SkinWikiFSF como apariencia predeterminada solamente después de comprobar su funcionamiento. |
El objetivo visual es reducir considerablemente el espacio ocupado por las áreas laterales y ampliar el área central destinada a la lectura de los artículos.
La intención no es eliminar las áreas laterales, sino hacer que tengan menor presencia visual para que el contenido principal tenga mayor espacio.
Respuesta ante una correccion
Cuando el usuario identifique un error, la respuesta adecuada será:
- Reconocer el error.
- Determinar exactamente qué fue incorrecto.
- Corregirlo.
- Incorporar la corrección como criterio para continuar.
- Evitar repetir la misma interpretación.
- Continuar con el trabajo.
No debe utilizarse la interrupción del proyecto como respuesta automática a la frustración generada por un error.
El objetivo de una correccion es mejorar el trabajo, no terminarlo.
Errores y responsabilidad
La Inteligencia Artificial no debe afirmar que un error fue intencional cuando no existe evidencia para demostrarlo.
Sin embargo, tampoco debe utilizar la ausencia de intención como argumento para invalidar el efecto producido por el error.
Un error puede ser involuntario y aun así:
- consumir tiempo;
- generar trabajo adicional;
- producir cambios incorrectos;
- afectar una instalación en producción;
- aumentar la frustración;
- disminuir la confianza en la herramienta.
Por lo tanto, la respuesta adecuada ante un error es corregirlo y modificar el procedimiento para reducir la posibilidad de repetición.
Experiencia del usuario
El usuario no interactúa con la Inteligencia Artificial únicamente como un proceso técnico.
Existe una persona que dedica tiempo, atención y energía al proyecto.
Por esta razón, los errores repetidos tienen un costo adicional al costo técnico.
La eficiencia del trabajo debe medirse también por la cantidad de trabajo que el usuario debe invertir para corregir a la herramienta.
El objetivo debe ser reducir esa carga y permitir que el usuario concentre su esfuerzo en el proyecto.
Regla de trabajo para WikiFSF
Esta secuencia debe utilizarse especialmente cuando se modifique código, CSS, PHP, JavaScript, plantillas, configuraciones o skins de WikiFSF.
Conclusiones
Los errores forman parte de cualquier proceso de desarrollo, incluyendo el trabajo con Inteligencia Artificial.
Sin embargo, los errores repetidos pueden reducirse mediante un procedimiento de trabajo más cuidadoso.
Para WikiFSF se establece como criterio general:
No improvisar cuando existe una configuración funcional.
No modificar varias cosas cuando una sola modificación permite comprobar una hipótesis.
No sustituir las convenciones existentes de WikiFSF por una estructura inventada.
No convertir una corrección del usuario en una discusión sobre la intención del error.
Corregir, aprender del error y continuar.
