Portfólio de Uma Página
Quando esta skill se aplica
Use quando Kene quiser uma única página pública representando seu trabalho — para um link em uma candidatura, uma assinatura de contato 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 colocar como link quando pedem amostras de trabalho", "crie uma página para a busca de [função]."
A decisão que esta skill registra (A26/A27)
Ficou indecisa por várias revisões, e é a única adição a este pacote que produz uma entrega voltada ao usuário em vez de melhorar uma existente. É exatamente por isso que foi adiada, e merece uma resposta declarada em vez de mais um adiamento.
A resposta é: construir, mas de forma restrita.
A favor: tudo que uma página única 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 verificação de afirmações, 21-output-templates tem o sistema de estrutura, e 17-cold-prospecting já quer algo para linkar. Não construir significa que Kene montará manualmente, a partir de um corpus que este pipeline mantém, o artefato mais reutilizável entre candidaturas.
Contra, e que define o escopo: um portfólio é um problema de design tanto quanto de conteúdo, e este pipeline não tem a ver com ser um construtor de sites. Um "sistema de portfólio" com temas, galerias, analytics e um CMS seria um segundo produto dentro de um pipeline de busca de emprego.
Então o escopo é deliberadamente restrito: uma página, gerada a partir de memórias confirmadas, publicada como HTML estático, versionada por função-alvo. Sem CMS, sem site multi-página, sem sistema de temas, sem analytics de visitantes. Se Kene quiser um site pessoal real, isso gera um bom arquivo inicial e ele leva para outro lugar — e esta skill deve dizer isso claramente, em vez de crescer nessa direção.
Portfólio versus currículo personalizado — para que cada um serve
A maneira mais comum de fazer isso errado é construir um portfólio que é um currículo mais bonito. Eles têm funções diferentes, e a diferença não é de apresentação.
Currículo Personalizado (05-resume-customizer) | Portfólio de Uma Página | |
|---|---|---|
| Como chega ao leitor | Empurrado. Enviado a um empregador para uma vaga. | Puxado. O leitor clica num link e chega. |
| O que o leitor já sabe | Eles têm a descrição da vaga na frente. Sabem contra 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 existe uma vaga | Sempre. | Frequentemente não — que é 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 repo, a coisa funcionando, o notebook, o texto. |
| Restrições de formato | Parsing ATS, uma página, layout convencional, sem formatação elaborada. | Sem parser. Capturas de tela, diagramas, narrativa mais longa, links. |
| Modo de falha | Palavras-chave perdidas; não corresponder à descrição da vaga. | Links quebrados, conteúdo desatualizado ou vazamento de algo que não deveria ser público. |
A linha que importa é "evidência". Todo o resto é consequência disso. Um currículo 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 gasta nele. Um portfólio é a camada de artefato: o lugar onde "reduziu o tempo de deploy de 40 minutos para 6" se torna um repo 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 currículo com pior compatibilidade com ATS e não deve ser publicada — a passagem de pré-publicação de 09-risk-tactics-gate aplica isso (veja "Links de artefatos" abaixo).
Quando cada um é necessário:
- Currículo, sempre. Toda candidatura. Não opcional, e esta skill não reduz isso.
- Portfólio, quando o leitor chega sem contexto. Contato a frio (
17-cold-prospecting), um link numa bio social, uma função que pede explicitamente 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 currículo carrega a URL do portfólio; o portfólio não reproduz o currículo. 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 currículo vai para um destinatário. Um portfólio é encontrável por qualquer um, incluindo um empregador atual, e publicar um é um ato levemente visível. O modo de discrição de 16-career-pulse se aplica: se Kene está pesquisando quietamente, isso é uma entrada real sobre se isso será publicado, e a skill levanta uma vez na primeira publicação, em vez de assumir de um jeito ou de outro.
Links de artefatos — o conteúdo principal, não um rodapé
Um portfólio sem links é um currículo. 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 funcionando. Link de maior valor que existe — um leitor pode usar em dez segundos. |
repo | GitHub/GitLab. Link para a raiz do repo a menos que um arquivo específico seja o ponto; um link profundo para um arquivo parece escolha a dedo. |
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 trabalho 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 um evento publicado. |
Notebooks precisam de uma verificação de legibilidade que repos não precisam. Um .ipynb com saídas limpas é uma parede de código que não prova nada para alguém passando os olhos. Link para a forma renderizada — um link Colab que funciona, ou nbviewer / renderização do próprio GitHub com saídas commitadas — e certifique-se de que a célula superior diz para que serve o notebook. Um notebook cuja primeira coisa visível é import pandas as pd é um link que o leitor fecha.
Um repo precisa de um README que sobreviva trinta segundos. Se o README do repo não diz o que a coisa é e por que existe, linká-lo é pior do que não linkar. Esta skill sinaliza isso; não corrige, porque corrigir é trabalho real que Kene tem que fazer.
Rot de link é verificado, porque a falha é silenciosa e total. Um portfólio com links quebrados é 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 repo que se tornou privado, ou um Colab que agora requer permissão são todos reportados por URL — nunca removidos silenciosamente da página, porque um artefato removido silenciosamente significa que a página fica mais fraca sem ninguém notar.
O que é seguro linkar — o limite rígido. Apenas artefatos que Kene possui 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 "Kene pode substituir" — 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, num nível de abstração que não revela nada, é legítimo e frequentemente mais legível do que o código seria.
Estrutura do conteúdo da página
Seis blocos, em ordem. Cada um é extraído de memórias confirmadas existentes; esta skill não origina fatos (Regra 5).
- Linha de posicionamento — uma frase, o que ele faz e para quem. Derivada do
target-profile.yamldo título alvo atual e do framing decontent-model-overlap.md, confirmada por Kene antes de ser publicada. 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. Todo número carrega a mesma barra de quantificação de um bullet de currículo. Um portfólio não é uma superfície de evidência inferior porque é autopublicado; se algo, uma afirmação permanentemente numa página pública merece mais cuidado do que uma num documento enviado uma vez. - Resumo de capacidades — habilidades agrupadas com a evidência anexada, de
domain-knowledge.md. Agrupadas, não uma parede de tags. - Links de artefatos por item de trabalho — anexados ao item 2, não listados separadamente no final. Um link ao lado da afirmação que ele evidencia está fazendo trabalho; o mesmo link num apêndice de "trabalho selecionado" é uma lista que o leitor pula. Veja "Links de artefatos" acima.
- Contato — o que Kene já escolheu tornar público. Padrão para 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, que é um argumento para o prompt de atualização abaixo, em vez de contra mostrá-la.
Variantes — dois eixos, não um
A primeira versão desta skill dizia "uma variante por cluster de título-alvo." Isso está certo para candidaturas e errado para contato a frio, que é uma situação diferente com um leitor diferente.
Eixo 1 — cluster de título-alvo (voltado para candidatura). 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 num plano multi-salto: a página deve apresentá-lo para a função para a qual está se candidatando agora, não para a que está a dois passos de distância.
Eixo 2 — modo de abordagem (voltado para contato). 17-cold-prospecting tem três modos e eles precisam de páginas genuinamente diferentes, porque a pergunta do leitor difere:
| Modo de abordagem | Pergunta do leitor | Com o que a página lidera |
|---|---|---|
| Adequação à função | "Ele poderia fazer o trabalho que já temos?" | Mesma forma que a variante de candidatura. Frequentemente a mesma variante. |
| Criação de função | "Vale a pena criar esta função aqui?" | O problema que a função resolve, evidenciado por trabalho onde ele o resolveu. A função é o argumento, não o currículo. |
| Serviço | "Eu contrataria esta pessoa para um trabalho definido?" | Escopo, entrega e trabalho passado comparável. Mais próximo de uma página de consultoria — e a que um portfólio em forma de função lê ativamente de forma errada. |
Contato a frio de adequação à função geralmente não precisa de variante separada — reutiliza a variante de título-alvo correspondente. Apenas abordagens de criação de função e serviço geralmente justificam sua própria, e apenas se Kene faz abordagens assim com frequência suficiente para valer a pena manter.
Relevância por contato sem variantes por contato. Em vez de uma página por prospecto, a página publicada carrega uma âncora estável por item de trabalho (#pipeline-de-credit-scoring), e 17-cold-prospecting linka profundamente para o relevante. Uma variante serve muitos contatos, cada um levando o leitor ao item que motivou o e-mail. Esta é a verdadeira razão para não proliferar variantes: a personalizaçã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 a pior falha de um portfólio é estar desatualizado. Se uma sexta for solicitada, a melhor pergunta é geralmente se duas existentes convergiram.
Variantes vivem em shared/portfolio/{slug_da_variante}/, cada uma registrando para que foi construída, o que selecionou e quando.
Escolhendo o que vai para a página — Kene escolhe
Esta skill propõe e ele ajusta. Mesmo formato propor-confirmar-salvar de tudo aqui, não uma página que ele descobre depois.
shared/portfolio-manifest.yaml contém três coisas:
- O pool elegível — toda entrada STAR, capacidade e artefato já confirmados na memória, cada um com um resumo de uma linha e um ID. Construído por varredura; Kene nunca digita. Este é o menu, e é a resposta para "o que poderia ir numa página."
- Regras globais —
always_includepara um ou dois itens emblemáticos que pertencem a toda variante independentemente do alvo, enever_includepara qualquer coisa que ele não queira público.nevervence sobre tudo, incluindo uma seleção por variante, e é o lar certo para trabalho que é tecnicamente compartilhável, mas com o qual ele prefere não liderar. - Seleção por variante — uma lista ordenada de IDs. Ordem é significativa e a página renderiza conforme dada, porque numa página única o primeiro item é a maior parte da impressão.
Como a conversa acontece. Numa nova variante, esta skill propõe uma seleção do pool com uma razão por item, classificado para aquele alvo. Kene adiciona, remove e reordena em linguagem natural — "remove o segundo, coloca o trabalho de pagamentos no topo, adiciona 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 toda vez. Uma página que Kene selecionou não deve se reorganizar silenciosamente porque uma nova entrada STAR chegou.
Novo material é oferecido, nunca inserido. Quando algo entra no banco que se classificaria bem 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 seu nome.
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 Kene vai querer editá-la manualmente e um arquivo gerado que ele não pode tocar é pior do que nenhum arquivo.
Onde a hospedagem é perguntada e o que acontece se ele não se importa
Na primeira publicação, uma vez. Não na geração…