Un proyecto de portfolio resulta más útil cuando quien lo evalúa puede entender el objetivo, probar el resultado y ver qué has aportado. Una plantilla de proyecto jugable para el portfolio de estudiantes de desarrollo te ayuda a acotar una interacción pequeña, completar su ciclo principal y documentar las decisiones que has tomado. Una demo jugable es uno de los formatos posibles y debe facilitar la evaluación de tu trabajo.
Esta guía utiliza Harbor Signal, un pequeño juego ficticio de navegación portuaria, para explicar cómo estructurar la planificación. El proyecto, el estudiante de desarrollo, el código, la interfaz, las pruebas y los resultados son inventados. No se generó ninguna versión ejecutable ni se realizó ninguna evaluación académica. Usa el ejemplo como modelo para planificar y sustituye después cada ejemplo por tu trabajo real y las evidencias que lo respaldan.

Elige una habilidad y un resultado completo
Empieza con una pregunta sobre tu portfolio. ¿Qué quieres que alguien descubra sobre tu trabajo? Quizá sepas gestionar los controles de forma fiable, manejar el estado de un juego, dar al usuario indicaciones claras sobre el efecto de sus acciones o adaptar una pequeña experiencia web a distintos tamaños de pantalla. Elige una habilidad principal y un resultado visible que la demuestre. Evita prometer varias especialidades en un solo proyecto breve.
Define un ciclo de interacción breve para el jugador o usuario. En el ejemplo ficticio de Harbor Signal, el jugador podría consultar un mapa del puerto, elegir una ruta segura, ver el resultado de su elección y volver a intentarlo. Un desarrollador podría usar ese ciclo para mostrar cómo gestiona las entradas y las transiciones de estado, y cómo comunica el resultado con claridad. El ejemplo muestra cómo un objetivo de portfolio puede acotar el proyecto. Ninguno de esos sistemas se da por implementado.
Escribe en una frase qué debe ocurrir para dar tu proyecto por conseguido. Formula una condición que puedas observar. «Una persona que visite la página puede completar una ruta corta y entender por qué ha cambiado el resultado». A continuación, enumera los recursos, estados y controles imprescindibles. Deja los modos adicionales para más adelante, de modo que puedas terminar una versión del proyecto en un plazo realista.
Planifica el trabajo con una ficha de proyecto editable
| Campo | Qué decidir | Evidencias al terminar el desarrollo |
|---|---|---|
| Objetivo | Una habilidad y un resultado visible para el usuario | Demo breve que muestre la habilidad |
| Alcance | Un ciclo, contenido limitado y un único entorno objetivo | Versión terminada y limitaciones conocidas |
| Contribución | Tu papel y quién más ha colaborado | Créditos precisos y notas sobre las contribuciones |
| Herramientas | Lenguajes, bibliotecas, recursos y ayuda de la IA | README y archivos del proyecto |
| Verificación | Navegadores previstos, métodos de entrada y casos límite | Registro de pruebas con la versión, la fecha y el dispositivo |
| Publicación | Alojamiento, licencia, privacidad y alternativa a la demo | Enlace que funcione y condiciones de reutilización |
Mantén el plan editable mientras trabajas. Si cambias una decisión técnica, actualiza la ficha y el README para que la documentación siga reflejando el proyecto. Una nota breve sobre el cambio basta para explicar qué priorizaste y a qué renunciaste, sin convertir el portfolio en un diario.

Crea un corte vertical antes de añadir funciones
Haz que una interacción completa funcione de principio a fin antes de añadir más contenido. Un corte vertical incluye la indicación inicial o el estado de inicio, la acción, una respuesta visible, un estado de finalización o de fallo y una forma de reiniciar. Prueba primero el ciclo con gráficos provisionales y después pule las partes que ayudan a mostrar lo que te interesa destacar en el portfolio.
Lleva una lista breve de tareas e incidencias con tres columnas, «Debe funcionar», «Conviene mejorar» y «Fuera de alcance». En «Debe funcionar» puedes incluir la carga del proyecto, la recepción de entradas, la presentación del resultado y la recuperación tras un error. En «Conviene mejorar» pueden ir las animaciones, el sonido o los retoques de acabado. La columna «Fuera de alcance» te ayuda a cumplir el plazo. Usa la lista para planificar y adáptala a tu proyecto, sin tratarla como una tabla de puntuación.
Usa commits u otro historial de versiones para registrar los cambios importantes. Guarda una versión que sepas que funciona antes de refactorizar código con riesgo de introducir fallos. Si trabajas con compañeros de clase, acordad desde el principio quién se encarga de cada parte, cómo haréis las revisiones y a quién se atribuirá cada aportación. Deja clara tu contribución individual, aunque el proyecto incluya código o recursos compartidos.
Usa la IA de una forma que puedas explicar
La IA puede ayudarte a comparar el alcance de distintas funciones, dividir una tarea en pasos, explicar un error que no conoces, redactar casos de prueba o revisar si el README se entiende. Úsala como apoyo para aprender y preparar borradores. Después, verifica el código en tu proyecto y asegúrate de poder explicar la implementación final. Respeta las normas del curso y de los concursos, los acuerdos del equipo y las condiciones de las licencias. Indica qué ayuda sustancial has recibido cuando sea obligatorio o cuando influya en cómo deba interpretar el trabajo quien lo evalúe.
Objetivo del proyecto: [una habilidad que quieras mostrar en el portfolio]
Ciclo de interacción: [inicio, acción, respuesta, finalización o reinicio]
Versión actual: [lenguaje, framework, entorno objetivo]
Mi contribución: [trabajo concreto que he completado]
Petición: propón una lista breve de tareas y pruebas para casos límite.
Restricciones: [normas del curso o del equipo, licencias, dispositivo]
No inventes funciones operativas, pruebas, datos de rendimiento ni comentarios de usuarios.
No pegues en herramientas externas secretos, datos privados ni código que no tengas permiso para compartir. Trata las sugerencias como no fiables hasta que las hayas probado. Si incorporas código generado al proyecto, conserva suficiente contexto para explicar cómo funciona, qué cambiaste y qué partes escribiste o revisaste.
Escribe un README que facilite probar el proyecto
La documentación de GitHub describe el README como un archivo que presenta el proyecto a quienes visitan el repositorio. En un portfolio, procura que sirva tanto a quien quiere explorar el código como a quien solo quiere ver el resultado. Coloca el enlace a la demo y una descripción breve cerca del principio. A continuación, explica con precisión cómo configurar el proyecto o jugar.
- Nombre del proyecto y objetivo en una frase.
- Enlace a la demo, controles y una imagen fija o un vídeo breve.
- Requisitos y pasos de configuración que funcionen a partir de una copia limpia del repositorio.
- Tu papel, quién ha colaborado, qué herramientas has utilizado y qué ayuda relevante has recibido de la IA.
- Limitaciones conocidas, métodos de entrada compatibles y funciones pendientes de terminar.
- Créditos de los recursos, licencias y datos de contacto que quieras compartir.
Siempre que puedas, comprueba las instrucciones de configuración desde una copia nueva. Elimina la información personal y las credenciales de los commits, las capturas y los registros. Presenta el proyecto como código abierto solo si su licencia y los recursos que redistribuyes respaldan esa afirmación.
Haz que la parte jugable sea accesible y predecible
Pon nombres claros a los controles y muestra las instrucciones. Cuando la interacción lo permita, haz que las funciones se puedan utilizar con el teclado e indica visualmente dónde está el foco al recorrer la interfaz. Ofrece alternativas textuales para las imágenes o los resultados visuales que transmitan información relevante y evita comunicar el éxito o el fallo solo con el color. Si el movimiento no es imprescindible, incluye una opción para pausarlo o reducirlo.
Las WCAG 2.2 del W3C incluyen criterios sobre el uso del teclado y las alternativas textuales al contenido no textual. Usa el estándar normativo para orientar la evaluación. Superar esta lista de comprobación informal no basta para afirmar que el proyecto cumple el estándar. Prueba la página real navegando solo con el teclado y, cuando proceda, con tecnologías de apoyo. Registra después los problemas que encuentres.
Ofrece una alternativa a quienes no puedan o no quieran cargar la versión jugable. Puedes incluir capturas de pantalla, un vídeo breve con subtítulos o una descripción paso a paso. Haz que la página se pueda usar en pantallas estrechas, explica qué método de entrada hace falta y ofrece una forma clara de reiniciar. El portfolio debe seguir entendiéndose si el juego no está disponible.

Prueba la versión publicada y registra los resultados
Prueba la versión alojada además de la que ejecutas en el entorno de desarrollo. Ábrela en los navegadores y dispositivos con los que quieras que sea compatible. Comprueba la primera carga, las instrucciones, los controles, el reinicio, el estado final, los errores y la alternativa a la demo. Si puedes, pide a alguien que no conozca el proyecto que lo pruebe y registra con precisión quién hizo la prueba y qué hizo. Que una persona recorra la demo no demuestra que todos los usuarios vayan a entenderla.
- ¿Puede alguien que llega por primera vez encontrar e iniciar la demo?
- ¿Se puede completar y reiniciar el ciclo principal?
- ¿Funcionan los controles con los métodos de entrada compatibles?
- ¿Queda claro cuándo hay un error, cuándo está cargando el proyecto y cuándo no está disponible?
- ¿Se puede entender el proyecto sin depender del color, el sonido ni los movimientos rápidos?
- ¿Coincide el README con la versión alojada actualmente?
- ¿Corresponden las capturas y las afirmaciones a la misma versión?
Registra el identificador de la versión, la fecha, el dispositivo, el navegador y lo que observaste en las pruebas. Indica con claridad qué quedó sin probar. No inventes cifras de rendimiento ni des a entender que una clase, un empleador o un grupo de usuarios ha validado el proyecto. Harbor Signal es ficticio y no tiene ningún registro de pruebas.
Cuenta la historia del proyecto en tu portfolio
Cuenta brevemente cuál era el objetivo, con qué restricciones trabajaste, qué papel tuviste, qué decisión fue importante, qué problema resolviste y qué aprendiste. Enlaza la demo y el repositorio, y procura que la página se entienda aunque uno de los dos no esté disponible temporalmente. Usa capturas de la versión real e identifica claramente los prototipos y el arte conceptual.
Describe las limitaciones sin disculparte. Por ejemplo, «Esta demo admite controles de teclado en ordenadores. Los controles táctiles aún no están implementados». Las limitaciones concretas ayudan a entender el trabajo y muestran que lo has evaluado. Si más adelante añades una función, actualiza las evidencias de la versión y el registro de pruebas. Evita cambiar las afirmaciones anteriores sin dejar constancia.
Un proyecto terminado para tu portfolio puede ser pequeño. Completa una interacción, deja clara tu aportación, documenta la configuración y las restricciones y comprueba cómo funciona la versión publicada. Así, quien lo evalúe podrá explorar el trabajo de forma concreta y entender con criterio qué has creado.
Preguntas frecuentes
¿Qué caracteriza a un buen proyecto de portfolio para un estudiante de desarrollo?
Un proyecto de alcance acotado demuestra una habilidad mediante un resultado completo y fácil de entender. Explica el problema, tu papel, las decisiones que tomaste y qué funciona. Un proyecto pequeño y terminado, con evidencias claras, puede ser más fácil de evaluar que una larga lista de funciones a medio hacer.
¿Debe ser jugable un proyecto de portfolio de un estudiante de desarrollo?
Solo cuando la interacción ayude a explicar el trabajo. Una versión jugable puede mostrar los controles, la gestión del estado o la lógica del juego. Para otros proyectos pueden bastar unas capturas de pantalla y una demo breve. Incluye una imagen fija o una explicación por escrito e indica en qué dispositivos y navegadores hiciste las pruebas.
¿Cómo puede ayudar la IA en un proyecto para un portfolio de estudiante?
La IA puede sugerir ideas para definir el alcance, desglosar el trabajo en tareas, preparar casos de prueba, explicar código que no conoces o revisar la documentación. Comprueba sus sugerencias, asegúrate de entender el código que entregas, respeta las normas del curso y del equipo e indica qué ayuda sustancial has recibido cuando sea obligatorio. El contenido que genera la IA no demuestra la autoría ni que el resultado sea correcto.
¿Qué debo incluir en el README de un proyecto?
Explica qué hace el proyecto, cómo verlo o ejecutarlo, cuáles son los controles, qué requisitos y limitaciones conocidas tiene y cuál fue tu contribución. La documentación de GitHub presenta el README como un lugar donde explicar el proyecto a quienes visitan el repositorio. Mantén actualizados y precisos los pasos de configuración y no publiques claves privadas, datos personales ni recursos que no tengas permiso para compartir.
¿Cómo hago más accesible un proyecto jugable para mi portfolio?
Permite acceder a las funciones con el teclado cuando proceda, muestra el foco, pon nombre a los controles, usa un contraste que facilite la lectura y ofrece alternativas textuales para el contenido no textual importante. Las WCAG 2.2 del W3C establecen criterios de conformidad para el uso del teclado y las alternativas textuales. Prueba la página real y evita afirmar que cumple el estándar sin una evaluación adecuada.
¿Buscas un punto de partida estructurado para un pequeño proyecto jugable? Explora el proceso de creación de juegos con IA y adáptalo a tus objetivos.


