Guía rápida

Esta guía te lleva de cero a tu primera oferta evaluada en unos quince minutos la primera vez. Configurarás el espacio de trabajo, abrirás tu asistente de programación con IA y pegarás una oferta de empleo. El agente completa el onboarding que haga falta y después te devuelve un informe completo, una nota y un PDF de CV adaptado.

Lo que necesitas

No necesitas saber programar. Solo necesitas sentirte cómodo abriendo una terminal y ejecutando un comando.

Paso 1: Configura el espacio de trabajo

Abre una terminal en la carpeta donde quieras que viva career-ops. La ruta recomendada usa un solo comando; debajo hay una ruta avanzada con git clone. Si te faltan Node (22.13+, o 23.4+ en Node 23) o Git, npx se negará a ejecutarse — instala ambos primero (ver prerrequisitos arriba).

Recomendado — un solo comando

npx @santifer/career-ops init

Esto clona la última versión en ./career-ops, instala las dependencias y crea la estructura del espacio de trabajo. También detecta qué CLI de IA tienes instalado y te dice con qué comando empezar. Solo instala en una carpeta nueva: si ./career-ops ya existe y no está vacía, el comando se detiene con un error y no cambia nada, así que ejecutarlo de nuevo no repara ni actualiza un espacio de trabajo existente.

Entra en el espacio de trabajo cuando termine:

cd career-ops

git clone https://github.com/career-ops-hq/career-ops.git
cd career-ops
npm install

Navegador headless (una vez)

career-ops usa un Chromium headless para varias tareas: renderizar PDFs, comprobar si las ofertas siguen activas y ejecutar escaneos ATS completos. El instalador lo configura automáticamente tras las dependencias; si ese paso falló en tu máquina, instálalo manualmente:

npx playwright install chromium

npm install se salta esa descarga cuando PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD está definida en tu entorno con cualquier valor que no sea vacío, 0 o false; en ese caso, ejecuta tú mismo el comando de arriba. En NixOS, sáltate este paso: los navegadores descargados no pueden arrancar ahí, y en su lugar el dev shell del flake del repositorio proporciona navegadores que sí funcionan, como explica la guía de NixOS del core.

Paso 2: Abre tu asistente de IA

Desde dentro de la carpeta career-ops, lanza el CLI de programación con IA que instalaste.

claude

codex

opencode

qwen

copilot

agy

pi

Paso 3: Ejecuta tu primera evaluación

Copia la URL de cualquier anuncio de empleo y pégala en el chat. Si tu perfil aún no está listo, el agente completará primero el onboarding. Con Claude Code, Antigravity CLI o Pi, ponle delante el comando explícito; con los demás CLIs, pega la URL y pídele al agente que ejecute el auto-pipeline:

/career-ops auto-pipeline https://jobs.example.com/senior-engineer-ai

Ejecuta el comando auto-pipeline con la URL de la vacante: https://jobs.example.com/senior-engineer-ai

Ejecuta el comando auto-pipeline con la URL de la vacante: https://jobs.example.com/senior-engineer-ai

Ejecuta el comando auto-pipeline con la URL de la vacante: https://jobs.example.com/senior-engineer-ai

Ejecuta el comando auto-pipeline con la URL de la vacante: https://jobs.example.com/senior-engineer-ai

/career-ops https://jobs.example.com/senior-engineer-ai

/skill:career-ops auto-pipeline https://jobs.example.com/senior-engineer-ai

Si no tienes una URL, pega el texto completo de la descripción de la oferta en el chat. El agente detecta cualquiera de las dos entradas como una oferta y ejecuta el pipeline completo automáticamente — esto es el auto-pipeline.

Qué pasa después

Después de pegar la oferta, career-ops hace lo siguiente por su cuenta:

El proceso completo dura uno o dos minutos. Cuando termina, career-ops te muestra la nota y un resumen del informe.

Cómo leer tus resultados

El informe incluye Score Evidence después de Risk Summary. Abarca cinco dimensiones: ajuste del CV, alineación con North Star, remuneración, señales culturales y señales de alerta. Cada fila recoge un estado de evidencia (supported, partial o unknown), una fuente u observación concreta y una pregunta pendiente. La sección termina con un nivel de confianza en la evidencia (High, Medium o Low), su motivo y hasta tres prioridades de verificación.

Abre el archivo de informe en reports/. El nombre sigue el patrón {número}-{empresa}-{fecha}.md. Dentro encontrarás:

• Nota — un número del 1 al 5. Por debajo de 4.0 significa que el puesto probablemente no encaja bien.
• Block A — un resumen del puesto en lenguaje sencillo.
• Block B — una tabla que muestra cómo encaja tu CV con cada requisito de la oferta, más las carencias.
• Block C — una recomendación estratégica de cómo posicionarte para este puesto.
• Block D — investigación de compensación que compara la oferta con las tarifas de mercado.
• Block E — notas de personalización para tu candidatura.
• Block F — preparación de entrevista con historias STAR adaptadas a esta oferta.
• Block G — legitimidad del anuncio: una comprobación heurística de señales como si la oferta sigue abierta o si se vuelve a publicar una y otra vez. Informa de lo que encuentra y deja el juicio en tus manos.
• Block H — borradores de respuesta para el formulario de candidatura, solo cuando la puntuación es 4.5 o más.

Justo después del Block G, el Verdict da la decisión en negrita (Apply, Consider, Research first o Skip) y un motivo sacado de los bloques anteriores, para que sepas la respuesta antes de leer el resto.

Tu PDF de CV adaptado está en la carpeta output/. Revísalo antes de enviarlo a ningún sitio — career-ops nunca envía nada sin tu aprobación.

Qué hacer a continuación

Ahora que tu primera evaluación está hecha, aquí tienes algunas cosas que puedes explorar:

• Afina tu perfil. Cuéntale al agente algo nuevo sobre ti — «Aquí tienes más contexto: acabo de lanzar X.» Actualiza el perfil y las evaluaciones futuras se vuelven más precisas.
• Evalúa más ofertas. Pega más URLs o descripciones. Cada una se suma a tu tracker.
• Escanea portales de empleo. Escribe /career-ops scan para buscar en decenas de páginas de empleo de empresas preconfiguradas a la vez.
• Compara ofertas. Si tienes varios informes, escribe /career-ops ofertas para obtener una comparación ordenada.

Resolución de problemas

¿Has encontrado un fallo o tienes una pregunta?

Si algo no funciona como dice esta guía, por favor repórtalo. Los reportes de fallos ayudan a todos los que vengan después de ti.

• Reportar un fallo: Abre un issue en el repositorio de GitHub. Describe qué esperabas que pasara, qué pasó en realidad y pega cualquier mensaje de error que vieras.
• Hacer una pregunta: Únete a la comunidad de Discord. Es la forma más rápida de obtener ayuda de otros usuarios y del autor.
• Contribuir un arreglo: Si sabes cómo arreglar el problema tú mismo, lee CONTRIBUTING.md antes de abrir un pull request. La versión corta: abre primero un issue para una nueva funcionalidad, un nuevo modo o comando, o un cambio de arquitectura. Las correcciones de bugs, los nuevos proveedores del escáner que no requieren autenticación, la documentación y las traducciones pueden ir directamente a un pull request.