Portfolio One-Pager (Portfólio de Uma Página)
Quando esta skill se aplica
Use quando Kenechukwu quer uma única página pública representando seu trabalho — para um link em uma candidatura, uma assinatura de prospecção a frio, um perfil social, ou porque uma função pede explicitamente um portfólio. Gatilhos: "Preciso de uma página de portfólio", "o que eu linko quando pedem amostras de trabalho", "crie um one-pager para a busca de [função]".
A decisão que esta skill registra (A26/A27)
Isso ficou indeciso em várias revisões, e é a única adição neste pacote que produz um novo entregável voltado ao usuário em vez de melhorar um existente. É exatamente por isso que foi adiado repetidamente, e merece uma resposta declarada em vez de outro adiamento.
A resposta é: construir, de forma restrita.
O caso a favor: tudo o que um one-pager precisa já está no pacote e
já confirmado sob a Regra 5. O banco STAR tem as histórias, o
portão de quantificação tem os números, 09-risk-tactics-gate tem a
passagem de verificação de alegações, 21-output-templates tem o sistema
de estrutura, e 17-cold-prospecting já quer algo para linkar. Não
construir significa que Kenechukwu monta manualmente, a partir de um corpus que este pipeline
mantém, o único artefato que é mais reutilizável entre candidaturas.
O caso contra, e por que isso define o escopo: um portfólio é um problema de design tanto quanto de conteúdo, e este pipeline não tem nada a ver com ser um construtor de sites. Um "sistema de portfólio" com temas, galerias, análises e um CMS seria um segundo produto vivendo dentro de um pipeline de busca de emprego.
Então o escopo é deliberadamente restrito: uma página, gerada a partir de memória confirmada, publicada como HTML estático, versionada por função alvo. Sem CMS, sem site multi-páginas, sem sistema de temas, sem análises de visitantes. Se Kenechukwu quiser um site pessoal de verdade, isso produz um bom arquivo inicial e ele leva para outro lugar — e esta skill deve dizer isso claramente em vez de crescer em direção a isso.
Portfólio versus CV personalizado — para que cada um serve
A forma mais comum de errar é construir um portfólio que é um CV mais bonito. Eles fazem trabalhos diferentes, e a diferença não é apresentação.
CV Personalizado (05-resume-customizer) | Portfólio One-Pager | |
|---|---|---|
| Como chega ao leitor | Empurrado. Enviado para um empregador para uma vaga. | Puxado. O leitor clica em um link e chega. |
| O que o leitor já sabe | Eles têm a descrição da vaga na frente. Sabem com o que estão comparando. | Frequentemente nada. Pode ser um recrutador navegando, um gerente de contratação que recebeu um e-mail frio, alguém de uma conferência, uma pessoa que acabou de ler uma resposta dele no X. |
| Se uma função existe | Sempre. | Frequentemente não — que é toda a base da prospecção a frio. |
| Vida útil | Congelado no envio. Um instantâneo. | Vivo. Mutável e permanentemente público. |
| Evidência | Afirma. "Reduziu o tempo de deploy de 40 minutos para 6." | Mostra. Aqui está o repositório, o sistema rodando, o notebook, o artigo. |
| Restrições de formato | Parsing ATS, uma página, layout convencional, sem formatação criativa. | Sem parser. Capturas de tela, diagramas, narrativa mais longa, links. |
| Modo de falha | Palavras-chave perdidas; não corresponder à descrição da vaga. | Links mortos, conteúdo desatualizado ou vazar algo que não deveria ser público. |
A linha que importa é "evidência". Todo o resto é consequência disso. Um CV só pode fazer afirmações — o formato não tem espaço para provas e o leitor não tem como verificar nos noventa segundos que passa nele. Um portfólio é a camada de artefato: o lugar onde "reduziu o tempo de deploy de 40 minutos para 6" se torna um repositório com a configuração de CI antes e depois no histórico.
Essa é a razão para construir um. Se uma página de portfólio não carrega
links para artefatos reais, é um CV com pior compatibilidade ATS e não
deveria ser publicado — a passagem de pré-publicação de 09-risk-tactics-gate
impõe isso (veja "Links de artefatos" abaixo).
Quando cada um é necessário:
- CV, sempre. Toda candidatura. Não opcional, e esta skill não reduz isso.
- Portfólio, quando o leitor chega sem contexto. Prospecção a frio
(
17-cold-prospecting), um link em uma biografia social, uma função que explicitamente pede amostras de trabalho, uma indicação onde alguém está passando o nome dele, ou qualquer conversa onde "o que você construiu" vem antes de "aqui está a descrição da vaga." - Ambos, linkados. O CV carrega a URL do portfólio; o portfólio não reproduz o CV. Redundância entre eles é espaço desperdiçado na página e uma segunda coisa para manter sincronizada.
A consideração do empregador atual. Um CV vai para um destinatário. Um
portfólio é encontrável por qualquer um, incluindo o empregador atual, e
publicar um é um ato moderadamente visível. O tratamento de modo de discrição
de 16-career-pulse se aplica: se Kenechukwu está procurando silenciosamente, isso é um
insumo real para se isso chega a ser publicado, e a skill levanta isso uma vez
na primeira publicação em vez de assumir de qualquer forma.
Links de artefatos — o conteúdo principal, não um rodapé
Um portfólio sem links é um CV. Links são para o que ele serve, então recebem tratamento de primeira classe em vez de uma lista de "trabalhos selecionados" no final.
Cada item de trabalho pode carregar um ou mais artefatos:
| Tipo | Notas |
|---|---|
deployed | A coisa rodando. Link de maior valor que existe — um leitor pode usar em dez segundos. |
repo | GitHub/GitLab. Link para a raiz do repositório a menos que um arquivo específico seja o ponto; um link profundo para um arquivo parece cherry-picking. |
notebook | Colab, Jupyter, Kaggle. Veja a nota de legibilidade abaixo. |
writeup | Um post de blog, um documento de design, um postmortem. Frequentemente o artefato mais forte para trabalhos cujo código não é compartilhável. |
demo | Uma gravação de tela onde a coisa não pode ser implantada publicamente. Dois minutos, sem narração necessária. |
package | npm, PyPI, crates.io — uma coisa publicada e instalável. |
paper | arXiv ou uma publicação. |
Notebooks precisam de uma verificação de legibilidade que repositórios não precisam. Um .ipynb
com saídas limpas é uma parede de código que não prova nada para alguém
folheando. Link a forma renderizada — um link do Colab que roda, ou nbviewer /
renderização do próprio GitHub com saídas commitadas — e certifique-se de que a célula
topo diga para que serve o notebook. Um notebook cuja primeira coisa visível
é import pandas as pd é um link que o leitor fecha.
Um repositório precisa de um README que sobreviva trinta segundos. Se o README do repositório não diz o que a coisa é e por que existe, linká-lo é pior do que não linká-lo. Esta skill sinaliza isso; não corrige, porque corrigir é trabalho real que Kenechukwu tem que fazer.
Link rot é verificado, porque a falha é silenciosa e total. Um
portfólio com links mortos é pior do que um sem links: parece descuidado
exatamente na dimensão que a página existe para demonstrar. Cada URL de
artefato é verificado na publicação e re-verificado na atualização trimestral
(shared/applications_db_schema_addendum_18.sql,
portfolio_artifacts). Um 404, um repositório tornado privado, ou um Colab que
agora requer permissão são todos reportados por URL — nunca silenciosamente removidos
da página, porque um artefato removido silenciosamente significa que a página fica silenciosamente mais fraca e ninguém percebe.
O que é seguro linkar — o limite rígido. Apenas artefatos que Kenechukwu possua ou que já são públicos com permissão. Código de propriedade do empregador, documentos internos, qualquer coisa sob NDA e qualquer coisa contendo dados de terceiros não vão para uma página pública. Isso é verificado no momento da adição e novamente na publicação, e é a única verificação nesta skill que não tem um caminho de "Kenechukwu pode sobrescrever" — o modo de falha é publicar algo que ele não possuía, e isso acaba com carreiras, não com empregos.
Onde o trabalho subjacente não pode ser mostrado, os tipos writeup e demo
existem precisamente para isso: descrever um sistema que ele construiu, em um nível de
abstração que não revela nada, é legítimo e frequentemente mais legível do que o código
teria sido.
Seis blocos, em ordem. Cada um é extraído da memória confirmada existente; esta skill não origina fatos (Regra 5).
- Linha de posicionamento — uma frase, o que ele faz e para quem.
Derivada de
target-profile.yaml's título alvo atual econtent-model-overlap.md's enquadramento, confirmado por Kenechukwu antes de publicar. Esta é a linha mais difícil da página e a que vale mais iteração. - Três a cinco itens de trabalho — do banco STAR, selecionados para a
função alvo da mesma forma que
05-resume-customizerseleciona. Cada um é situação → o que ele fez → o número. Cada número carrega a mesma barra de quantificação que um bullet de currículo. Um portfólio não é uma superfície de menor evidência porque é auto-publicado; se algo, uma alegação permanente em uma página pública merece mais cuidado do que uma em um documento enviado uma vez. - Resumo de capacidades — habilidades agrupadas com a evidência anexada,
de
domain-knowledge.md. Agrupado, não uma parede de tags. - Links de artefatos por item de trabalho — anexado ao item 2, não listado separadamente no final. Um link ao lado da alegação que evidencia está fazendo trabalho; o mesmo link em um apêndice de "trabalhos selecionados" é uma lista que o leitor pula. Veja "Links de artefatos" acima.
- Contato — o que Kenechukwu já escolheu tornar público. Padrão é nada até que ele diga o contrário.
- Última atualização — uma data real. Um portfólio com uma data desatualizada parece pior do que um sem data, o que é um argumento para o prompt de atualização abaixo, não contra mostrá-la.
Variantes — dois eixos, não um
A primeira versão desta skill disse "uma variante por cluster de título alvo." Isso está certo para candidaturas e errado para prospecção a frio, que é uma situação diferente com um leitor diferente.
Eixo 1 — cluster de título alvo (voltado a candidaturas). Mesmo
material subjacente, seleção e ordenação diferentes por família de função. O mesmo
princípio de um currículo adaptado. O salto atual de 19-career-path-planner é o
padrão em um plano de vários saltos: a página deve apresentá-lo para a função
para a qual ele está se candidatando agora, não para a que está dois movimentos distante.
Eixo 2 — modo de pitch (voltado a prospecção). 17-cold-prospecting tem
três modos e eles precisam de páginas genuinamente diferentes, porque a pergunta do leitor
difere:
| Modo de pitch | Pergunta do leitor | Com o que a página começa |
|---|---|---|
| Role-fit | "Ele poderia fazer o trabalho que já temos?" | Mesma forma que a variante de candidatura. Frequentemente a mesma variante. |
| Role-creation | "Essa função vale a pena ser criada aqui?" | O problema que a função resolve, evidenciado pelo trabalho onde ele o resolveu. A função é o argumento, não o CV. |
| Service | "Eu contrataria essa pessoa para um trabalho definido?" | Escopo, entregável e trabalho comparável no passado. Mais próximo de uma página de consultoria — e aquele que um portfólio em forma de função interpreta ativamente mal. |
Prospecção role-fit geralmente não precisa de variante separada — reutiliza a correspondente ao título alvo. Apenas pitches de role-creation e service geralmente justificam a sua própria, e apenas se Kenechukwu fizer esse tipo de pitch com frequência suficiente para valer a pena manter.
Relevância por prospecção sem variantes por prospecção. Em vez de uma página
por prospecto, a página publicada carrega uma âncora estável por item de trabalho
(#credit-scoring-pipeline), e 17-cold-prospecting faz deep-link
para o relevante. Uma variante serve muitos prospecções, cada um pousando o
leitor no item que motivou o e-mail. Esta é a verdadeira razão para não
proliferar variantes: a adaptação que importa é qual item eles veem
primeiro, e uma âncora faz isso de graça.
Limite. Quatro ou cinco variantes em ambos os eixos é muito. Cada uma é uma página que pode ficar desatualizada independentemente, e o pior fracasso de um portfólio é estar desatualizado. Se uma sexta for solicitada, a melhor pergunta é geralmente se duas existentes convergiram.
Variantes residem em shared/portfolio/{variant_slug}/, cada uma registrando para que
foi construída, o que selecionou e quando.
Escolhendo o que vai para a página — Kenechukwu escolhe
Esta skill propõe e ele ajusta. Mesmo formato de propor-confirmar-salvar que tudo o mais aqui, não é uma página que ele descobre depois.
shared/portfolio-manifest.yaml contém três coisas:
- O pool elegível — cada entrada STAR, capacidade e artefato já confirmado na memória, cada um com um resumo de uma linha e um id. Construído por varredura; Kenechukwu nunca digita. Este é o menu, e é a resposta para "o que poderia ir em uma página."
- Regras globais —
always_includepara os um ou dois itens principais que pertencem a toda variante independentemente do alvo, enever_includepara qualquer coisa que ele não quer público.neversobrepõe tudo, incluindo uma seleção por variante, e é o lar certo para trabalhos que são tecnicamente compartilháveis, mas que ele prefere não destacar. - Seleção por variante — uma lista ordenada de ids. A ordem é significativa e a página renderiza como dada, porque em um one-pager o primeiro item é a maior parte da impressão.
Como a conversa acontece. Em uma nova variante, esta skill propõe uma seleção do pool com uma razão por item, classificada para aquele alvo. Kenechukwu adiciona, remove e reordena em linguagem natural — "remova o segundo, coloque o trabalho de pagamentos no topo, adicione a coisa que fiz para a cooperativa." Confirmado uma vez, escrito no manifesto.
Uma reconstrução nunca re-seleciona silenciosamente. A seleção existente é o ponto de partida a cada vez. Uma página que Kenechukwu curou não deve se reorganizar silenciosamente porque uma nova entrada STAR chegou.
Novo material é oferecido, nunca inserido. Quando algo entra no banco que seria classificado alto para uma variante existente, a atualização trimestral levanta uma vez — "isso seria um bom ajuste para a variante fintech, adicionar?" Uma pergunta, não um diff aplicado em nome dele.
Publicação
HTML estático, um arquivo mais ativos, sem etapa de build e sem framework. A saída é legível e editável manualmente, porque Kenechukwu vai querer editá-la manualmente e um arquivo gerado que ele não pode tocar é pior do que nenhum arquivo.