maumoya/pro-portfolio-dev

PRO Portfolio DEV

Usuário do GitHub dentro, portfólio ao vivo fora. Scripts fazem a busca, construção, verificação e publicação; você faz a única coisa que eles não podem: escolher os projetos e escrever textos honestos e impactantes. Os caminhos são relativos à pasta desta skill. Trabalhe em uma pasta temporária, ex.: portfolio/.

1 · Buscar (apenas fatos)

python3 scripts/fetch.py USER --out portfolio/repos.json (2 chamadas à API pública, sem token). Ele exibe os principais repositórios. Estes são os únicos fatos que você pode usar; nunca invente estrelas, usuários ou resultados.

2 · Planejar (pergunte, depois escreva portfolio/plan.json)

Pergunte em uma única mensagem, com padrões que o usuário pode aceitar dizendo "vai":

• Quem e para quem: nome, cargo, o público-alvo (recrutadores, clientes, colegas). Padrão: nome e biografia do GitHub.
• Projetos: proponha os 4-9 mais fortes (estrelas, pushes recentes, um homepage, uma descrição clara); eles escolhem.
• Habilidades e experiência para tornar pesquisáveis (opcional) e links de contato.
• Onde vai ficar: USER.github.io (raiz) ou uma pasta docs/ em um repositório. A URL deve ser definitiva.

Depois escreva plan.json (esquema e regras de copy: references/plan.md). Regras de copy resumidas: título ≤8 palavras, tagline diz o que + para quem, cada projeto recebe um pitch de uma linha (o benefício, não a stack) e uma linha opcional proof que cita um número encontrado no README ou nos dados do GitHub daquele repositório, nunca inventado.

Idiomas: As strings de UI para 10 idiomas estão em scripts/ui.json. Para traduzir o texto do próprio usuário, adicione plan.t.<idioma> e traduza pelo significado, da forma que um escritor nativo diria naquele idioma, não palavra por palavra (veja references/plan.md, "Traduzindo"). Em seguida, releia cada idioma uma vez como leitor nativo e corrija qualquer coisa que soe literal.

3 · Construir e verificar

python3 scripts/build.py portfolio/repos.json portfolio/plan.json --out portfolio/site
python3 scripts/check.py portfolio/site

check.py deve imprimir PASS. Abra portfolio/site/index.html em um navegador e veja antes de publicar: teste a busca com um erro de digitação, mude para Árabe (direita para esquerda) e um tema escuro.

4 · Publicar (para fora: pergunte primeiro)

Mostre ao usuário a página e o destino, e obtenha um sim. Depois: bash scripts/publish.sh portfolio/site REPO_CLONE URL [--folder root|docs] --yes Ele commita, envia, ativa o Pages se necessário e consulta até que a nova build esteja no ar, imprimindo LIVE … in N s.

5 · Medir e relatar

Relate em ≤4 linhas: a URL ao vivo, o tempo LIVE, a pontuação do check.py e SEO / acessibilidade / desempenho do Lighthouse via PageSpeed Insights (pagespeed.web.dev, gratuito) ou um lighthouse local se instalado.

Feito quando

• check.py imprime PASS no site construído.
• Cada projeto na página é um repositório real do usuário, e cada número nele remonta a dados do GitHub ou a um README.
• A URL ao vivo retorna a nova build (publish.sh imprimiu LIVE), ou o usuário escolheu não publicar.

Nunca

• Invente projetos, métricas, empregadores ou depoimentos. Pergunte.
• Faça push, publique ou ative o Pages sem o sim do usuário.
• Adicione rastreadores, análises, cookies ou scripts externos. A página não faz requisições de terceiros.
• Sobrescreva um site existente sem mostrar quais mudanças (publish.sh sem --yes é a simulação).