GUÍA PRÁCTICA
DE PROMPTING

Índice

Videos demostrativos de la guía

La docente agregará los enlaces. Cada video se vincula con una sección y una actividad. El contenido escrito funciona aunque todavía no hayas visto el video.

Cómo usar esta guía

No necesitás ser programador para empezar a desarrollar herramientas digitales con inteligencia artificial. Sí necesitás aprender a explicar qué querés construir, cómo funciona tu negocio, qué reglas debe respetar el sistema y cómo comprobar que el resultado sea correcto.

Esta guía es un cuaderno de trabajo. Te acompaña desde que identificás un problema hasta que planificás, construís, probás y mejorás tu herramienta. Podés usarla en clase y también como referencia cuando trabajes por tu cuenta.

Qué vas a encontrar en cada capítulo

Del problema a la herramienta: las 10 etapas

IDEA organiza cómo pensás tu proyecto. Las diez etapas organizan cuándo hacés cada cosa. No son una secuencia rígida: una prueba puede mostrarte que falta una regla y obligarte a volver al diseño. Eso es normal. Lo importante es que cada cambio relevante quede documentado.

Claude y Codex son asistentes de inteligencia artificial que pueden ayudarte a analizar un problema, ordenar requisitos, escribir código, revisarlo y explicarlo. No adivinan cómo funciona tu negocio ni reemplazan tus decisiones: trabajan con lo que les explicás.

Con un buen método, una persona sin formación técnica puede construir herramientas útiles y acotadas. Estos son algunos ejemplos:

No siempre hay que reemplazarlo todo

Un error habitual es querer construir “un sistema completo” desde el primer día. Muchas veces conviene empezar por una parte del proceso:

• Desarrollar un módulo: agregar un cotizador a la planilla que ya usás, en lugar de reemplazar tu sistema de ventas.
• Conectar herramientas: enviar los datos de tu formulario a tu CRM sin cargarlos a mano.
• Automatizar una tarea: generar el resumen semanal de turnos en vez de armarlo vos.

Empezar chico reduce riesgos, costos y tiempo, y te permite comprobar rápido si la herramienta sirve.

Errores frecuentes

• Elegir un proyecto demasiado grande para empezar.
• Pensar en la tecnología antes que en el problema.
• Copiar una herramienta ajena sin preguntarse si sirve para tu forma de trabajar.

Ficha · Viabilidad y costos

Antes de empezar, conviene saber qué vas a necesitar y qué puede costar. No es para desanimarte: es para elegir una primera versión que puedas sostener. Muchas herramientas se pueden empezar gratis.

CASO REAL · ASÍ LO HICIMOS

Cuatro herramientas reales, hechas sin programar

Con el método de esta guía se construyeron, en 2026, cuatro herramientas que hoy se usan de verdad:

• Mi Capital Conecta: la plataforma de la Municipalidad de la Capital de Catamarca que conecta a vecinos con trabajadores de oficio. La usa gente de afuera, todos los días.
• El directorio de la Red de Articulación Emprendedora: 90 referentes y 46 instituciones para buscar y contactar.
• Un cotizador: arma los presupuestos de ST en pesos y dólares, con el margen interno y el PDF listo para mandar.
• Esta guía: con ingreso con Google, ejercicios que se guardan solos y un certificado verificable.

Ninguna reemplazó un sistema enorme: cada una resolvió un problema concreto. Están contadas en detalle en los capítulos 7, 8 y 11.

La guía que estás usando: la armamos con Claude, aplicando el método IDEA.

Lo que te llevás: Empezá por un problema chico y concreto de tu trabajo, no por “un sistema completo”.

IDEA es una forma de organizar el trabajo. No es un lenguaje de programación ni una función de Claude o Codex: es una lista ordenada de preguntas que te ayuda a no olvidar nada importante antes de pedir que se construya algo.

I · Intención

Definí qué problema querés resolver, para qué y cómo vas a saber que lo lograste. Si la intención no está clara, la IA va a completar los huecos con suposiciones.

D · Diseño

Describí quién va a usar la herramienta, qué va a poder hacer, qué datos necesita y por qué pantallas pasa. No hace falta dibujar con precisión: alcanza con explicar el recorrido.

• Usuarios: quiénes la usan y qué rol tienen (dueña, empleado, cliente).
• Funciones: qué acciones permite (cargar, editar, buscar, exportar).
• Datos: qué información se guarda (nombre, fecha, precio, estado).
• Pantallas y recorrido: por dónde entra cada usuario y qué ve en cada paso.

E · Ejecución

Establecé las reglas que el sistema debe respetar siempre. Acá aparecen las condiciones del negocio, las validaciones (comprobaciones automáticas antes de guardar un dato), los permisos y las conexiones con otras herramientas.

A · Aseguramiento

Definí cómo vas a comprobar que funciona. Los criterios de aceptación son condiciones verificables: si se cumplen, la función está lista; si no, hay que corregir.

Errores frecuentes

• Saltar de la intención a la construcción sin pasar por el diseño.
• Dejar las reglas “en la cabeza” y no escribirlas.
• Dar por buena una función porque “se ve bien”, sin probarla con datos.

CASO REAL · ASÍ LO HICIMOS

El método IDEA aplicado a esta guía

Así quedó definida esta guía con los cuatro componentes:

• Intención: que alumnos sin conocimientos técnicos practiquen con su propio proyecto y que la docente pueda ver su avance. Una guía gratuita, con certificado.
• Diseño: dos tipos de usuario, alumno y docente. Ingreso con Google, ejercicios para completar y un módulo por pantalla, pensado para el celular.
• Ejecución: el avance cuenta solo cuando el alumno marca el módulo como terminado. El certificado se habilita con los 17 módulos. Cada alumno ve solo sus respuestas.
• Aseguramiento: cada cambio se probó en la compu y en el celular, con capturas antes de publicarlo.

Lo que nos costó más idas y vueltas fue lo que faltó en la Intención: al principio no dijimos que la guía era gratis, y el primer video de difusión salió invitando a inscribirse a un curso pago.

Resultado: la portada dice desde el primer momento que es gratis y con certificado.

PROMPT CON EL MÉTODO IDEA · ESTA GUÍACopiar

Intención: Quiero convertir este cuaderno de trabajo en una guía web gratuita para alumnos de mi curso que no tienen conocimientos técnicos. Tiene que servir para practicar con su propio proyecto y para que yo pueda ver su avance.
Diseño: Dos tipos de usuario: alumno y docente. El alumno entra con Google, completa ejercicios que se guardan solos, copia prompts y descarga su certificado. La docente ve el avance de cada alumno y edita los textos sin tocar código. Un módulo por pantalla, pensado primero para el celular.
Ejecución: El avance cuenta solo cuando el alumno marca el módulo como terminado, no por leer. El certificado se habilita con los 17 módulos y tiene un código verificable. Cada alumno ve solo sus respuestas. Colores y tipografías de ST.
Aseguramiento: Antes de publicar, mostrame capturas en compu y celular. Voy a considerar que está bien si un alumno nuevo entiende qué hacer sin explicación y si el avance se mantiene al cambiar de dispositivo.

Lo que te llevás: Escribí la Intención antes que nada: para quién es, qué resuelve y si es gratis o pago. Lo que falta ahí, aparece como error después.

Un prompt es la instrucción que le das a la IA. Cuanto más claro sea, menos tiene que adivinar. No todos los prompts necesitan todos los elementos: para una pregunta puntual alcanza con dos o tres. Para un proyecto que involucra datos, usuarios y reglas, conviene una definición completa.

Plantilla maestra

Copiá esta estructura, reemplazá lo que está entre corchetes y borrá los bloques que no apliquen.

Plantilla rellenable

Errores frecuentes

• Escribir todo en un solo párrafo largo, sin separar elementos.
• Pedir el resultado sin decir en qué formato lo querés.
• Olvidar las restricciones: la IA puede proponer tecnologías con costo mensual.
• No invitar a la IA a preguntar cuando falta información.

La IA conoce mucha información general, pero no sabe cómo cotizás, qué clientes priorizás, qué herramientas usás ni qué excepciones aceptás. Si no se lo explicás, va a usar criterios genéricos que pueden no servirte.

La ficha de contexto es un documento breve que describe tu negocio y tu proyecto. La escribís una vez, la mejorás con el tiempo y la compartís al inicio de cada trabajo importante.

Plantilla · Ficha de contexto

Mantener el contexto vivo

• Actualizala cuando cambie algo importante: una regla nueva, un precio, un usuario. Anotá la fecha y qué cambió.
• Guardala como archivo: un documento de texto que puedas adjuntar o pegar al inicio de cada sesión.
• Usá archivos de instrucciones del proyecto cuando el entorno lo permita. Algunas herramientas leen un archivo con instrucciones permanentes ubicado en la carpeta del proyecto (por ejemplo, Claude Code usa CLAUDE.md y Codex usa AGENTS.md). Otras ofrecen “proyectos” con documentos persistentes. Verificá en la documentación vigente qué admite tu plan y tu entorno.

Errores frecuentes

• Suponer que la IA “ya sabe” porque se lo contaste en otra conversación.
• Escribir el contexto con jerga interna sin explicarla.
• No registrar las decisiones pendientes: la IA las va a resolver por su cuenta.

Un archivo bien elegido vale más que muchas explicaciones. Pero cada material muestra solo una parte de la realidad: una captura de pantalla muestra cómo se ve una pantalla, no qué reglas hay detrás.

Lista de preparación de referencias

Errores frecuentes

• Compartir una planilla completa con datos reales de clientes cuando alcanzaba con diez filas de ejemplo.
• Enviar capturas sin explicar qué hay que mirar.
• Tomar como cierto lo que la IA “dedujo” de una imagen.

CASO REAL · ASÍ LO HICIMOS

El certificado: dos referencias y lo que no se podía adivinar

Para diseñar el certificado se compartieron dos materiales: un PDF con el modelo y una foto de la firma en papel.

• Lo que la IA pudo sacar de las referencias: el diseño, los colores, la ubicación de cada elemento y la firma, a la que se le quitó el fondo.
• Lo que no podía saber: el cargo exacto (“CEO & Founder de ST Relaciones Públicas® SAS”), el lugar (“Argentina”) ni la orientación de la firma. Esos datos hubo que darlos por escrito.

El certificado final, generado con el nombre de cada alumno, la fecha y un código único.

PROMPT CON EL MÉTODO IDEA · EL CERTIFICADOCopiar

Intención: Quiero un certificado de finalización que cada alumno descargue con su nombre y pueda sumar a LinkedIn.
Diseño: Usá como modelo el PDF adjunto (mismo diseño, colores y ubicación de los elementos). Incluí mi firma de la foto adjunta, sin fondo y en horizontal.
Ejecución: Datos fijos: firma “Stella Torres”, cargo “CEO & Founder de ST Relaciones Públicas® SAS”, lugar “Argentina”. Datos de cada alumno: nombre, fecha y un código único verificable.
Aseguramiento: Mostrame un ejemplo con un nombre largo antes de darlo por terminado. Está bien si se parece al modelo y se lee completo en A4.

Lo que te llevás: Compartí referencias, pero escribí aparte lo que no se ve en ellas: nombres, cargos, reglas y excepciones.

No hace falta tener todo claro para empezar. Muchas personas explican mejor hablando que escribiendo. Podés dictar tu idea tal como te sale, con desorden y repeticiones, y pedirle a la IA que la organice.

Según el dispositivo, podés usar el dictado del teclado del celular, el dictado del sistema operativo o el modo de voz de la aplicación, si está disponible en tu plan. El resultado es el mismo: texto que la IA puede procesar.

Preguntas sucesivas

Después del primer ordenamiento, pedile a la IA que te entreviste. Así vas completando lo que falta sin tener que pensarlo todo de antemano.

Errores frecuentes

• Enviar la transcripción sin revisarla.
• Pedir que construya directamente a partir de un audio desordenado.
• Responder “lo que te parezca” a preguntas sobre reglas del negocio.

Claude y Codex pueden ayudarte a analizar requisitos, leer archivos, planificar cambios, escribir código y revisarlo. Lo que pueden hacer en concreto depende del producto, el plan y el entorno: no es lo mismo una conversación en el navegador que un asistente con acceso a la carpeta de tu proyecto o a una terminal.

El ciclo de trabajo por etapas

Pedir “hacé todo” suele producir resultados difíciles de revisar. Trabajar por etapas te permite controlar cada paso y detectar errores a tiempo.

El paso 3 es tuyo: nada se construye hasta que vos apruebes el plan.

Errores frecuentes

• Saltear la aprobación y dejar que implemente todo de una vez.
• Aceptar que “ya está probado” sin ver qué pruebas se hicieron.
• No pedir la lista de archivos modificados.

CASO REAL · ASÍ LO HICIMOS

Cómo pasamos de una página larga a un curso

1. Analizar: “¿Se puede armar la guía como un LMS? La veo larga y compleja para el usuario.”
2. Planificar: la IA propuso un inicio “Mi curso” con el avance, un módulo por pantalla y botones de anterior y siguiente, sin tocar lo que ya funcionaba.
3. Aprobar: la respuesta fue “Dale”. Nada se construyó antes de ese paso.
4. Implementar y probar: se armó y se probó en compu y celular.
5. Revisar: llegaron capturas antes de publicar. Con ellas se decidió achicar la portada, porque tapaba el inicio del curso.

El resultado: un módulo por pantalla, con el menú de módulos al costado.

PROMPT CON EL MÉTODO IDEA · LA VISTA DE CURSOCopiar

Intención: La guía hoy es una página larga y se siente compleja. Quiero que se sienta como un curso online, para que el alumno sepa dónde está y qué le falta.
Diseño: Proponé un inicio “Mi curso” con el avance y una tarjeta por módulo, y un módulo por pantalla con anterior y siguiente. En el celular, menú desplegable.
Ejecución: No modifiques las respuestas guardadas, el certificado, el modo edición ni el PDF. No implementes nada hasta que apruebe la propuesta.
Aseguramiento: Después de implementarlo, mostrame capturas en compu y celular antes de publicar.

Lo que te llevás: No dejes que la IA construya antes de que apruebes el plan. Y pedí capturas antes de publicar.

Los cuatro casos son didácticos: los datos y las reglas son ejemplos. Cada caso sigue la misma estructura para que puedas compararlos y elegir el más cercano a tu proyecto.

Sistema de costos y cotizador

Errores frecuentes: confundir margen sobre costo con margen sobre precio; redondear en pasos intermedios; dejar que la IA “estime” impuestos; no guardar la versión de precios de cada presupuesto.

Agenda de turnos a medida

Errores frecuentes: validar disponibilidad solo en la pantalla; olvidar el tiempo de preparación; no contemplar feriados; prometer avisos por mensajería sin revisar costos y requisitos del proveedor.

CRM adaptado a un negocio

Errores frecuentes: copiar las etapas de un CRM genérico; ocultar botones sin bloquear permisos en el servidor; guardar datos personales “por las dudas”; no definir qué pasa con clientes duplicados ya existentes.

Directorio digital

Errores frecuentes: ocultar datos privados con diseño pero enviarlos igual al navegador; no definir si los filtros suman o restringen; publicar datos sin consentimiento; no prever qué hacer con fichas abandonadas.

CASO REAL · ASÍ LO HICIMOS

Mi Capital Conecta: una plataforma pública

Problema: en San Fernando del Valle de Catamarca, conseguir un electricista, un gasista o un plomero era buscar en 20 grupos distintos, contratar sin referencias y no tener idea del presupuesto. Y los trabajadores de oficio no tenían dónde mostrarse.

Lo que se construyó con IA, sin programar: la plataforma de la Municipalidad de la Capital que conecta a vecinos, comercios y PyMEs con trabajadores de oficio. Tiene dos caminos (“soy vecino/a” y “soy trabajador/a”), un formulario por pasos que empieza eligiendo el rubro, preguntas frecuentes y consultas por WhatsApp.

El criterio lo puso quien conoce el municipio: los pedidos se gestionan a través del portal oficial de la Municipalidad, para proteger los datos de los vecinos, y cada trabajador se verifica con su documentación. Son reglas del negocio, no decisiones técnicas.

La difusión: “Comentá MCC y te enviamos el acceso”, la misma mecánica que usamos después para esta guía. Un método que funciona se reutiliza.

La página de inicio, con los dos caminos: vecino o trabajador.

El recorrido en tres pasos: pedí presupuesto, recibí varios y contratá.

El pedido de presupuesto: se elige el rubro y el pedido sigue por el portal oficial.

PROMPT CON EL MÉTODO IDEA · MI CAPITAL CONECTACopiar

Intención: Quiero una plataforma municipal gratuita que conecte a vecinos, comercios y PyMEs con trabajadores de oficio de la Capital, para que nadie tenga que buscar en 20 grupos ni contratar sin referencias.
Diseño: Dos caminos: “soy vecino/a” (pido presupuesto) y “soy trabajador/a” (me sumo). Formulario por pasos que empieza eligiendo el rubro. Preguntas frecuentes y contacto por WhatsApp.
Ejecución: Los pedidos se gestionan por el portal oficial de la Municipalidad para proteger los datos de los vecinos. Cada trabajador se verifica con su documentación. Sin comisiones.
Aseguramiento: Mostrame la página en el celular. Está bien si alguien que nunca la usó pide un presupuesto en menos de 2 minutos.

Lo que te llevás: si tu herramienta la usa gente de afuera, pensá desde el principio cómo vas a cuidar sus datos y cómo vas a verificar a quienes ofrecen algo.

La primera respuesta casi nunca es la definitiva. Iterar es parte del trabajo, no una señal de que lo hiciste mal. Lo importante es que cada corrección te acerque al objetivo y no genere errores nuevos.

1. Compará el resultado con el objetivo y los criterios de aceptación.
2. Identificá la diferencia concreta: qué esperabas y qué obtuviste.
3. Determiná la causa: ¿faltó contexto, una regla o una instrucción clara?
4. Pedí un cambio específico, con un ejemplo si es posible.
5. Protegé lo que funciona: indicá qué no se debe modificar.
6. Volvé a probar con los mismos casos que fallaron, y con los que ya funcionaban.
7. Documentá la versión validada en tu laboratorio de prompts.

Ejemplo comparativo

Errores frecuentes

• Responder “no funciona, arreglalo” sin explicar qué esperabas.
• Pedir varias correcciones distintas en el mismo mensaje.
• Probar solo lo que se corrigió y no lo que ya funcionaba.
• No guardar la versión del prompt que finalmente dio resultado.

CASO REAL · ASÍ LO HICIMOS

El video que salió mal

Primera instrucción: “Hacé un video para historias con motion graphics.” Resultado: un video prolijo que cerraba con “Inscripciones abiertas”, como si la guía fuera paga.

Diagnóstico: faltó contexto. Nunca se había dicho que la guía era gratis.

Iteración 1: “Recordá que es una guía gratuita, con certificado.” Iteración 2: “No pongas ‘tocá el link’, sino ‘comentá GUÍA y te mandamos el acceso’.” En esa vuelta la IA señaló algo que nadie había visto: en las historias no hay comentarios. Se hicieron dos versiones.

Antes: invitaba a inscribirse.

Después: gratis y “Comentá GUÍA”.

PROMPT CON EL MÉTODO IDEA · CORREGIR EL VIDEOCopiar

Intención: El video tiene que atraer gente a una guía gratuita.
Diseño: Esperaba: un cierre con “Gratis · Con certificado”. Obtuve: “Inscripciones abiertas”, que hace pensar que es pago.
Ejecución: Corregí solamente el cierre: “100% gratis · A tu ritmo · Con certificado” y “Comentá GUÍA y te mandamos el acceso”. No cambies las demás escenas ni el estilo.
Aseguramiento: Mostrame el cierre nuevo antes de exportar el video.

Lo que te llevás: Antes de corregir, preguntate qué faltó: contexto, una regla o una instrucción. La corrección es darle eso.

Los tokens son los fragmentos en que la IA divide el texto para procesarlo: pueden ser palabras completas, partes de palabras o signos. Todo cuenta: lo que escribís, los archivos que compartís, el historial de la conversación y lo que la IA responde. Según el plan, los tokens se relacionan con límites de uso o con costos.

Optimizar no es escribir prompts cortos. Un prompt largo y claro puede ahorrar cinco correcciones. Lo que se busca es evitar ambigüedades, información irrelevante, repeticiones y errores que se podían prever.

El archivo de contexto del proyecto

La ficha de contexto del capítulo 4 describe tu negocio. Cuando el proyecto avanza, conviene sumarle el estado del proyecto: qué ya está hecho, qué decisiones se tomaron, qué reglas se acordaron y qué no se debe tocar. Así no tenés que volver a explicarlo en cada conversación.

Guardalo como un documento aparte y actualizalo al terminar cada etapa. Según la herramienta, se puede cargar solo: en un proyecto de Claude va en las instrucciones o en los archivos del proyecto; Claude Code lee un archivo CLAUDE.md y Codex lee AGENTS.md. Si tu herramienta no tiene nada de eso, pegalo al inicio de la conversación.

Qué compartir y qué no

Más archivos no es más contexto: es más texto para procesar y más chances de que la IA toque algo que no tenía que tocar. Compartí lo que hace falta para esta tarea.

Un pedido, un problema

El hábito “una tarea concreta por etapa” también vale para corregir. Compará:

El primero invita a la IA a revisar y rehacer todo. El segundo marca dónde mirar, qué proteger y en qué orden responder.

Propuesta, ejecución y verificación

Probá siempre tres tipos de casos: normales (el uso habitual), errores (datos incorrectos o faltantes) y límites (el último cupo, el último minuto del día, el valor máximo). Usá datos de prueba, nunca datos reales de clientes.

Lista de control antes de publicar

Errores frecuentes

• Probar con datos reales de clientes.
• Pegar una clave de acceso en el chat para “que lo configure”.
• Publicar sin saber cuánto va a costar mantener la herramienta funcionando.
• Dar por verificada una prueba que solo fue propuesta.

CASO REAL · ASÍ LO HICIMOS

Una letra mayúscula que frenó la publicación

Al mudar esta guía a otro servidor, la publicación falló. En lugar de probar cosas al azar, se leyó el registro de errores. Decía:

Error: Output directory “Site” not found.

La carpeta se llama “site”, en minúscula. Un carácter. Se corrigió y se publicó, pero eso era solo una prueba ejecutada. Para tener un resultado verificado faltaba comprobar que el ingreso con Google funcionara, que las respuestas se guardaran y que el certificado se pudiera verificar.

La verificación pública: cualquiera confirma con el código que un certificado es real.

PROMPT CON EL MÉTODO IDEA · DIAGNOSTICAR UN ERRORCopiar

Intención: Quiero publicar la guía en Cloudflare Pages y la publicación falla.
Diseño: Te pego el registro de errores completo: [pegar el log].
Ejecución: Explicame en lenguaje simple qué dice el error y cuál es la causa más probable. No cambies nada todavía.
Aseguramiento: Después de corregirlo, decime qué tengo que revisar en el sitio publicado para confirmar que funciona: el ingreso con Google, que se guarden las respuestas y el certificado.

Lo que te llevás: Cuando algo falle, leé el mensaje de error antes de probar cosas al azar. Y no des por terminado algo que no verificaste vos.

CASO REAL · ASÍ LO HICIMOS

El directorio de la RAE: funcionar no es lo mismo que ser seguro

Para la Red de Articulación Emprendedora (RAE) se construyó un directorio digital con 90 referentes y 46 instituciones. Tiene buscador por persona, institución, localidad o sector, filtros, un perfil para cada integrante y contacto directo por WhatsApp.

Un directorio así guarda datos de personas reales: nombres, cargos y contactos. Por eso no alcanza con que funcione. Hay que definir quién puede ver y quién puede editar cada dato, y eso no se nota mirando la página: se ve igual con reglas o sin ellas.

Los servicios donde se guardan los datos avisan cuando algo queda abierto. Supabase, por ejemplo, manda un aviso si una tabla está pública, sin reglas de acceso (las llama RLS): cualquiera con la dirección podría leer, cambiar o borrar los datos. Esos avisos hay que leerlos y resolverlos antes de difundir la herramienta. La regla habitual: todos pueden ver el directorio, pero cada persona solo edita su propio perfil.

El inicio del directorio, con el buscador y los filtros.

Maqueta de las fichas con datos de ejemplo. Mostrar una herramienta también exige cuidar los datos de quienes están adentro, por eso acá no aparecen las personas reales de la Red.

PROMPT CON EL MÉTODO IDEA · REVISIÓN DE SEGURIDADCopiar

Intención: Antes de difundir el directorio, quiero asegurarme de que los datos de las personas de la Red estén protegidos.
Diseño: Revisá la base de datos: qué tablas hay, qué datos personales guardan y quién puede leer, crear, editar o borrar cada una.
Ejecución: La regla que quiero: todos pueden ver el directorio, pero cada persona solo puede editar su propio perfil. Nadie puede borrar datos de otros.
Aseguramiento: Para cada tabla indicá: estado (protegida / con problemas / no verificable), evidencia y qué hacer. Si encontrás algo abierto, avisame antes de cambiarlo.

Lo que te llevás: si tu herramienta guarda datos de personas, pedí una revisión de seguridad antes de publicarla y leé los avisos de los servicios que usás. Que funcione no significa que sea seguro.

Estas fichas reúnen todo lo que trabajaste en la guía. Completalas en orden la primera vez y volvé a ellas cada vez que el proyecto cambie. Si trabajás en digital, podés pegar textos directamente en cada espacio o copiar la estructura a tu propio documento.

1 · Ficha de idea

2 · Ficha de contexto

Usá la plantilla del capítulo 4. Registrá acá las versiones para saber cuál es la vigente.

3 · Inventario de herramientas actuales

4 · Inventario de archivos y referencias

5 · Mapa del proceso actual

Describí cada paso como ocurre hoy. Marcá dónde se pierde tiempo o aparecen errores.

6 · Lista de requisitos

7 · Reglas de negocio

8 · Decisiones pendientes

9 · Plan de desarrollo

10 · Registro de prompts

Índice rápido de tus prompts. El detalle de cada uno va en el Laboratorio personal de prompts.

11 · Registro de iteraciones

12 · Checklist de pruebas

13 · Registro de errores

14 · Lista de mejoras futuras

15 · Evaluación final del proyecto

Esta ficha es tu entrega: lo que cualquier persona necesita saber para entender qué construiste, qué está probado y qué falta. Escribí solo lo que puedas respaldar con una prueba de la ficha 12.

Checklist general del proyecto

Reutilizable para cada proyecto. Marcá cada ítem y registrá el estado de la etapa: pendiente, en curso o completa.

Laboratorio personal de prompts

Una ficha por prompt importante. El objetivo no es acumular prompts, sino entender qué funcionó, por qué, y qué aprendiste para el próximo proyecto. Imprimí o duplicá esta ficha las veces que necesites.

En el capítulo 3 usamos un ejemplo: talleres con 12 lugares, alumnas que se inscriben y una administradora que ve las listas. Acá lo recorremos completo, en 12 etapas. Cada etapa produce algo que se usa en la siguiente: el prompt te dice qué pegar.

Es un recorrido de ejemplo, no una herramienta terminada. Lo que obtengas depende de lo que te devuelva la IA y, sobre todo, de las pruebas que hagas vos. Podés seguirlo con este caso o cambiarlo por tu proyecto.

Las 12 etapas

1. Identificar el problema
2. Definir quién la usa
3. Requisitos y restricciones
4. Alcance y versión mínima
5. Diseño de la experiencia
6. Tecnologías y servicios
7. Construcción por etapas
8. Pruebas funcionales
9. Corrección de errores
10. Seguridad y datos personales
11. Publicación, si corresponde
12. Mantenimiento y mejoras

Trabarse es parte del proceso. Lo que hace la diferencia es cómo pedís ayuda: con datos concretos, la IA encuentra la causa; con “no anda”, adivina y suele romper otra cosa.

Buscá tu problema

1. La IA no entiende mi idea
2. La respuesta es demasiado extensa
3. La IA cambia cosas que ya funcionaban
4. Aparecen errores después de una modificación
5. Los datos no se guardan
6. Falla el inicio de sesión
7. No funciona una integración
8. Funciona en mi computadora, pero no publicada
9. No sé interpretar un mensaje de error
10. Llegué al límite de uso
11. No tengo acceso a una función que necesito

Tenés algo que funciona, pero sabés que puede estar mejor. La tentación es pedir “mejoralo” o, peor, empezar de cero. Las dos cosas suelen terminar igual: se pierde lo que andaba bien. Este laboratorio propone otro camino: primero un diagnóstico, después mejoras de a una.

Paso 1 · Auditoría: solo diagnóstico

Pedile a Claude o a Codex que revise el proyecto y te devuelva una lista de hallazgos. En esta primera vuelta no se modifica ningún archivo. Que revise:

• Funciones que ya andan
• Errores comprobados
• Funciones incompletas
• Experiencia de uso
• Accesibilidad
• Seguridad
• Rendimiento
• Orden y mantenimiento del código
• Calidad de las pruebas
• Oportunidades de mejora

Paso 2 · Skills: ayuda especializada

Un skill es un paquete de instrucciones, procedimientos, ejemplos y recursos que orienta a la IA para hacer un trabajo determinado. Es como darle el manual de un especialista: en lugar de explicarle cada vez cómo se revisa la accesibilidad, el skill ya trae el procedimiento.

Pueden servir, por ejemplo, para:

• Revisión de código
• Diseño de experiencia e interfaz (UX/UI)
• Accesibilidad
• Seguridad
• Rendimiento
• Pruebas automatizadas
• Documentación
• Reorganización del código sin cambiar lo que hace (refactorización)

No todas las herramientas admiten skills, y en las que sí, no todos están instalados. Si tu entorno los admite, seguí este orden:

1. Identificá los skills realmente disponibles.
2. Revisá sus instrucciones.
3. Elegí los que sirven para tu problema.
4. Que la IA explique por qué conviene usarlos.
5. Verificá el resultado con tus propias pruebas.

Paso 3 · Mejoras de a una

Con el diagnóstico aprobado, la IA tiene que seguir este recorrido para cada mejora:

1. Elegir una sola mejora prioritaria.
2. Identificar los archivos involucrados.
3. Explicar el cambio propuesto.
4. Revisar dependencias y riesgos.
5. Hacer un cambio acotado.
6. Ejecutar las pruebas que correspondan.
7. Comprobar que lo que ya andaba sigue andando.
8. Documentar el resultado.
9. Pasar a la siguiente mejora solo cuando esta quedó cerrada.

Nada de reescrituras masivas ni cambios de diseño “porque queda más lindo”. Si una mejora pide cambiar mucho, partila en pasos.

Construir la herramienta es la mitad del camino. La otra mitad es que la gente pueda usarla: que tenga una dirección, que guarde los datos en un lugar seguro y que cada persona ingrese con su cuenta. Acá no hace falta saber de tecnología: alcanza con entender qué hace cada pieza y seguir las recetas.

El mapa: tu herramienta es un local

Pensalo como abrir un local. Cada pieza tiene su equivalente:

Quién es quién

Revisado en octubre de 2026. Los planes y sus condiciones cambian seguido: verificalos siempre en la página oficial de cada servicio antes de decidir.

Las recetas

1. Guardar tu proyecto en GitHub
2. Publicarlo en Cloudflare
3. Conectar tu dominio
4. Ingresar con Google (Firebase)
5. Una base de datos segura en Supabase

RECETA 2

Publicarlo en Cloudflare

QUÉ NECESITÁS

• Una cuenta en Cloudflare (gratis)
• Tu proyecto en GitHub
• Saber en qué carpeta está el sitio

PASO A PASO

1. Entrá a dash.cloudflare.com, buscá Workers & Pages y tocá Create.
2. Para un sitio como esta guía, tocá Continue to Pages, al pie. Conectá GitHub y elegí tu repositorio.
3. Completá la configuración. Framework preset: None, si es HTML. Build command: vacío. Build output directory: la carpeta donde está el archivo index.html. Las mayúsculas cuentan.
4. Tocá Save and Deploy. Si aparece Build failed, abrí el registro: ahí dice qué pasó.
5. Cuando termina, tu sitio queda en una dirección terminada en .pages.dev. Desde ahí, cada cambio que guardes en GitHub se publica solo.

Deslizá para ver todos los pasos →

Si tu proyecto es una aplicación (por ejemplo, hecha con Next.js), la configuración cambia. Pedile a la IA la configuración exacta para tu caso.

Salió bien si abrís la dirección .pages.dev en una ventana de incógnito y ves tu sitio.

Si falla: mirá el registro de la publicación y usá el caso 8 del Anexo E.

RECETA 3

Conectar tu dominio

QUÉ NECESITÁS

• Un dominio propio, por ejemplo tunegocio.com.ar
• Acceso al panel donde se administra su DNS (Hostinger, NIC Argentina u otro)
• Tu proyecto publicado

PASO A PASO

1. En tu proyecto de Cloudflare, entrá a Custom domains y escribí la dirección que querés usar. Puede ser el dominio o un subdominio, como guia.tunegocio.com.ar.
2. Si el DNS de tu dominio está en otro proveedor, elegí My DNS provider.
3. Cloudflare te da dos datos: Name (por ejemplo, guia) y Target (tu dirección .pages.dev).
4. En el panel de tu proveedor, entrá a DNS y agregá un registro tipo CNAME con esos dos datos.
5. Volvé a Cloudflare y tocá Check DNS records. El cambio puede tardar hasta 24 horas en verse en todos lados.

Deslizá para ver todos los pasos →

Nos pasó: el panel de dominios de Hostinger aparecía vacío, porque los .com.ar se registran en NIC Argentina. El registro lo terminamos creando con el asistente de Hostinger.

Salió bien si escribís tu dirección en el navegador y aparece tu sitio, con el candado de conexión segura.

Si falla: revisá que el nombre y el destino estén copiados exactos, sin espacios, y esperá unas horas antes de volver a probar.

RECETA 4

Ingresar con Google (Firebase)

QUÉ NECESITÁS

• Un proyecto en console.firebase.google.com (gratis)
• Tu dominio o tu dirección .pages.dev

PASO A PASO

1. Creá un proyecto en Firebase y registrá una app web. Firebase te da una configuración que se le pasa a la IA para conectar tu sitio. No es secreta: lo que protege los datos son las reglas del paso 5.
2. Entrá a Authentication, después a Sign-in method, y activá Google.
3. En Authentication, Configuración, Dominios autorizados: agregá tu dominio y tu dirección .pages.dev. Sin este paso, el ingreso no funciona en el sitio publicado.
4. Pedile a la IA que conecte el botón “Ingresar con Google” usando esa configuración.
5. Pedile también las reglas de seguridad de la base de datos, para que cada persona vea solo lo suyo. Revisalas y pegalas en Firestore, en la pestaña Reglas.

Salió bien si ingresás con Google desde tu sitio publicado, en una ventana de incógnito, y en otra cuenta no ves los datos de la primera.

Si falla: si aparece un error de “dominio no autorizado”, faltó el paso 3. Si entrás desde Instagram o WhatsApp, abrí el enlace en Chrome o Safari.

Glosario básico

Pensar antes de pedir. Documentar antes de construir. Validar antes de publicar.

Relaciones Públicas