Saltar a contenido

Capítulo 13

Construcción y publicación del PromptBook Profesional

13.0 Objetivo del capítulo

Al finalizar este capítulo habrás construido un PromptBook completamente funcional, organizado y documentado, listo para usar en proyectos reales y para seguir creciendo con el tiempo. 2

Esto va más allá de un ejercicio académico: es el comienzo de una nueva etapa profesional en la que tu PromptBook se convierte en un activo de productividad, aprendizaje y colaboración. 6

Nota
A partir de este capítulo, cada mejora que hagas en tu PromptBook no será “tarea del libro”, sino inversión directa en tu carrera y en tus proyectos.

13.1 El PromptBook ya no es un ejercicio

Durante todo el libro has diseñado plantillas, flujos, sistemas y metodologías de trabajo con IA. Hasta ahora, el PromptBook ha sido el entorno donde practicabas esos conceptos. A partir de aquí, se convierte en una herramienta profesional de uso cotidiano.

Guías sobre gestión del conocimiento personal (PKM) describen sistemas como Zettelkasten, digital gardens o knowledge bases que crecen con el tiempo y capturan aprendizajes, notas y procesos. Tu PromptBook cumple una función similar, pero orientada específicamente a la Ingeniería de Prompts y al trabajo con IA:

  • Es tu biblioteca de prompts organizada por dominios (escritura, investigación, coding, multimedia, productividad).
  • Es tu manual de flujos de trabajo, donde documentas cómo integras IA en proyectos reales.
  • Es tu repositorio de conocimiento reutilizable, versionado con Git y preparado para compartir.
graph TD
  PRACTICA[Practica durante el libro] --> PB[PromptBook Profesional]
  PB --> USO[Uso diario en proyectos]
  USO --> APREND[Aprendizaje continuo]
  APREND --> PB

PromptBook abierto como cuaderno técnico con secciones y notas de mejora

Curiosidad
Muchos profesionales de software y ciencia de datos mantienen “digital gardens” o repositorios personales en GitHub donde documentan patrones, scripts y notas. Tu PromptBook entra en esa familia de herramientas de gestión del conocimiento.

Conviene retenerlo: el PromptBook deja de ser un ejercicio guiado y se convierte en tu sistema de conocimiento práctico para trabajar con IA. Es un proyecto vivo, diseñado para acompañar tu desarrollo profesional, no para terminar con el libro. 26

13.2 Auditoría final

Antes de publicar tu PromptBook, necesitas una auditoría final que revise estructura, categorías, nombres, documentación, ejemplos, plantillas, versiones y organización.

Lista de comprobación de estructura y organización

Estructura sugerida final:

PromptBook/

README.md
LICENSE
CHANGELOG.md
CONTRIBUTING.md
CODE_OF_CONDUCT.md
.gitignore

00-Fundamentos/
01-Frameworks/
02-Principios/
03-Patrones/
04-Escritura/
05-Investigacion/
06-Coding/
07-Multimedia/
08-Plantillas/
09-Flujos/
10-Productividad/
11-Ejemplos/
12-Recursos/

index.md

Checklist de auditoría (para 10-Productividad/MejoraContinua.md):

# Auditoria final del PromptBook

Estructura
- [ ] Todas las carpetas (00–12) existen y tienen contenido relevante.
- [ ] Los nombres de carpetas reflejan claramente su proposito.

Categorias
- [ ] Cada dominio (Escritura, Investigacion, Coding, Multimedia, Productividad) tiene subcarpetas claras.
- [ ] No hay duplicacion de contenido entre carpetas.

Nombres
- [ ] Los archivos usan nombres descriptivos (no "nota1.md", "varios.md").
- [ ] Los nombres siguen una convencion consistente.

Documentacion
- [ ] README.md explica la estructura general del PromptBook.
- [ ] Cada carpeta principal contiene, cuando es necesario, un README interno o notas de uso.

Ejemplos
- [ ] 11-Ejemplos/ incluye casos reales de aplicacion en distintos ambitos.

Plantillas
- [ ] 08-Plantillas/ contiene las plantillas OCRFE mas usadas y mejoradas.

Versiones
- [ ] CHANGELOG.md registra cambios importantes.
- [ ] Existen notas de versiones en 11-Versiones/ o en secciones relevantes.

Organizacion
- [ ] No hay archivos obsoletos sin marcar.
- [ ] Se han eliminado o archivado borradores sin utilidad.

| Elemento revisado | Pregunta clave                                |
|-------------------|-----------------------------------------------|
| Estructura        | ¿Se entiende el mapa completo del proyecto?   |
| Categorias        | ¿Cada tema tiene su lugar natural?            |
| Nombres           | ¿Los nombres ayudan a encontrar rapido?       |
| Documentacion     | ¿Un tercero podria navegar sin tu ayuda?      |
| Plantillas        | ¿Las mejores plantillas estan centralizadas?  |
| Versiones         | ¿Se puede seguir la historia del proyecto?    |
| Ejemplos          | ¿Hay casos reales que muestren aplicacion?    |

Árbol de carpetas del PromptBook con verificación de auditoría

Buenas prácticas
Realiza esta auditoría como si fueras un colaborador externo: abre el repositorio, sigue el README y verifica si puedes encontrar lo que necesitas sin conocer la historia interna del proyecto. 25

La auditoría final garantiza que tu PromptBook esté limpio, coherente y comprensible. Es el paso previo imprescindible antes de declararlo “versión estable” y compartirlo. 2

13.3 Documentación profesional

GitHub y la literatura técnica enfatizan algunos archivos clave para proyectos bien documentados: README.md, LICENSE, CHANGELOG.md, CONTRIBUTING.md y CODE_OF_CONDUCT.md. 2

README.md

Según GitHub, el README suele ser lo primero que ve un visitante y debe explicar qué hace el proyecto, por qué es útil y cómo empezar a usarlo. 3

Tu README para el PromptBook debería incluir:

  • Descripción breve: qué es el PromptBook y para quién está pensado.
  • Estructura de carpetas y cómo navegarla.
  • Cómo usar el PromptBook (por ejemplo, clonarlo, abrirlo en un editor, seguir plantillas).
  • Convenciones de nombres y organización.
  • Cómo contribuir (si lo abres a colaboradores). 3

LICENSE

El archivo LICENSE define bajo qué términos se comparte tu PromptBook: uso personal, uso académico, open source, etc. GitHub y guías como choosealicense.com recomiendan seleccionar una licencia clara (MIT, Apache 2.0, CC BY-SA, etc.).

CHANGELOG.md

El changelog registra cambios entre versiones: nuevas carpetas, plantillas, flujos, correcciones. Debe listar fechas y descripciones breves.

CONTRIBUTING.md

Si decides abrir tu PromptBook a contribuciones (por ejemplo, en la comunidad de Academia El Profe), este archivo explica:

  • Cómo proponer cambios (issues, pull requests).
  • Estándares de estilo y documentación.
  • Cómo reportar problemas o sugerencias. 4

CODE_OF_CONDUCT.md

Define expectativas de comportamiento: respeto, inclusión, uso responsable de IA, etc. Es una pieza clave en proyectos colaborativos. 4

| Archivo            | Proposito                                   |
|--------------------|---------------------------------------------|
| README.md          | Introduccion, uso y estructura del proyecto |
| LICENSE            | Terminos legales de uso y distribucion      |
| CHANGELOG.md       | Historial de cambios y versiones            |
| CONTRIBUTING.md    | Guia para colaboradores                     |
| CODE_OF_CONDUCT.md | Normas de comportamiento y respeto          |

Portada de un repositorio en GitHub con README, LICENSE, CONTRIBUTING y CODE_OF_CONDUCT

Dato relevante
GitHub recomienda explícitamente tener README, LICENSE, CONTRIBUTING y CODE_OF_CONDUCT para gestionar expectativas y colaboración eficaz. Esto convierte tu PromptBook en un proyecto “colaboración-ready”. 25

En síntesis, completar estos archivos transforma tu PromptBook en un proyecto profesional en el sentido GitHub: tiene información clara para usuarios, reglas para colaboradores y protección legal básica. 3

13.4 Publicación

Tu PromptBook está listo para salir al mundo. Veamos cómo publicarlo en GitHub, GitHub Pages, academia.elprofe.org y otras plataformas de documentación.

Publicar en GitHub

Pasos generales (adaptables a tu entorno):

  1. Crear un nuevo repositorio en GitHub con un nombre descriptivo (por ejemplo, promptbook-ingenieria-de-prompts).
  2. Inicializar Git en tu carpeta local PromptBook/ y conectar con el repositorio remoto.
  3. Subir todos los archivos y carpetas (README, LICENSE, etc.).
  4. Configurar topics para mejorar visibilidad (por ejemplo, prompt-engineering, llm, education).

Publicar en GitHub Pages

Puedes usar GitHub Pages para presentar tu PromptBook como sitio estático:

  • Crear un archivo index.md en la raíz (ya previsto en la estructura) como punto de entrada. 3
  • Activar GitHub Pages desde la configuración del repositorio y seleccionar la rama principal.
  • Organizar enlaces desde index.md hacia las secciones clave (Fundamentos, Frameworks, Plantillas, Flujos, Productividad).

Publicación en academia.elprofe.org y otras plataformas

  • Academia El Profe puede enlazar directamente al repositorio o desplegar copias adaptadas para su plataforma educativa.
  • Otras plataformas (por ejemplo wikis internas, sitios de documentación) pueden reutilizar el contenido Markdown para construir sitios de referencia.
graph TD
  LOC[PromptBook local] --> GH[Repositorio GitHub]
  GH --> PAGES[GitHub Pages]
  GH --> AEP[Academia El Profe]
  GH --> OTROS[Otras plataformas]
graph TD
    PB((PromptBook)) --> G[GitHub]
    PB --> P[GitHub Pages]
    PB --> E["Portal educativo<br/>(academia.elprofe.org)"]

Buenas prácticas
Mantén una única “fuente de verdad” (por ejemplo, el repositorio GitHub) y sincroniza copias en otras plataformas a partir de ahí. Evita editar contenidos en múltiples sitios sin coordinación, para no generar divergencias. 26

En el fondo, publicar tu PromptBook en GitHub y plataformas asociadas convierte tu trabajo en recurso accesible y compartible. Define un repositorio como origen y usa GitHub Pages y portales educativos como canales de difusión. 25

13.5 Integración con la vida profesional

El valor real de tu PromptBook se manifiesta cuando lo utilizas en tu día a día: en educación, desarrollo de software, investigación, empresas, comunicación, productividad y emprendimiento.

Educación

  • Usar plantillas de 04-Escritura/ y 05-Investigacion/ para diseñar clases, proyectos, rúbricas y materiales.
  • Documentar flujos de creación de cursos en 09-Flujos/ y 10-Productividad/FlujosTrabajo.md.

Desarrollo de software

  • Reutilizar prompts de 06-Coding/ para arquitectura, refactorización, pruebas y documentación.
  • Mantener casos reales de proyectos en 11-Ejemplos/ para aprender de iteraciones pasadas.

Investigación

  • Aplicar plantillas de 05-Investigacion/ para búsqueda de literatura, síntesis de papers y diseño de estudios.
  • Documentar métodos y prompts en 12-Recursos/ y 11-Ejemplos/.

Empresas y comunicación

  • Usar secciones de escritura y multimedia para informes, presentaciones y campañas internas/externas.
  • Definir procesos de comunicación con IA en 10-Productividad/Procesos.md.

Productividad y emprendimiento

  • Apoyarse en 10-Productividad/ProductividadPersonal.md para organizar días, semanas y proyectos, integrando IA como compañera de trabajo.
  • Documentar experimentos y aprendizajes de emprendimiento con IA en 11-Ejemplos/.
| Ambito           | Uso del PromptBook                           |
|------------------|----------------------------------------------|
| Educacion        | Diseño de cursos y materiales con IA         |
| Desarrollo de software | Arquitectura, codigo y doc asistidos   |
| Investigacion    | Flujos de busqueda y sintesis                |
| Empresas         | Informes, comunicacion, decision-support     |
| Comunicacion     | Campañas, contenidos, branding con IA        |
| Productividad    | Planes de trabajo, checklists y flujos       |
| Emprendimiento   | Documentacion de ideas y experimentos        |

Escenas de aula, oficina, laboratorio y sala de reuniones conectadas por el PromptBook

Consejo
Cada vez que uses la IA para resolver un problema profesional, pregúntate: “¿Este prompt o flujo merece entrar en el PromptBook?”. Si la respuesta es sí, documenta el caso. Así el repositorio crece en paralelo a tu experiencia.

Dicho de otro modo, integrar tu PromptBook en múltiples ámbitos convierte tu aprendizaje en capital profesional. No es solo teoría; es el sistema que sostendrá tu trabajo con IA en educación, software, investigación, empresas y más. 6

13.6 Plan de crecimiento

La Inteligencia Artificial seguirá evolucionando: aparecerán nuevos modelos, herramientas, flujos y buenas prácticas. Tu PromptBook debe crecer con ello.

Incorporar nuevos prompts y categorías

  • Añade nuevas plantillas a 08-Plantillas/ cuando encuentres patrones útiles.
  • Crea subcarpetas adicionales dentro de dominios existentes cuando necesites distinguir áreas (por ejemplo, 06-Coding/Infraestructura/, 07-Multimedia/Logos/).

Integrar nuevas herramientas

  • Documenta en 12-Recursos/ y 10-Productividad/Metodologias.md cómo incorporas nuevas herramientas de IA a tus flujos.
  • Mantén un registro de “experimentaciones con nuevas IAs” en 11-Ejemplos/.

Nuevos flujos de trabajo y versiones

  • Actualiza 09-Flujos/ cada vez que consolides un nuevo proceso repetible.
  • Usa CHANGELOG.md para marcar versiones significativas (por ejemplo, “v2.0 – incorporación de flujos de agentes de IA”). 
graph TD
  V1[PromptBook v1.0] --> NUEVOS[Aprendizajes y nuevas IAs]
  NUEVOS --> FLUJOS[Nuevos flujos]
  FLUJOS --> V2[PromptBook v2.0]
  V2 --> FUTURO[Evoluciones posteriores]
graph LR
    A["v1.0"] --> B["v1.5<br/>(+flujos de multimedia)"]
    B --> C["v2.0<br/>(+agentes de IA,<br/>plantillas de coding optimizadas)"]

Buenas prácticas
Usa la filosofía de “digital garden”: no intentes que todo esté perfecto; deja espacio para notas en borrador, ideas por explorar y áreas en construcción. Lo importante es que el PromptBook esté vivo y en movimiento.

En definitiva, el plan de crecimiento asegura que tu PromptBook no se congele en la versión del libro. Se convierte en un proyecto que evoluciona con tu experiencia, tus herramientas y el ecosistema de IA.

13.7 Checklist final

Para cerrar el proyecto, construimos una checklist final que sintetiza la auditoría y la preparación para publicación.

# Checklist final del PromptBook Profesional

Estructura y archivos basicos
✔ README terminado.
✔ Licencia definida (LICENSE).
✔ CHANGELOG actualizado.
✔ CONTRIBUTING documentado.
✔ CODE_OF_CONDUCT incluido.
✔ .gitignore configurado.

Contenido y organizacion
✔ Categorias principales (00–12) completas.
✔ Plantillas centrales en 08-Plantillas/.
✔ Flujos de trabajo en 09-Flujos/ y 10-Productividad/FlujosTrabajo.md.
✔ Documentacion en cada carpeta clave.

Calidad y ejemplos
✔ Rúbricas y checklists de calidad en Optimizacion/.
✔ Ejemplos reales en 11-Ejemplos/.
✔ Recursos y referencias en 12-Recursos/.

Publicacion
✔ Repositorio GitHub creado.
✔ GitHub Pages configurado (index.md funcionando).
✔ Integracion con academia.elprofe.org planificada.

Crecimiento
✔ Plan de futuras versiones en CHANGELOG.
✔ Estrategia de mejora continua en 10-Productividad/MejoraContinua.md.
✔ Metodologia personal descrita en Productividad/Metodologias.md.

| Aspecto              | Estado ideal                                 |
|----------------------|-----------------------------------------------|
| Arquitectura         | Clara, completa y documentada                 |
| Documentacion        | Archivos clave presentes y actualizados       |
| Plantillas y flujos  | Centralizados y probados en casos reales      |
| Publicacion          | Repositorio accesible y navegable             |
| Mejora continua      | Plan explicito y ritmo de actualizacion       |

| Ítem de la checklist | Estado |
|---|---|
| Estructura | ✔ |
| Plantillas | ✔ |
| Flujos | ✔ |
| Optimización | ✔ |
| Metodología | ✔ |
| Versionado | ◻ en progreso |

Consejo
Considera etiquetar tu PromptBook como v1.0 cuando completes esta checklist. No es “versión final”, sino la primera versión estable de una herramienta que seguirás refinando.

Lo importante es que la checklist final te da una visión compacta del estado del proyecto. Te permite declarar tu PromptBook “listo para uso profesional” y, al mismo tiempo, reconocer que seguirá evolucionando con nuevas versiones. 2

13.8 Cierre del libro

Has llegado al último capítulo, pero no al final del recorrido. A lo largo de la obra has aprendido a:

  • Entender cómo funcionan los modelos de IA y cómo conversar con ellos con intención.
  • Diseñar prompts efectivos usando frameworks como OCRFE.
  • Crear plantillas, sistemas y flujos de trabajo con múltiples asistentes de IA.
  • Diagnosticar y optimizar prompts, evaluando respuestas con criterio profesional.
  • Integrar la IA como compañera de trabajo y construir un PromptBook que refleja tu forma de trabajar.

La Inteligencia Artificial seguirá evolucionando: nuevos modelos, nuevas capacidades, nuevas plataformas aparecerán. 1 Lo que permanecerá como habilidad de enorme valor es tu capacidad para diseñar conversaciones inteligentes: formular objetivos claros, proporcionar contexto relevante, estructurar instrucciones y evaluar resultados con pensamiento crítico.

La filosofía de Academia El Profe se resume en tres ideas:

Aprender construyendo.
Has aprendido sobre Ingeniería de Prompts construyendo un PromptBook real, no quedándote solo en la teoría.

Construir para compartir.
Al publicar tu PromptBook en GitHub y otras plataformas, conviertes tu aprendizaje en recurso para otros profesionales, docentes y estudiantes.

Compartir para transformar.
Cada vez que alguien use tus plantillas, flujos o ejemplos, la forma en que trabaja con IA puede mejorar. Tu PromptBook se convierte en parte de un ecosistema de conocimiento compartido.

Personas de distintas profesiones colaborando a través del PromptBook

Buenas prácticas
Sigue usando tu PromptBook como laboratorio: documenta nuevas ideas, experimenta con herramientas emergentes, registra tus decisiones y comparte lo que funcione. La Ingeniería de Prompts es una disciplina viva, y tu sistema de prompts debe evolucionar con ella.

Conclusión general del libro: la Ingeniería de Prompts consiste en construir sistemas de conversación con IA que te permitan resolver problemas reales, adaptarte a nuevas tecnologías y crear conocimiento de manera sistemática — mucho más que memorizar instrucciones. Tu PromptBook Profesional es la encarnación de esa capacidad: un proyecto organizado, documentado, versionado y publicado que seguirá creciendo junto con la Inteligencia Artificial y con tu experiencia como autor, docente, desarrollador o profesional.

La obra termina aquí, pero tu PromptBook comienza.

Bibliografía

  1. Microsoft Research / arXiv. “Shifting Work Patterns with Generative AI.” Artículo sobre cambios en patrones de trabajo con IA generativa. https://arxiv.org/html/2504.11436v3 ↩

  2. GitHub Docs. “Best practices for repositories.” Guía oficial sobre organización y colaboración en repositorios. https://docs.github.com/en/repositories/creating-and-managing-repositories/best-practices-for-repositories ↩↩↩↩↩↩↩↩↩

  3. GitHub Docs. “About the repository README file.” Recomendaciones sobre contenido y estructura de README. https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readme ↩↩↩↩

  4. Creative Commons Open Source. “GitHub Repo Guidelines.” Checklist para repositorios listos para colaboración. https://opensource.creativecommons.org/contributing-code/github-repo-guidelines/ ↩↩

  5. GitHub Blog. “A checklist and guide to get your repository collaboration-ready.” Artículo sobre preparación de repositorios para colaboración. https://github.blog/enterprise-software/collaboration/a-checklist-and-guide-to-get-your-repository-collaboration-ready/ ↩↩↩

  6. Dev.to / Mochafreddo. “How to Manage Documentation in a GitHub Repository.” Guía sobre gestión de documentación. https://dev.to/mochafreddo/how-to-manage-documentation-in-a-github-repository-a-guide-for-junior-developers-pgo ↩↩↩↩