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 agendarte una entrevista.
Lo Que Separa lo Impresionante de lo Mediocre
PORTAFOLIO MEDIOCRE PORTAFOLIO IMPRESIONANTE
───────────────── ────────────────────
30 repositorios, en su mayoría forks 5 repositorios, todo trabajo original
Sin READMEs Cada README cuenta una historia
Sin demos en vivo Cada proyecto está desplegado
Tutoriales aleatorios clonados Tema y progresión claros
Último commit: hace 8 meses Actividad consistente y reciente
Sin descripciones en los repos Cada repositorio tiene un resumen
"mi-primer-react-app" "Herramienta de revisión de código impulsada por IA"
La diferencia no es el talento. Es la curaduría. Los mejores portafolios parecen hechos por alguien con un plan, no por alguien que hace commit de todo lo que toca.
Calidad Sobre Cantidad
De tres a cinco proyectos pulidos superan a treinta repositorios abandonados. Siempre.
Las Matemáticas Que Importan
| Repos | README | Desplegados | El Reclutador Piensa |
|---|---|---|---|
| 30 | 2 | 0 | "Empieza cosas, no las termina" |
| 15 | 5 | 1 | "Experimenta. No está claro en qué es bueno" |
| 5 | 5 | 4 | "Enfocado. Entrega. Conoce su oficio" |
| 3 | 3 | 3 | "Todo lo que toca está pulido" |
La Regla de Limpieza
Antes de agregar algo nuevo, audita lo que ya tienes:
1. Archiva o haz privado cualquier cosa inacabada e irrecuperable.
2. Elimina los forks de repositorios que nunca modificaste.
3. Agrega README a todo lo que mantengas público.
4. Establece 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 aleatorias. 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 probarlo."
Repositorio 1: LLM ajustado para una tarea específica del dominio
Repositorio 2: Pipeline RAG con marco de evaluación
Repositorio 3: Flujo de trabajo agéntico con uso de herramientas
Repositorio 4: Contribución open-source a LangChain/LlamaIndex
El Arco del Constructor Full-Stack:
"Construyo productos completos desde la base de datos hasta el despliegue."
Repositorio 1: App SaaS full-stack (Next.js + API + DB + Auth)
Repositorio 2: Herramienta CLI impulsada por IA (muestra habilidades de backend/sistemas)
Repositorio 3: Librería open-source (muestra pensamiento de diseño de API)
Repositorio 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."
Repositorio 1: Flujo de trabajo agéntico / sistema multi-agente
Repositorio 2: Integración de LLM en una app de nivel de producción
Repositorio 3: Herramienta para desarrolladores que aprovecha la IA (linter, revisor, generador)
Repositorio 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 |
|---|---|
| Repositorio temprano: app CRUD simple | Empezaste en algún lugar |
| Repositorio intermedio: API con tests y CI | Aprendiste prácticas de ingeniería |
| Repositorio reciente: agente de IA con evaluaciones | Estás construyendo en la frontera |
| Contribución a un 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
| Espacio | Qué Fijar | Por Qué |
|---|---|---|
| 1 | Proyecto full-stack | Prueba 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 para desarrolladores 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 de Fijación
SÍ fijar:
- Proyectos con demos en vivo o enlaces de despliegue
- Repositorios con README exhaustivos y capturas de pantalla
- Trabajo que coincida con los roles a los que estás postulando
- Tu trabajo más reciente y más pulido
NO fijar:
- Repositorios fork que no modificaste significativamente
- Seguir tutoriales (incluso si los completaste)
- Repositorios sin README
- Cualquier cosa que no puedas explicar en una entrevista
README Como tu Presentación de Portafolio
Cada repositorio fijado necesita un README que venda el proyecto en 30 segundos. Un reclutador gastará menos tiempo que eso antes de decidir si seguir leyendo.
Estructura del README para Repositorios 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 demostrativo]
Captura de pantalla o GIF mostrando la aplicación en acción.
## El Problema
¿Qué problema resuelve esto? ¿Quién tiene este problema?
## Cómo Funciona
Visión general 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 enumeres HTML/CSS. Hazlo con tus integraciones de IA, bases de datos, objetivos 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 a continuación
## 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 del README
| Mal README | Mejor README |
|---|---|
| "Una app de React" | "Resumidor de reuniones impulsado por IA que convierte grabaciones en elementos de acción" |
| Sin capturas de pantalla | Captura de pantalla principal o GIF arriba del pliegue |
| Configuración: "clonar y ejecutar" | Configuración: paso a paso con requisitos previos listados |
| Sin explicación de la arquitectura | Diagrama del sistema que muestra cómo se conectan los componentes |
| Enumera todos los paquetes npm | Destaca las 3-4 tecnologías que importan |
Demos en Vivo y Enlaces de Despliegue
El código es una hipótesis. Una aplicación desplegada es una prueba.
Por Qué el Despliegue Importa
Reclutador ve repositorio sin demo:
"Código interesante... ¿realmente funciona?"
Reclutador ve repositorio 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, páginas de aterrizaje |
| Demo de IA/ML | Hugging Face Spaces, Streamlit Cloud | Demos de modelos, aplicaciones de datos |
| Herramienta CLI | npm publish, Homebrew tap | Señal de distribución |
Si No Puedes Desplegar, Graba un Demo
No todo se puede ejecutar en la nube. Para herramientas solo locales, apps CLI o sistemas complejos:
1. Graba un video demostrativo de 60-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.
Un video demo es diez veces mejor que ningún demo.
Gráfico de Contribuciones
Lo Que la Consistencia Señala
Los reclutadores echan un vistazo a tu gráfico de contribuciones. Esto es lo que realmente leen:
| Patrón | Interpretación |
|---|---|
| Verde constante, la mayoría de los días | "Esta persona programa regularmente. Buen hábito." |
| Agrupaciones alrededor de proyectos | "Trabaja en sprints enfocados. Normal." |
| Verde solo entre semana | "Tiene trabajo, aún así entrega trabajo personal." |
| Mezcla de repositorios propios y contribuciones | "Colaborativo. No solo proyectos en solitario." |
Cómo se Ve Hacer Trampa
Los revisores experimentados pueden detectar esto al instante:
SEÑALES DE ALARMA:
- 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 en repositorios vacíos
- Decenas de repositorios creados en una semana, todos con un solo commit
- Bots de commits generados automáticamente
Hacer trampa en tu gráfico es peor que tener lagunas. Señala desesperación y mal juicio. Consistencia real significa trabajar en cosas que te importan con una cadencia regular — lagunas y todo.
Construyendo un Gráfico Real
En lugar de fingir:
1. Escoge un proyecto y trabaja en él 30 minutos al día.
2. Contribuye a open source — incluso docs, tests o reportes de errores cuentan.
3. Mantén un repositorio de aprendizaje donde hagas commit de notas y experimentos.
4. Construye herramientas que realmente uses. Mejorarás naturalmente.
Alineando tu Portafolio al Rol Que Quieres
Tu portafolio debe parecer un adelanto 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 | Ejemplo de Repositorio |
|---|---|
| Uso de herramientas de IA en tu flujo de trabajo | Proyecto con config .claude/, commits asistidos por IA, comandos slash de Claude Code |
| Flujos de trabajo agénticos | Agente multi-paso 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 de embeddings y métricas de evaluación |
| Evaluación y pruebas | Marco de evaluación de salida de LLM, tests 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 Específico
| Rol Objetivo | Repositorios Imprescindibles | Nice-to-Have |
|---|---|---|
| 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 para Desarrolladores / DX | Herramienta CLI, SDK/librería, extensión de VS Code | Sitio de docs, herramienta de comunidad para desarrolladores |
Lista de Verificación de Revisión del 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 repositorios fijados tienen descripciones que tienen sentido para un extraño
- Al menos 3 repositorios fijados tienen capturas de pantalla o enlaces de demo en el README
- Ningún nombre de repositorio embarazoso visible en la primera página
Verificación de Profundidad (2 minutos)
- Cada repositorio fijado tiene un README que explica el qué, el por qué y el cómo
- Al menos un proyecto tiene un demo en vivo o enlace de despliegue
- La calidad del código en los repositorios fijados refleja tu nivel de habilidad actual
- El historial de commits muestra desarrollo real (no un solo blob de "commit inicial")
- Al menos un repositorio demuestra testing o CI/CD
Verificación de Historia (5 minutos)
- Tus repositorios fijados cuentan una historia coherente sobre tus habilidades
- Hay una progresión visible de proyectos más antiguos a más nuevos
- Tu portafolio está alineado con los roles a los que te diriges
- Puedes explicar cada repositorio fijado en una presentación 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. Pasa 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 |
|---|---|---|
| Repositorios fork sin cambios | Parece relleno | Elimina o haz privado |
| Clones de tutoriales ("todo-app", "weather-app") | Señala que seguiste instrucciones, no que sabes construir | Haz fork, luego extiéndelo mucho más allá del tutorial |
| Repositorios vacíos o con solo un README | Señala ideas abandonadas | Archívalos o elimínalos |
| Sin README en repositorios públicos | "No comunico sobre mi trabajo" | Agrega README a todo lo que mantengas público |
| 50+ repositorios visibles sin curaduría | Ruido abrumador, sin señal | Archiva agresivamente, fija estratégicamente |
| Repositorios fijados desactualizados (2+ años) | "No han construido nada recientemente" | Rota los fijados para mostrar trabajo reciente |
| README de perfil solo con estadísticas generadas automáticamente | Impersonal, poco esfuerzo | Escribe una biografía real con tu enfoque y objetivos |
| Repositorios llamados "test", "temp", "asdf" | Descuidado | Renómbralos o elimínalos |
Movimiento Poderoso
"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 repositorio fijado en calidad del README, profundidad técnica, estado del 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 harí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 plataforma de GitHub — README de perfil, fijación de repos, temas, gráfico de actividad |
career-resume | Ciclo de vida profesional completo — búsqueda de empleo, entrevistas, incorporación, revisiones de rendimiento |