Portafolio de una página
Cuándo se aplica esta habilidad
Úsala cuando Kenechukwu quiera una única página pública que represente su trabajo, ya sea para un enlace en una solicitud, un firma para prospección en frío, un perfil social, o porque un rol solicite explícitamente un portafolio. Disparadores: "Necesito una página de portafolio", "¿qué enlazo cuando me piden muestras de trabajo?", "crea una página de una página para la búsqueda de [rol]".
La decisión que registra esta habilidad (A26/A27)
Esto quedó sin decidir en varias revisiones, y es la única adición a este paquete que produce un nuevo entregable orientado al usuario en lugar de mejorar uno existente. Esa es exactamente la razón por la que se pospuso repetidamente, y merece una respuesta explícita en lugar de otra postergación.
La respuesta es: constrúyela, de manera limitada.
A favor: todo lo que necesita una página única ya está en el paquete y ya ha sido confirmado según la Regla 5. El banco STAR tiene las historias, la puerta de cuantificación tiene los números, 09-risk-tactics-gate tiene el pase de verificación de reclamaciones, 21-output-templates tiene el sistema de estructura, y 17-cold-prospecting ya quiere algo a lo que enlazar. No construirla significa que Kenechukwu ensambla a mano, a partir de un corpus que esta tubería mantiene, el único artefacto que es más reutilizable entre aplicaciones.
En contra, y por qué define el alcance: un portafolio es tanto un problema de diseño como de contenido, y esta tubería no tiene por qué ser un constructor de sitios web. Un "sistema de portafolio" con temas, galerías, analíticas y un CMS sería un segundo producto viviendo dentro de una tubería de búsqueda de empleo.
Por lo tanto, el alcance es deliberadamente limitado: una página, generada a partir de memoria confirmada, publicada como HTML estático, versionada por rol objetivo. Sin CMS, sin sitio de varias páginas, sin sistema de temas, sin analíticas de visitantes. Si Kenechukwu quiere un sitio personal real, esto produce un buen archivo inicial y él lo lleva a otro lado — y esta habilidad debe decirlo claramente en lugar de crecer hacia eso.
Portafolio vs. currículum personalizado — para qué sirve cada uno
La forma más común de equivocarse es construir un portafolio que sea un currículum más bonito. Hacen trabajos diferentes, y la diferencia no es la presentación.
Currículum personalizado (05-resume-customizer) | Portafolio de una página | |
|---|---|---|
| Cómo llega al lector | Empujado. Enviado a un empleador para una vacante. | Tirado. El lector hace clic en un enlace y llega. |
| Lo que el lector ya sabe | Tienen la descripción del puesto delante. Saben contra qué están comparando. | A menudo nada. Podría ser un reclutador navegando, un gerente de contratación que recibió un correo frío, alguien de una conferencia, una persona que acaba de leer una respuesta suya en X. |
| Si existe un rol | Siempre. | Frecuentemente no — que es toda la base de la prospección en frío. |
| Vida útil | Congelado en el envío. Una instantánea. | Vivo. Mutable y permanentemente público. |
| Evidencia | Afirma. "Reduje el tiempo de despliegue de 40 minutos a 6." | Muestra. Aquí está el repositorio, la cosa en funcionamiento, el notebook, el informe. |
| Restricciones de formato | Análisis ATS, una página, diseño convencional, sin formato ingenioso. | Sin analizador sintáctico. Capturas de pantalla, diagramas, narración más larga, enlaces. |
| Modo de fallo | Palabras clave perdidas; no coincidir con la descripción del puesto. | Enlaces muertos, contenido desactualizado o filtración de algo que no debería ser público. |
La fila que importa es "evidencia". Todo lo demás es consecuencia de ello. Un currículum solo puede hacer afirmaciones — el formato no tiene espacio para pruebas y el lector no tiene forma de verificarlas en los noventa segundos que dedica. Un portafolio es la capa de artefactos: el lugar donde "reduje el tiempo de despliegue de 40 minutos a 6" se convierte en un repositorio con la configuración de CI antes y después en el historial.
Esa es la razón para construir uno en absoluto. Si una página de portafolio no lleva enlaces a artefactos reales, es un currículum con peor compatibilidad ATS y no debería publicarse — 09-risk-tactics-gate's el pase previo a la publicación lo hace cumplir (ver "Enlaces a artefactos" a continuación).
Cuándo se necesita cada uno:
- Currículum, siempre. Cada solicitud. No opcional, y esta habilidad no lo reduce.
- Portafolio, cuando el lector llega sin contexto. Prospección en frío (
17-cold-prospecting), un enlace en una biografía social, un rol que solicita explícitamente muestras de trabajo, una referencia donde alguien está pasando su nombre, o cualquier conversación donde "¿qué has construido?" viene antes de "aquí está la especificación del trabajo." - Ambos, vinculados. El currículum lleva la URL del portafolio; el portafolio no reproduce el currículum. La redundancia entre ellos es espacio desperdiciado en la página y una segunda cosa que mantener sincronizada.
La consideración del empleador actual. Un currículum va a un destinatario. Un portafolio es localizable por cualquiera, incluido un empleador actual, y publicar uno es un acto moderadamente visible. 16-career-pulse's el manejo del modo de discreción se aplica: si Kenechukwu está buscando en silencio, eso es una entrada real sobre si esto se publica en absoluto, y la habilidad lo plantea una vez en la primera publicación en lugar de asumir de una forma u otra.
Enlaces a artefactos — el contenido principal, no un pie de página
Un portafolio sin enlaces es un currículum. Los enlaces son para lo que sirve, por lo que reciben un tratamiento de primera clase en lugar de una lista de "trabajo seleccionado" al final.
Cada elemento de trabajo puede llevar uno o más artefactos:
| Tipo | Notas |
|---|---|
deployed | La cosa en funcionamiento. El enlace de mayor valor que existe: un lector puede usarlo en diez segundos. |
repo | GitHub/GitLab. Enlaza a la raíz del repositorio a menos que un archivo específico sea el punto; un enlace profundo a un archivo se lee como cherry-picking. |
notebook | Colab, Jupyter, Kaggle. Ver la nota de legibilidad a continuación. |
writeup | Una entrada de blog, un documento de diseño, un análisis post-mortem. A menudo el artefacto más fuerte para trabajos cuyo código no es compartible. |
demo | Una grabación de pantalla donde la cosa no se puede desplegar públicamente. Dos minutos, sin narración requerida. |
package | npm, PyPI, crates.io — una cosa publicada e instalable. |
paper | arXiv o un lugar de publicación. |
Los notebooks necesitan una verificación de legibilidad que los repositorios no. Un .ipynb con salidas borradas es un muro de código que no prueba nada a alguien que hojea. Enlaza la forma renderizada — un enlace de Colab que funcione, o nbviewer / el propio renderizado de GitHub con salidas comprometidas — y asegúrate de que la celda superior diga para qué sirve el notebook. Un notebook cuya primera cosa visible es import pandas as pd es un enlace que el lector cierra.
Un repositorio necesita un README que sobreviva treinta segundos. Si el README del repositorio no dice qué es la cosa y por qué existe, enlazarlo es peor que no enlazarlo. Esta habilidad lo señala; no lo arregla, porque arreglarlo es trabajo real que Kenechukwu tiene que hacer.
La podredumbre de los enlaces se verifica, porque el fallo es silencioso y total. Un portafolio con enlaces muertos es peor que uno sin enlaces: parece descuidado exactamente en la dimensión que la página existe para demostrar. Cada URL de artefacto se verifica en la publicación y se vuelve a verificar en la actualización trimestral (shared/applications_db_schema_addendum_18.sql, portfolio_artifacts). Un 404, un repositorio hecho privado o un Colab que ahora requiere permiso se reportan por URL — nunca se eliminan silenciosamente de la página, porque un artefacto eliminado silenciosamente significa que la página se debilita silenciosamente y nadie se da cuenta.
Lo que es seguro enlazar — el límite duro. Solo artefactos que Kenechukwu posee o que ya son públicos con permiso. Código propiedad del empleador, documentos internos, cualquier cosa bajo NDA y cualquier cosa que contenga datos de un tercero no van en una página pública. Esto se verifica en el momento de agregar y nuevamente en la publicación, y es la única verificación en esta habilidad que no tiene una ruta de "Kenechukwu puede anular" — el modo de fallo es publicar algo que no poseía, y eso termina carreras, no trabajos.
Donde el trabajo subyacente no se puede mostrar, los tipos writeup y demo existen precisamente para eso: describir un sistema que construyó, a un nivel de abstracción que no revela nada, es legítimo y a menudo más legible de lo que habría sido el código.
Seis bloques, en orden. Cada uno se extrae de la memoria confirmada existente; esta habilidad no origina hechos (Regla 5).
- Línea de posicionamiento — una oración, qué hace y para quién. Derivada del
target-profile.yaml's del título objetivo actual ycontent-model-overlap.md's del encuadre, confirmado por Kenechukwu antes de que se publique. Esta es la línea más difícil en la página y la que vale más iteración. - Tres a cinco elementos de trabajo — del banco STAR, seleccionados para el rol objetivo de la misma manera que
05-resume-customizerselecciona. Cada uno es situación → lo que hizo → el número. Cada número lleva la misma barra de cuantificación que una viñeta de currículum. Un portafolio no es una superficie de menor evidencia porque es autopublicado; si acaso, una afirmación que reside permanentemente en una página pública merece más cuidado que una en un documento enviado una vez. - Resumen de capacidades — habilidades agrupadas con la evidencia adjunta, de
domain-knowledge.md. Agrupadas, no un muro de etiquetas. - Enlaces a artefactos por elemento de trabajo — adjuntos al elemento 2, no listados por separado al final. Un enlace que se encuentra al lado de la afirmación que evidencia está haciendo trabajo; el mismo enlace en un apéndice de "trabajo seleccionado" es una lista que el lector salta. Ver "Enlaces a artefactos" arriba.
- Contacto — lo que Kenechukwu ya haya elegido hacer público. Por defecto nada hasta que él diga lo contrario.
- Última actualización — una fecha real. Un portafolio con una fecha desactualizada se lee peor que uno sin fecha, que es un argumento para el aviso de actualización a continuación en lugar de en contra de mostrarla.
Variantes — dos ejes, no uno
La primera versión de esta habilidad decía "una variante por grupo de títulos objetivo." Eso es correcto para aplicaciones y incorrecto para prospección en frío, que es una situación diferente con un lector diferente.
Eje 1 — grupo de títulos objetivo (orientado a aplicaciones). El mismo material subyacente, diferente selección y ordenamiento por familia de roles. El mismo principio que un currículum adaptado. 19-career-path-planner's el salto actual es el predeterminado en un plan de múltiples saltos: la página debe presentarlo para el rol al que está solicitando ahora, no para el que está a dos movimientos de distancia.
Eje 2 — modo de presentación (orientado a prospección). 17-cold-prospecting tiene tres modos y necesitan páginas genuinamente diferentes, porque la pregunta del lector difiere:
| Modo de presentación | Pregunta del lector | Con qué lidera la página |
|---|---|---|
| Ajuste al rol | "¿Podría hacer el trabajo que ya tenemos?" | Misma forma que la variante de aplicación. A menudo la misma variante. |
| Creación de rol | "¿Vale la pena crear esta función aquí?" | El problema que la función resuelve, evidenciado por el trabajo donde lo resolvió. El rol es el argumento, no el currículum. |
| Servicio | "¿Contrataría a esta persona para un trabajo definido?" | Alcance, entregable y trabajo comparable anterior. Lo más cercano a una página de consultoría — y la que un portafolio con forma de rol malinterpreta activamente. |
La prospección de ajuste al rol generalmente no necesita una variante separada — reutiliza la del título objetivo coincidente. Solo las presentaciones de creación de rol y servicio generalmente justifican la suya propia, y solo si Kenechukwu presenta de esa manera con la frecuencia suficiente como para que valga la pena mantenerla.
Relevancia por prospección sin variantes por prospección. En lugar de una página por prospecto, la página publicada lleva un ancla estable por elemento de trabajo (#credit-scoring-pipeline), y 17-cold-prospecting enlaza profundamente al relevante. Una variante sirve para muchas prospecciones, cada una aterrizando al lector en el elemento que motivó el correo electrónico. Esta es la razón real para no proliferar variantes: la adaptación que importa es qué elemento ven primero, y un ancla lo hace gratis.
Ponle un límite. Cuatro o cinco variantes en ambos ejes es mucho. Cada una es una página que puede quedar desactualizada de forma independiente, y el peor fallo de un portafolio es estar desactualizado. Si se solicita una sexta, la mejor pregunta es generalmente si dos existentes han convergido.
Las variantes viven en shared/portfolio/{variant_slug}/, cada una registrando para qué se construyó, qué seleccionó y cuándo.
Elegir qué va en la página — Kenechukwo elige
Esta habilidad propone y él ajusta. Misma forma de proponer-confirmar-guardar que todo lo demás aquí, no una página que descubre después.
shared/portfolio-manifest.yaml contiene tres cosas:
- El grupo elegible — cada entrada STAR, capacidad y artefacto ya confirmados en la memoria, cada uno con un resumen de una línea y un ID. Construido escaneando; Kenechukwu nunca lo escribe. Este es el menú, y es la respuesta a "¿qué podría ir en una página?"
- Reglas globales —
always_includepara el ítem o dos emblemáticos que pertenecen a cada variante independientemente del objetivo, ynever_includepara cualquier cosa que no quiera que sea pública en absoluto.nevergana sobre todo, incluida una selección por variante, y es el hogar adecuado para el trabajo que es técnicamente compartible pero con el que preferiría no liderar. - Selección por variante — una lista ordenada de IDs. El orden es significativo y la página lo renderiza tal como se da, porque en una página única el primer elemento es la mayor parte de la impresión.
Cómo va la conversación. En una nueva variante, esta habilidad propone una selección del grupo con una razón por elemento, clasificada para ese objetivo. Kenechukwu agrega, elimina y reordena en lenguaje natural — "elimina el segundo, mueve el trabajo de pagos al principio, agrega lo que hice para la cooperativa." Confirmado una vez, escrito en el manifiesto.
Una reconstrucción nunca vuelve a seleccionar silenciosamente. La selección existente es el punto de partida cada vez. Una página que Kenechukwu seleccionó no debería reorganizarse silenciosamente porque una nueva entrada STAR ha llegado.
El material nuevo se ofrece, nunca se inserta. Cuando algo entra en el banco que clasificaría alto para una variante existente, la actualización trimestral lo plantea una vez — "esto sería un buen ajuste para la variante fintech, ¿lo agrego?" Una pregunta, no un diff aplicado en su nombre.
Publicación
HTML estático, un archivo más activos, sin paso de compilación y sin framework. La salida es legible y editable a mano, porque Kenechukwu querrá editarlo a mano y un archivo generado que no puede tocar es peor que ningún archivo.
Dónde se aloja
...