Estrategia de Portafolio
Principio Fundamental
Tu GitHub no es un cementerio de proyectos a medio terminar. Es una exhibición curada. Cada repositorio fijado debe responder una pregunta que un reclutador tiene sobre ti, y cada respuesta debe hacer que quieran agendar una entrevista.
Lo que Separa lo Impresionante de lo Mediocre
PORTAFOLIO MEDIOCRE PORTAFOLIO IMPRESIONANTE
───────────────── ────────────────────────
30 repos, la mayoría forks 5 repos, todo trabajo original
Sin READMEs Cada README cuenta una historia
Sin demos en vivo Cada proyecto está desplegado
Tutoriales aleatorios clonados Tema claro y progresión
Último commit: hace 8 meses Actividad consistente y reciente
Sin descripciones en repos Cada repo tiene una línea descriptiva
"mi-primer-react-app" "Herramienta de revisión de código con IA"
La diferencia no es talento. Es curaduría. Los mejores portafolios parecen de alguien con un plan, no de alguien que sube todo lo que toca.
Calidad sobre Cantidad
De tres a cinco proyectos pulidos vencen a treinta repositorios abandonados. Siempre.
Las Matemáticas que Importan
| Repos | READMEs | Desplegados | El Reclutador Piensa |
|---|---|---|---|
| 30 | 2 | 0 | "Empieza cosas, no las termina" |
| 15 | 5 | 1 | "Pica aquí y allá. No sabe en qué es bueno" |
| 5 | 5 | 4 | "Enfocado. Entrega. Sabe su oficio" |
| 3 | 3 | 3 | "Todo lo que toca está pulido" |
La Regla de Limpieza
Antes de agregar algo nuevo, audita lo que ya está:
1. Archiva o haz privado lo que esté incompleto e irrecuperable.
2. Elimina forks que nunca modificaste.
3. Agrega READMEs a todo lo que mantengas público.
4. Pon descripciones en cada repositorio visible.
5. Lo que quede debe valer la pena mostrarlo.
Si no lo pondrías en tu currículum, no debería estar en tu GitHub público.
Cuenta una Historia a Través de tus Repos
Tus repositorios fijados no son muestras al azar. Son capítulos. Organízalos para que un visitante vea una narrativa.
Estructuras de Historia que Funcionan
El Arco del Especialista:
"Profundizo en IA/ML y puedo demostrarlo."
Repo 1: LLM ajustado para tarea de dominio específico
Repo 2: Pipeline RAG con marco de evaluación
Repo 3: Flujo de trabajo agéntico con uso de herramientas
Repo 4: Contribución open-source a LangChain/LlamaIndex
El Arco del Desarrollador Full-Stack:
"Construyo productos completos desde la base de datos hasta el despliegue."
Repo 1: App SaaS full-stack (Next.js + API + BD + Auth)
Repo 2: Herramienta CLI con IA (muestra habilidades de backend/sistemas)
Repo 3: Librería open-source (muestra pensamiento de diseño de API)
Repo 4: Herramienta de automatización personal (muestra que también construyes para ti)
El Arco del Desarrollador Nativo en IA:
"No solo uso IA, construyo con ella y para ella."
Repo 1: Flujo de trabajo agéntico / sistema multi-agente
Repo 2: Integración de LLM en una app de nivel de producción
Repo 3: Herramienta de desarrollo que aprovecha IA (linter, revisor, generador)
Repo 4: Contribución a un framework o cadena de herramientas de IA
Señales de Progresión
Los reclutadores notan cuando tus repositorios muestran crecimiento:
| Señal | Lo que Muestra |
|---|---|
| Repo temprano: app CRUD simple | Empezaste por algún lado |
| Repo intermedio: API con tests y CI | Aprendiste prácticas de ingeniería |
| Repo reciente: agente de IA con evaluaciones | Estás construyendo en la frontera |
| Contribución a proyecto OSS importante | Puedes trabajar en bases de código grandes |
Qué Fijar y Por Qué
Tienes seis repositorios fijados. Úsalos estratégicamente.
La Distribución Ideal de Fijados
| Ranura | Qué Fijar | Por Qué |
|---|---|---|
| 1 | Proyecto full-stack | Demuestra que puedes construir un producto completo |
| 2 | Proyecto de IA/ML | Muestra que trabajas en la frontera |
| 3 | Contribución open-source | Prueba que colaboras en bases de código reales |
| 4 | Herramienta de desarrollo o CLI | Muestra que resuelves tus propios problemas |
| 5 | Proyecto de dominio (tu especialidad) | Señal de profundidad para tu rol objetivo |
| 6 | Comodín — personal o creativo | Muestra personalidad y curiosidad genuina |
Reglas para Fijar
SÍ fijar:
- Proyectos con demos en vivo o enlaces de despliegue
- Repos con READMEs completos y capturas de pantalla
- Trabajo que coincida con los roles a los que postulas
- Tu trabajo más reciente y más pulido
NO fijar:
- Repos forkeados que no modificaste significativamente
- Tutoriales seguidos (aunque estén completos)
- Repos sin README
- Cualquier cosa que no puedas explicar en una entrevista
README como tu Discurso de Portafolio
Cada repositorio fijado necesita un README que venda el proyecto en 30 segundos. Un reclutador dedicará menos tiempo que eso antes de decidir si sigue leyendo.
Estructura de README para Repos de Portafolio
# Nombre del Proyecto
Descripción de una oración sobre qué hace y por qué importa.
## Demo
[Enlace a demo en vivo] | [Enlace a video explicativo]
Captura de pantalla o GIF mostrando la app en acción.
## El Problema
¿Qué problema resuelve? ¿Quién tiene este problema?
## Cómo Funciona
Resumen de la arquitectura. Decisiones técnicas clave.
Diagrama si el sistema tiene múltiples componentes.
## Stack Tecnológico
Lista de tecnologías — pero solo las significativas.
No pongas HTML/CSS. Sí incluye tus integraciones de IA, bases de datos, destinos de despliegue.
## Características Clave
- Característica 1 — por qué es interesante técnicamente
- Característica 2 — qué fue difícil al construirla
- Característica 3 — qué mejorarías después
## Primeros Pasos
Instrucciones claras de configuración. Alguien debería poder ejecutar esto en menos de 5 minutos.
## Lo que Aprendí
Breve reflexión sobre el desafío técnico más difícil y cómo lo resolviste.
Anti-Patrones de README
| Mal README | Mejor README |
|---|---|
| "Una app de React" | "Resumidor de reuniones con IA que convierte grabaciones en acciones" |
| Sin capturas de pantalla | Captura principal o GIF arriba del pliegue |
| Configuración: "clonar y ejecutar" | Configuración: paso a paso con requisitos previos listados |
| Sin explicación de arquitectura | Diagrama del sistema mostrando cómo se conectan los componentes |
| Lista cada paquete npm | Destaca las 3-4 tecnologías que importan |
Demos en Vivo y Enlaces de Despliegue
El código es una hipótesis. Una app desplegada es una prueba.
Por Qué el Despliegue Importa
El reclutador ve un repo sin demo:
"Código interesante... ¿funciona realmente?"
El reclutador ve un repo con enlace en vivo:
"Déjame probarlo." → 2 minutos después → "Esta persona entrega."
Opciones de Despliegue por Tipo de Proyecto
| Tipo de Proyecto | Despliegue Gratuito | Bueno Para |
|---|---|---|
| App web full-stack | Vercel, Railway, Fly.io | Apps con sensación de producción |
| API / backend | Railway, Render | Mostrar habilidades de backend |
| Sitio estático / docs | GitHub Pages, Netlify | Documentación, landing pages |
| Demo de IA/ML | Hugging Face Spaces, Streamlit Cloud | Demos de modelos, apps de datos |
| Herramienta CLI | npm publish, Homebrew tap | Señal de distribución |
Si No Puedes Desplegar, Graba una Demo
No todo se puede ejecutar en la nube. Para herramientas solo locales, apps CLI o sistemas complejos:
1. Graba un video explicativo de 60 a 90 segundos.
2. Súbelo a YouTube (no listado está bien).
3. Crea un GIF de la interacción clave.
4. Pon ambos en el README.
Una demo en video es diez veces mejor que ninguna demo.
Gráfico de Contribuciones
Qué Señala la Consistencia
Los reclutadores echan un vistazo a tu gráfico de contribuciones. Esto es lo que realmente interpretan:
| Patrón | Interpretación |
|---|---|
| Verde constante, la mayoría de los días | "Esta persona programa regularmente. Buen hábito." |
| Agrupado alrededor de proyectos | "Trabaja en sprints enfocados. Normal." |
| Verde solo entre semana | "Tiene trabajo, pero aún así publica trabajo personal." |
| Mezcla de repos propios y contribuciones | "Colaborativo. No solo proyectos en solitario." |
Cómo se Ve el Falseo
Los revisores experimentados detectan esto al instante:
SEÑALES DE ALERTA:
- Verde perfectamente uniforme (todos los días, misma intensidad)
- Commits que son solo ediciones de README o cambios de espacios en blanco
- 500 commits en un día a repos vacíos
- Docenas de repos creados en una semana, todos con un solo commit
- Bots de commits generados automáticamente
Falsear tu gráfico es peor que tener lagunas. Señala desesperación y mal juicio. La consistencia real significa trabajar en cosas que te importan con una cadencia regular — lagunas incluidas.
Construir un Gráfico Real
En lugar de fingir:
1. Elige un proyecto y trabaja en él 30 minutos al día.
2. Contribuye a open source — incluso docs, tests o reportes de bugs cuentan.
3. Mantén un repo de aprendizaje donde subas notas y experimentos.
4. Construye herramientas que realmente uses. Mejorarás naturalmente.
Alinear tu Portafolio con el Rol que Deseas
Tu portafolio debe verse como una vista previa del trabajo que harías si te contrataran. Adáptalo a tu objetivo.
Roles de Desarrollo Nativo en IA
Estos roles quieren ver que puedes construir con IA y construir para IA:
| Señal | Repo de Ejemplo |
|---|---|
| Uso de herramientas de IA en tu flujo de trabajo | Proyecto con configuración .claude/, commits asistidos por IA, comandos slash de Claude Code |
| Flujos de trabajo agénticos | Agente de múltiples pasos que investiga, planifica y ejecuta tareas |
| Integraciones de LLM | App con salida estructurada, ingeniería de prompts, enrutamiento de modelos |
| RAG y recuperación | Base de conocimiento con búsqueda por embeddings y métricas de evaluación |
| Evaluación y pruebas | Marco de evaluación de salidas de LLM, pruebas de regresión de prompts |
| Desarrollo asistido por IA | README del proyecto documentando cómo las herramientas de IA aceleraron el desarrollo |
Objetivos de Portafolio por Rol
| Rol Objetivo | Repos Imprescindibles | Buenos Tener |
|---|---|---|
| Ingeniero de IA/ML | Modelo ajustado, marco de evaluación, pipeline de datos | Implementación de paper, comparación de modelos |
| Desarrollador Full-Stack de IA | App integrada con LLM, sistema RAG, SaaS desplegado | Contribución open-source, herramienta CLI |
| Ingeniero de Plataforma/Infra | Pipeline CI/CD, repo de IaC, configuración de monitoreo | Benchmark de rendimiento, contribución OSS |
| Herramientas de Desarrollo/DX | Herramienta CLI, SDK/librería, extensión de VS Code | Sitio de documentación, herramienta de comunidad de desarrolladores |
Lista de Verificación de Revisión de Portafolio
Realiza esta auditoría antes de cada búsqueda de empleo. Sé honesto.
Primera Impresión (30 segundos)
- La foto de perfil es profesional (o intencionalmente distintiva)
- La biografía indica qué haces y qué buscas
- Los repos fijados tienen descripciones que un extraño entiende
- Al menos 3 repos fijados tienen capturas de pantalla o enlaces de demo en el README
- No hay nombres de repos embarazosos visibles en la primera página
Verificación de Profundidad (2 minutos)
- Cada repo fijado tiene un README que explica el qué, por qué y cómo
- Al menos un proyecto tiene una demo en vivo o enlace de despliegue
- La calidad del código en los repos fijados refleja tu nivel de habilidad actual
- El historial de commits muestra desarrollo real (no un solo "commit inicial" masivo)
- Al menos un repo demuestra pruebas o CI/CD
Verificación de Historia (5 minutos)
- Tus repos fijados cuentan una historia coherente sobre tus habilidades
- Hay una progresión visible de proyectos antiguos a nuevos
- Tu portafolio está alineado con los roles que estás buscando
- Puedes explicar cada repo fijado en un elevator pitch de 60 segundos
- Te contratarías a ti mismo basándote en este GitHub
La Prueba Definitiva
Abre tu GitHub en una ventana de incógnito. Pretende que eres un reclutador que nunca te ha conocido. Dedica 60 segundos. ¿Pasarías a este candidato a la siguiente ronda?
Si la respuesta no es un sí inmediato, sigue iterando.
Anti-Patrones
| Anti-Patrón | Por Qué Duele | Solución |
|---|---|---|
| Repos forkeados sin cambios | Parece relleno | Elimina o hazlos privados |
| Clones de tutoriales ("todo-app", "weather-app") | Señala que seguiste instrucciones, no que sabes construir | Fórcale un fork y extiéndelo mucho más allá del tutorial |
| Repos vacíos o con solo un README | Señala ideas abandonadas | Archívalos o elimínalos |
| Sin READMEs en repos públicos | "No comunico sobre mi trabajo" | Agrega READMEs a todo lo que mantengas público |
| 50+ repos visibles sin curaduría | Ruido abrumador, sin señal | Archiva agresivamente, fija estratégicamente |
| Repos fijados desactualizados (2+ años) | "No han construido nada recientemente" | Rota los fijados para mostrar trabajo reciente |
| README de perfil solo con estadísticas auto-generadas | Impersonal, poco esfuerzo | Escribe una biografía real con tu enfoque y objetivos |
| Repos llamados "test", "temp", "asdf" | Descuidado | Renómbralos o elimínalos |
Jugada Maestra
"Revisa mi portafolio de GitHub en [tu URL de GitHub]. Evalúalo como si fueras un reclutador para un rol de desarrollo nativo en IA. Puntúa cada repo fijado en calidad del README, profundidad técnica, estado de despliegue y relevancia para roles de IA/ML. Luego dame un plan de acción priorizado: qué archivar, qué mejorar, qué falta y qué nuevo proyecto marcaría la mayor diferencia."
El agente se convierte en tu crítico de portafolio, dándote la retroalimentación honesta y específica que necesitas para convertir tu GitHub de un cementerio de código en un activo profesional.
Habilidades Relacionadas
| Habilidad | Cuándo Usarla |
|---|---|
github-profile | Implementar mecánicas de la plataforma GitHub — README de perfil, fijado de repos, temas, gráfico de actividad |
career-resume | Ciclo de vida profesional completo — búsqueda de empleo, entrevistas, onboarding, revisiones de desempeño |