maumoya/pro-portfolio-dev

PRO Portfolio DEV

Usuario de GitHub dentro, portafolio vivo fuera. Los scripts se encargan de obtener, construir, verificar y publicar; tú haces lo único que ellos no pueden: elegir los proyectos y escribir copias honestas y contundentes. Las rutas son relativas a la carpeta de esta habilidad. Trabaja en una carpeta temporal, p. ej. portfolio/.

1 · Obtener (solo datos reales)

python3 scripts/fetch.py USUARIO --out portfolio/repos.json (2 llamadas a la API pública, sin token). Muestra los repositorios principales. Estos son los únicos datos que puedes usar; nunca inventes estrellas, usuarios ni resultados.

2 · Planificar (pregunta, luego escribe portfolio/plan.json)

Pregunta en un solo mensaje, con valores predeterminados que el usuario puede aceptar diciendo "adelante":

• Quién y para quién: nombre, rol, la audiencia (reclutadores, clientes, colegas). Valor predeterminado: nombre y biografía de GitHub.
• Proyectos: propón los 4-9 más destacados (estrellas, pushes recientes, una página de inicio, una descripción clara); ellos eligen.
• Habilidades y experiencia para hacerlas buscables (opcional), y enlaces de contacto.
• Dónde vivirá: USUARIO.github.io (raíz) o la carpeta docs/ de un repositorio. La URL debe ser definitiva.

Luego escribe plan.json (esquema y reglas de copia: references/plan.md). Reglas de copia en resumen: título ≤8 palabras, eslogan dice qué + para quién, cada proyecto recibe un pitch de una línea (el beneficio, no la tecnología) y una línea proof opcional que cite un número encontrado en el README de ese repositorio o en los datos de GitHub, nunca inventado.

Idiomas: Las cadenas de UI para 10 idiomas vienen en scripts/ui.json. Para traducir el texto propio del usuario, añade plan.t.<idioma> y traduce por significado, como lo diría un hablante nativo en ese idioma, no palabra por palabra (ver references/plan.md, "Traducción"). Luego relee cada idioma una vez como lector nativo y corrige cualquier cosa que suene literal.

3 · Construir y verificar

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

check.py debe imprimir PASS. Abre portfolio/site/index.html en un navegador y míralo antes de publicar: prueba la búsqueda con un error tipográfico, cambia a árabe (derecha a izquierda) y a un tema oscuro.

4 · Publicar (hacia afuera: primero pregunta)

Muestra al usuario la página y el destino, y obtén un sí. Luego: bash scripts/publish.sh portfolio/site REPO_CLONE URL [--folder root|docs] --yes Confirma, sube, activa Pages si es necesario y espera hasta que la nueva compilación esté en vivo, imprimiendo LIVE … in N s.

5 · Medir e informar

Informa en ≤4 líneas: la URL en vivo, el tiempo LIVE, la puntuación de check.py, y el SEO / accesibilidad / rendimiento de Lighthouse desde PageSpeed Insights (pagespeed.web.dev, gratuito) o un lighthouse local si está instalado.

Listo cuando

• check.py imprime PASS en el sitio construido.
• Cada proyecto en la página es un repositorio real del usuario, y cada número en ella se remonta a datos de GitHub o un README.
• La URL en vivo devuelve la nueva compilación (publish.sh imprimió LIVE), o el usuario eligió no publicar.

Nunca

• Inventes proyectos, métricas, empleadores o testimonios. Pregunta en su lugar.
• Subas, publiques o actives Pages sin el consentimiento del usuario.
• Añadas rastreadores, análisis, cookies o scripts externos. La página no hace solicitudes a terceros.
• Sobrescribas un sitio existente sin mostrar qué cambios se harán (publish.sh sin --yes es la simulación).