claude-code-arcane 2.2.0 → 2.4.0

package/skills/install-mcp/SKILL.md

@@ -1,45 +1,60 @@
 ---
 name: install-mcp
-description: "Instala y registra el MCP de Unity (CoplayDev MCP for Unity) en un proyecto Unity + Claude Code: agrega el package UPM, registra el server MCP y verifica la conexion. Usar para: instalar mcp unity, conectar Claude con Unity, setup MCP Unity."
+description: "Conecta Claude Code con el MCP del engine: Unity (package UPM CoplayDev) o Unreal (plugins del engine). Detecta, registra y verifica. Usar para: mcp unity, mcp unreal, setup MCP del editor."
 category: "gamedev"
-argument-hint: "[--secondary] [project-path]"
+argument-hint: "[unity | unreal] [--secondary] [project-path]"
 user-invocable: true
 allowed-tools: Read, Glob, Grep, Bash, Write, Edit
 ---
-# install-mcp — Unity MCP Setup
+# install-mcp — Engine MCP Setup
 
-Instala el package MCP del lado Unity y registra el server MCP en Claude Code, replicando el setup usado en los proyectos de tesis (TesisUade).
+Conecta Claude Code con el editor del engine via MCP. Los dos engines difieren en algo importante:
 
-- **Package primario:** `com.coplaydev.unity-mcp` (CoplayDev "MCP for Unity"). Server Python vía `uv`/`uvx`, transport HTTP en `127.0.0.1:8080`. El server se levanta y auto-configura desde Unity en `Window → MCP for Unity`.
-- **Package secundario (opcional, flag `--secondary`):** `com.gamelovers.mcp-unity` (CoderGamester). Server Node.
+| | Unity | Unreal |
+|---|---|---|
+| **De donde viene el MCP** | Package de terceros (CoplayDev) | **Plugins propios del engine** (`ModelContextProtocol` + `AllToolsets`) |
+| **Se suma algo al proyecto** | Si — package UPM en `Packages/manifest.json` | **No** — ya viene con el engine, solo se habilita |
+| **Que hace este skill** | Instalar + registrar + verificar | Habilitar + conectar + verificar |
 
-> El flujo de Unity (`Window → MCP for Unity`) requiere la GUI del Editor — Claude no puede manejarla. La skill automatiza lo que sí puede (editar `manifest.json`, registrar el cliente MCP, verificar) y **guía** el paso del Editor.
+> En Unreal **no hay nada que instalar**. El server y los toolsets son plugins del engine; el trabajo es habilitarlos en el `.uproject`, prender auto-start y generar el `.mcp.json`. No agregues packages ni plugins de terceros.
 
 ## Input
 
-- `project-path` (opcional): raíz del proyecto Unity. Default: directorio actual.
-- `--secondary` (opcional): además del primario, instala el package CoderGamester.
+- `unity` | `unreal` (opcional): fuerza el engine. Sin argumento, se autodetecta.
+- `project-path` (opcional): raiz del proyecto. Default: directorio actual.
+- `--secondary` (opcional, **solo Unity**): ademas del primario, instala el package CoderGamester.
 
 ---
 
-## Workflow
+## Phase 1: Detectar el engine
 
-### 1. Detectar proyecto Unity
+Desde `project-path` (o cwd), buscar marcadores:
 
-Desde `project-path` (o cwd), confirmar que existen:
-- `Packages/manifest.json`
-- `ProjectSettings/ProjectVersion.txt`
+| Marcador | Engine |
+|---|---|
+| `Packages/manifest.json` + `ProjectSettings/ProjectVersion.txt` | Unity |
+| `*.uproject` (o `GenerateProjectFiles.*` en un source tree) | Unreal |
 
-Si falta alguno, **abortar** con: "No parece un proyecto Unity (falta Packages/manifest.json o ProjectSettings/ProjectVersion.txt). Pasá la ruta del proyecto con `/install-mcp <project-path>`."
+- Si el argumento explicito contradice los marcadores, **avisar y preguntar** antes de seguir.
+- Si no hay marcadores, **abortar**: "No parece un proyecto Unity ni Unreal. Pasa la ruta con `/install-mcp [unity|unreal] <project-path>`."
+- Si aparecen ambos, preguntar cual.
 
-### 2. Verificar prerrequisitos
+Confirmar el engine detectado y la ruta antes de tocar archivos.
 
-- `uv --version` y `uvx --version` (server del primario). Si falta `uv`, **no abortar**: avisar y dar el comando de install y seguir editando el manifest:
-  - Windows: `winget install astral-sh.uv`
-  - alternativa: `pipx install uv`
-- Solo con `--secondary`: `node --version`. Si falta, avisar (el server CoderGamester no podrá correr).
+---
+
+## Phase 2A: Unity — instalar y registrar
+
+### 1. Verificar prerrequisitos
+
+`uv --version` y `uvx --version` (server del primario). Si falta `uv`, **no abortar**: avisar, dar el comando y seguir editando el manifest.
+
+- Windows: `winget install astral-sh.uv`
+- alternativa: `pipx install uv`
+
+Solo con `--secondary`: `node --version`. Si falta, avisar (el server CoderGamester no podra correr).
 
-### 3. Agregar el package UPM (lado Unity)
+### 2. Agregar el package UPM
 
 Leer `Packages/manifest.json`. Dentro de `"dependencies"`, agregar **solo si la key no existe** (idempotente — nunca duplicar):
 
@@ -47,61 +62,135 @@ Leer `Packages/manifest.json`. Dentro de `"dependencies"`, agregar **solo si la
 "com.coplaydev.unity-mcp": "https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main"
 ```
 
-Con `--secondary`, agregar también:
+Con `--secondary`, agregar tambien:
 
 ```json
 "com.gamelovers.mcp-unity": "https://github.com/CoderGamester/mcp-unity.git"
 ```
 
-Usar `Edit` puntual sobre el bloque `dependencies` preservando el JSON válido (indentación, comas). Si la key ya estaba, reportar "ya presente, sin cambios".
+Usar `Edit` puntual sobre el bloque `dependencies` preservando el JSON valido (indentacion, comas). Si la key ya estaba, reportar "ya presente, sin cambios".
 
-> **Antes de escribir**, mostrar el diff propuesto sobre `manifest.json` (y el `.mcp.json` del paso 4B si aplica) y pedir aprobación al usuario. No editar sin confirmación.
+> **Antes de escribir**, mostrar el diff propuesto sobre `manifest.json` (y el `.mcp.json` del paso 3B si aplica) y pedir aprobacion al usuario. No editar sin confirmacion.
 
-### 4. Registrar el server MCP en Claude Code
-
-Dos caminos, en orden de preferencia:
+### 3. Registrar el server en Claude Code
 
 **A. Recomendado (auto-config desde Unity).** Instruir al usuario:
-1. Abrir el proyecto en Unity (Unity importará el package nuevo).
+1. Abrir el proyecto en Unity (importara el package nuevo).
 2. `Window → MCP for Unity`.
-3. En esa ventana, usar el botón de auto-configuración para **Claude Code** — instala el server `uv` y registra el cliente MCP automáticamente.
+3. Usar el boton de auto-configuracion para **Claude Code** — instala el server `uv` y registra el cliente.
 
-**B. Fallback manual.** Si el usuario no puede usar el Editor ahora, registrar el transport HTTP que usa CoplayDev:
+**B. Fallback manual.** Registrar el transport HTTP de CoplayDev:
 
 ```bash
 claude mcp add --transport http unity-mcp http://127.0.0.1:8080
 ```
 
-(equivalente: escribir un `.mcp.json` de proyecto con
-`{"mcpServers":{"unity-mcp":{"type":"http","url":"http://127.0.0.1:8080"}}}`).
+> El server solo responde con Unity abierto y `MCP for Unity` activo. Registrar el cliente no levanta el server.
+
+---
+
+## Phase 2B: Unreal — habilitar y conectar
+
+Nada se instala. Tres pasos, en orden. **No edites el `.uproject` sin confirmar la ruta con el usuario.**
+
+### 1. Habilitar los plugins del engine en el `.uproject`
+
+Dos plugins, ambos requeridos. `ModelContextProtocol` es el server y el transport; `AllToolsets` provee las tools. Con solo `ModelContextProtocol` el server arranca pero **no expone ninguna tool**.
+
+En el array `Plugins` del `.uproject`, asegurar las dos entradas:
+
+```json
+{ "Name": "ModelContextProtocol", "Enabled": true },
+{ "Name": "AllToolsets", "Enabled": true }
+```
+
+Si el array no existe, crearlo. Si alguna entrada esta en `"Enabled": false`, pasarla a `true`. Mostrar el diff y pedir aprobacion antes de escribir.
+
+`AllToolsets` es un agregador editor-only con `EnabledByDefault` apagado, asi que hay que habilitarlo explicitamente. Para exponer solo un subconjunto, habilitar los plugins de toolset puntuales en lugar de `AllToolsets`.
+
+### 2. Prender auto-start
 
-> El server solo responde cuando Unity está abierto con `MCP for Unity` activo. Registrar el cliente no levanta el server.
+Por default el server queda detenido. Para arrancarlo a mano en una sesion: `ModelContextProtocol.StartServer` desde la consola del editor.
 
-### 5. Verificar
+Para que arranque en cada launch, agregar al config per-user del editor:
 
-Correr:
+`<Project>/Saved/Config/<Platform>Editor/EditorPerProjectUserSettings.ini`
+
+```ini
+[/Script/ModelContextProtocolEngine.ModelContextProtocolSettings]
+bAutoStartServer=True
+```
+
+Es per-user y no va a source control. Overrides opcionales si el default choca con otro servicio local:
+
+```ini
+ServerPortNumber=8000
+ServerUrlPath=/mcp
+```
+
+Alternativa por command line: `-ModelContextProtocolStartServer` (y `-ModelContextProtocolPort=<port>`). Preferir el `.ini` porque persiste.
+
+### 3. Generar el `.mcp.json`
+
+El editor no lo escribe solo.
+
+**Con el editor corriendo (preferido):** `ModelContextProtocol.GenerateClientConfig ClaudeCode` en la consola (o `All` para todos los clientes soportados). Re-correrlo mergea sobre el JSON existente, asi que es seguro despues de cambiar puerto o path.
+
+El destino depende del tipo de build:
+- **Source build** (el repo contiene `Engine/`): se escribe en la raiz del workspace, al lado de `Engine/` — **no** junto al `.uproject`.
+- **Installed/launcher build**: se escribe junto al `.uproject`.
+
+**Sin lanzar el editor**, escribir a mano en la ubicacion que corresponda:
+
+```json
+{
+  "mcpServers": {
+    "unreal-mcp": {
+      "type": "http",
+      "url": "http://127.0.0.1:8000/mcp"
+    }
+  }
+}
+```
+
+Ajustar la URL si se override el puerto o el path en el paso 2.
+
+---
+
+## Phase 3: Verificar
 
 ```bash
 claude mcp list
 ```
 
-Reportar si `unity-mcp` aparece **conectado**. Seguir la guía de TesisUade: **si NO está conectado, avisar explícitamente** y aclarar que las operaciones de engine (scenes, SOs, prefabs, UI wiring) NO se aplicaron — no asumir éxito.
+Reportar si el server aparece **conectado** (`unity-mcp` o `unreal-mcp` segun el engine). En Unreal, dos senales extra: el Output Log muestra mensajes de arranque del MCP, y `list_toolsets` responde.
 
-### 6. Resumen
+**Si NO esta conectado, avisar explicitamente** y aclarar que las operaciones de engine (scenes, assets, blueprints, prefabs, UI wiring) NO se aplicaron — no asumir exito.
+
+---
+
+## Phase 4: Resumen
 
 Reportar:
-- Qué keys se agregaron a `manifest.json` (o si ya estaban).
-- Estado del registro MCP (auto-config pendiente en Unity vs. fallback aplicado).
-- Resultado de `claude mcp list`.
-- Próximo paso manual: abrir Unity → `Window → MCP for Unity`.
+- Engine detectado y ruta del proyecto.
+- **Unity:** que keys se agregaron a `manifest.json` (o si ya estaban).
+- **Unreal:** que plugins se habilitaron en el `.uproject`, si se prendio auto-start, y donde quedo el `.mcp.json`.
+- Estado del registro y resultado de `claude mcp list`.
+- Proximo paso manual, si queda alguno.
 
 **Verdict:**
-- **READY** — package en `manifest.json` + cliente registrado + `unity-mcp` conectado en `claude mcp list`.
-- **PENDING** — package y cliente listos, pero falta abrir Unity (`Window → MCP for Unity`) para que el server conecte. Avisar que las operaciones de engine aún NO están disponibles.
-- **BLOCKED** — falta un prerrequisito (`uv` ausente) o no es un proyecto Unity válido. Indicar el fix.
+- **READY** — server registrado y conectado en `claude mcp list`.
+- **PENDING** — config lista, pero falta abrir el editor para que el server conecte (Unity: `Window → MCP for Unity`; Unreal: lanzar el editor con auto-start, o `ModelContextProtocol.StartServer`). Avisar que las operaciones de engine aun NO estan disponibles.
+- **BLOCKED** — falta un prerrequisito (`uv` ausente en Unity), el `.uproject` no se pudo editar, o no es un proyecto valido. Indicar el fix.
 
-Tras conectar, seguir con `/unity-game-architecture` o `/scaffold-unity` para trabajar el proyecto.
+## Next Steps
+
+- **Unity:** `/unity-game-architecture` o `/scaffold-unity` para trabajar el proyecto
+- **Unreal:** `/ue-project-context` primero (el resto de los `ue-*` lo leen), despues `/ue-cpp-foundations` o `/ue-blueprints`
+- Si el server no conecta, ver el troubleshooting de la referencia del engine que corresponda
 
 ---
 
-> → Read references/manual-setup.md for [pasos detallados del flujo Window → MCP for Unity, troubleshooting (uv no encontrado, puerto 8080 ocupado, MCP no conecta) y la variante secundaria CoderGamester]
+> → Read references/manual-setup.md for el flujo manual de Unity (`Window → MCP for Unity`), troubleshooting (uv no encontrado, puerto 8080 ocupado, MCP no conecta) y la variante secundaria CoderGamester
+
+> → Read references/unreal-operations.md for los console commands de Unreal (`StartServer`, `StopServer`, `RefreshTools`, `GenerateClientConfig`), el modo tool-search y la matriz de troubleshooting (puerto ocupado, toolset faltante, tool calls que cuelgan)

package/skills/install-mcp/references/unreal-operations.md

@@ -0,0 +1,55 @@
+# Unreal MCP — Console Commands, Settings, Recovery
+
+> Adapted from the `unreal-mcp` skill in [EpicGames/unreal-engine-skills-for-claude-code-plugin](https://github.com/EpicGames/unreal-engine-skills-for-claude-code-plugin) (MIT). References to the upstream `setup.md` were remapped to Phase 2B of this skill.
+
+Read this when something is misbehaving with the Unreal MCP server (tools missing, port collision, stale tool registry), or when you need a non-default configuration.
+
+Remember: the server and toolsets are **engine plugins**. Nothing here installs anything into the project — it enables, restarts and reconfigures what the engine already ships.
+
+## Console commands
+
+Run these from the Unreal Editor console (`~`).
+
+| Command | Use it for |
+|---------|------------|
+| `ModelContextProtocol.StartServer [port]` | Start the MCP server. Pass a port to override the default (e.g. when 8000 is in use). |
+| `ModelContextProtocol.StopServer` | Stop the server. Useful if the registry is in a bad state and you want a clean restart. |
+| `ModelContextProtocol.RefreshTools` | Re-register every toolset. Run this after enabling a new toolset plugin. |
+| `ModelContextProtocol.GenerateClientConfig <client>` | Regenerate the per-client config file. Args: `ClaudeCode`, `Cursor`, `VSCode`, `Gemini`, `Codex`, `All`. |
+
+Codex is the exception for config generation: it uses TOML and the writer refuses to overwrite an existing `.codex/config.toml`. Edit that one by hand if it already exists.
+
+## Tool-search mode
+
+`tools/list` has two modes, controlled by the `bEnableToolSearch` UPROPERTY on `UModelContextProtocolSettings` (default `true`):
+
+- **`True`** (default): `tools/list` returns only `list_toolsets`, `describe_toolset`, `call_tool`. Toolset tools are dispatched server-side through `call_tool` and stay out of the prompt; the catalog never changes mid-session, so the prompt cache stays warm.
+- **`False`**: every toolset tool is registered as a native MCP tool at startup, with schemas visible upfront.
+
+Override in the same `.ini` used for `bAutoStartServer` (see Phase 2B):
+
+```ini
+[/Script/ModelContextProtocolEngine.ModelContextProtocolSettings]
+bEnableToolSearch=False
+```
+
+## Troubleshooting matrix
+
+| Symptom | What to do |
+|---------|------------|
+| `unreal-mcp` not in `claude mcp list` / `/mcp`, or `list_toolsets` errors | The editor isn't running, or the server isn't started. Launch the editor and run `ModelContextProtocol.StartServer`, or enable `bAutoStartServer` per Phase 2B. Then check the Output Log for startup errors. |
+| Editor logs "Failed to listen on port" | Another process holds the default port. Change `ServerPortNumber` in the per-user `EditorPerProjectUserSettings.ini`, or pass `-ModelContextProtocolPort=<port>` on the next launch. Restart the editor, then re-run `ModelContextProtocol.GenerateClientConfig ClaudeCode` to refresh `.mcp.json`. |
+| A toolset you expect (e.g. `NiagaraTools`) is missing | Run `ModelContextProtocol.RefreshTools`. If still missing, that toolset's plugin may not be enabled in the `.uproject` — check there. Remember `AllToolsets` is the aggregator and is off by default. |
+| Tool calls hang or return errors | The editor may be busy compiling, loading a level, or in PIE. Wait and retry. For long compiles, prefer `LiveCodingToolset.CompileLiveCoding`, which returns when the compile actually finishes. |
+| `AIAssistantToolset.GetDockedContext` returns empty | The Claude Code tab must be docked inside an asset editor (Blueprint, Material, etc.) to provide docked context. Undocked, that tool has nothing to report. |
+| Sequential tool calls collide | Tool calls execute on the game thread. Don't issue them in parallel, even when they look independent. Serialize them. |
+
+## Safety notes when driving the editor
+
+These matter because every MCP call mutates live editor state on the game thread:
+
+- **Save before and after** any bulk change. MCP edits are not always undoable, especially across compilation boundaries.
+- **Wait for compilation** to finish before issuing further calls.
+- **Never parallelize** tool calls.
+- **Read every result.** Many tools return a status that flips between success and failure without raising. Treat anything that isn't an explicit success as a stop.
+- **Mind PIE.** Editor-only tools, asset creation in particular, behave differently while Play-in-Editor is active.

package/skills/interview-prep/SKILL.md

@@ -4,7 +4,7 @@ description: "Prepare for a job interview: company research, likely question ban
 argument-hint: "[application-note | company + role + round]"
 category: "career"
 user-invocable: true
-allowed-tools: Read, Glob, Grep, Write, Edit, WebFetch
+allowed-tools: Read, Glob, Grep, Write, Edit, WebFetch, Task
 ---
 
 # Interview Prep - Preparación de entrevista
@@ -57,13 +57,21 @@ Preparás al usuario para una entrevista concreta: research de la empresa, banco
 1. Leer aplicación + empresa + perfil. WebFetch del sitio/notas de la empresa.
 2. Crear nota en `06-Entrevistas/` con el template `Entrevista`.
 3. Llenar research, banco de preguntas (marcando las top), STAR de las 3-5 historias clave, preguntas a hacer, red flags.
-4. Ofrecer un **mock**: vos hacés de entrevistador y das feedback sobre las respuestas.
+4. Ofrecer un **mock** con el agente `mock-interviewer` (ver abajo).
 5. Post-entrevista: ayudar a registrar feedback y definir próximo paso / follow-up (con `/cold-outreach`).
 
+## El mock va en un agente, no en esta sesión
+
+El mock lo corre el agente `mock-interviewer`, no vos. La razón es dura: vos acabás de escribir las respuestas STAR del usuario, así que ibas a preguntar exactamente lo que preparó, iba a salir perfecto, y el usuario iba a entrar a la entrevista real con confianza falsa.
+
+Al lanzarlo, pasale **inline**: el JD, la ronda, y el CV que se mandó. **No** le pases el perfil maestro ni la nota de `06-Entrevistas/` con las respuestas preparadas - eso invalida el simulacro, y el agente tiene instrucción de rechazarlos.
+
+Cuando devuelve el feedback, tu trabajo es registrarlo: agregá en la nota de `06-Entrevistas/` qué respuestas hay que rehacer y por qué. Ese es el valor que queda para la próxima ronda.
+
 ## Idioma
 
 En el idioma de la entrevista. Preparar respuestas en inglés si el rol es internacional, aunque la prep se converse en español.
 
 ## Handoff
 
-Pedí aprobación (approval) antes de escribir la nota en `06-Entrevistas/`. Cuando la prep está READY, ofrecé un mock; post-entrevista, seguí con `/cold-outreach` para el follow-up.
+Pedí aprobación (approval) antes de escribir la nota en `06-Entrevistas/`. Cuando la prep está READY, ofrecé el mock con `mock-interviewer` y registrá su feedback; post-entrevista, seguí con `/cold-outreach` para el follow-up.

package/skills/job-aplicar/SKILL.md

@@ -54,7 +54,11 @@ Usar el skill **cover-letter** según el canal de aplicación (formulario ATS
 
 ## Paso 7 - Reviewer (regla drafter-reviewer, obligatorio)
 
-Seguir `.claude/rules/drafter-reviewer.md`: lanzar UN agente general-purpose de contexto fresco con el JD + borradores inline; lectura acotada al perfil; research web breve de la empresa. Aplicar la Parte A (reemplazos exactos) e incorporar lo relevante de la Parte B. Una sola ronda. Never stuff keywords: los gaps se reconocen en el cover, no se rellenan en el CV. Normalizar guiones largos del texto sugerido.
+Seguir `.claude/rules/drafter-reviewer.md`: lanzar el agente **`cv-reviewer`** de contexto fresco con el JD + borradores inline y el perfil usado. Aplicar la Parte A (reemplazos exactos) e incorporar lo relevante de la Parte B. Una sola ronda. Never stuff keywords: los gaps se reconocen en el cover, no se rellenan en el CV. Normalizar guiones largos del texto sugerido.
+
+**Segunda lente si el rol es senior o la postulación importa:** lanzar `hiring-manager` **en paralelo** con `cv-reviewer` (no en cadena). Contesta si el CV convence a quien contrata, que es una pregunta distinta a si pasa el filtro. Sus 3 preguntas van a `## Notas` de la nota: son material directo de `/interview-prep`.
+
+Si el directorio de agentes no está instalado, el fallback con `general-purpose` está en la regla.
 
 ## Paso 8 - CONFIRMACIÓN 2: aprobar CV final
 

package/skills/job-hunt/SKILL.md

@@ -67,6 +67,7 @@ Según el estado del workspace, recomendar el skill siguiente (ver routing).
 | Corrida de búsqueda con CLIs y dedup entre corridas | `/job-scrape` |
 | Postulación completa (nota + CV + cover + review + PDF) | `/job-aplicar` |
 | Registrar resultado/avance de una postulación | `/job-outcome` |
+| ¿Ya me postulé acá? / exportar el registro a CSV | `/career-registry` |
 | Gaps de skills agregados + plan de estudio | `/job-upskill` |
 | Adaptar CV a una oferta | `/cv-tailor` |
 | Exportar CV a PDF ATS | `/cv-ats-export` |
@@ -75,6 +76,22 @@ Según el estado del workspace, recomendar el skill siguiente (ver routing).
 | Optimizar perfil de LinkedIn | `/linkedin-optimize` |
 | Crear/actualizar portfolio web | `/portfolio-site` |
 | Preparar una entrevista | `/interview-prep` |
+| Diagnosticar por qué se frena la búsqueda | agente `career-strategist` (vía `/job-upskill`) |
+
+## Los 4 agentes del perfil
+
+El perfil instala `agents/career/`. Los agentes existen por una sola razón: **hay lecturas que solo sirven con contexto fresco**. Vos no podés revisar un CV que acabás de escribir, ni entrevistar a alguien cuyas respuestas preparadas leíste. Son read-only: devuelven análisis, los archivos los escribe la sesión principal.
+
+| Agente | Contesta | Lo lanza |
+|---|---|---|
+| `cv-reviewer` | ¿Pasa el filtro del ATS y del recruiter? | `/job-aplicar`, `/cv-tailor`, `/cover-letter` |
+| `hiring-manager` | ¿Convence a quien contrata? (evidencia de impacto, no keywords) | `/job-aplicar`, `/cv-tailor` (opcional) |
+| `mock-interviewer` | ¿Aguanta la entrevista real? | `/interview-prep` |
+| `career-strategist` | ¿Por qué me frenan siempre en la misma etapa? | `/job-upskill` (10+ aplicaciones resueltas) |
+
+`cv-reviewer` y `hiring-manager` se lanzan **en paralelo** cuando van los dos: son lentes independientes, encadenarlos solo suma latencia.
+
+Si el usuario instaló el perfil sin el directorio de agentes, la regla `drafter-reviewer` documenta el fallback con `general-purpose`.
 
 ## Workflow estándar para una nueva oportunidad
 

package/skills/job-outcome/SKILL.md

@@ -35,14 +35,28 @@ Empresa/oferta indicada: `$ARGUMENTS`
    - `rechazado` con feedback → anotar la lección en la nota; si se acumulan 3+ resoluciones, ofrecer `/job-upskill` y revisar los criterios de búsqueda contra los resultados reales.
    - `sin_respuesta` a los 10-14 días → ofrecer follow-up con `/cold-outreach`.
    - `contratado` → 🎉 y actualizar el resto de las aplicaciones abiertas (¿retirarse de procesos?).
+   - **Freelance** - `en_conversacion` → ofrecer ensayar con el agente `discovery-call`; `contrato_activo` → crear la nota en `08-Contratos/`; `sin_respuesta` o `rechazado` acumulados (10+ propuestas resueltas) → ofrecer `/freelance-pipeline`, que es donde se ve si el problema es la propuesta o el targeting.
 
 6. **Confirmar** al usuario qué se registró (nota, campos tocados, fila del dashboard).
 
 ## Vocabulario de `estado` (frontmatter)
 
+Depende del `tipo:` de la nota. Leelo primero: son dos pipelines distintos y confundirlos rompe el dashboard y los reportes.
+
+**`tipo: aplicacion` (empleo, perfil `+job-hunt`):**
+
 `interesado → aplicado → entrevista → oferta` y cierra en: `contratado | rechazado | sin_respuesta | declinada | descartado`
 
-Emojis del dashboard: ⬜ interesado · ✅ aplicado · 📅 entrevista/oferta · ❌ rechazado/sin_respuesta/declinada · 🚫 descartado/cerrada
+**`tipo: freelance` (propuestas, perfil `+freelance`):**
+
+`interesado → screeneado → propuesta_enviada → en_conversacion → contrato_activo → entregado` y cierra en: `ganado_cerrado | sin_respuesta | rechazado | descartado | disputa`
+
+En freelance hay dos registros extra que no existen en empleo, y sin ellos `/freelance-pipeline` no puede calcular nada:
+
+- Al marcar `propuesta_enviada`, preguntar y registrar **cuántos Connects costó** (frontmatter `connects_gastados`) y agregar la fila al ledger de `07-Recursos/Connects - <año>.md`.
+- Si la oferta se cerró sin que el cliente contratara a nadie, el resultado en el ledger es `oferta_nunca_contrato`, no `sin_respuesta`. Son cosas distintas: la primera es Connects perdidos por mal screening, la segunda es tu propuesta que no convenció.
+
+Emojis del dashboard: ⬜ interesado/screeneado · ✅ aplicado/propuesta_enviada · 📅 entrevista/oferta/en_conversacion · 🔨 contrato_activo/entregado · ❌ rechazado/sin_respuesta/declinada · 🚫 descartado/cerrada · ⚠️ disputa
 
 ## Reglas
 

package/skills/job-upskill/SKILL.md

@@ -4,7 +4,7 @@ description: "Aggregate skill gaps across all scored job applications, weigh the
 argument-hint: "[url | nota de aplicación]"
 category: "career"
 user-invocable: true
-allowed-tools: Read, Glob, Grep, Write, Bash, WebFetch, WebSearch
+allowed-tools: Read, Glob, Grep, Write, Bash, WebFetch, WebSearch, Task
 ---
 
 # /job-upskill - Análisis de gaps y plan de estudio
@@ -13,6 +13,14 @@ Detecta qué skills te están costando puntos de match en las ofertas reales y a
 
 Argumento: `$ARGUMENTS` (vacío = modo agregado; URL o nota = modo targeted)
 
+## Antes del plan: ¿el gap es real o de presentación?
+
+Este skill asume que la respuesta es estudiar. A veces no lo es: si la experiencia está en el perfil maestro pero no llega al CV, el plan de estudio manda al usuario a aprender meses lo que ya sabe.
+
+En **modo agregado con 10+ aplicaciones resueltas**, lanzar primero el agente `career-strategist` (contexto fresco, read-only). Diagnostica el embudo completo y separa gap real de gap de presentación. Si el punto de fuga no es la etapa técnica, decílo antes del heatmap: el plan de estudio no es la palanca y conviene ir a `/cv-tailor` o `/interview-prep`.
+
+Con menos de 10 resueltas, saltear: no hay volumen para un embudo y el propio agente lo va a rechazar. Seguí directo al modo agregado.
+
 ## Modo agregado (sin argumento)
 
 1. **Recolectar evidencia.** Grep de `match_score:` en `03-Aplicaciones/*.md` (excluir `_index`; aceptar también el campo legacy `score:` de notas viejas). De cada nota leer: `match_score`, `estado`, `perfil`, y los gaps mencionados en las secciones "Match con mi perfil" / "Gaps reales" y los gaps reconocidos en `## Notas`.
@@ -55,4 +63,4 @@ Argumento: `$ARGUMENTS` (vacío = modo agregado; URL o nota = modo targeted)
 
 ## Handoff
 
-Reporte COMPLETE en `07-Recursos/`. Retomar el pipeline con `/job-aplicar` en las ofertas abiertas, o `/job-scrape` para una corrida nueva apuntando a los gaps que ya se están cerrando.
+Reporte COMPLETE en `07-Recursos/`. Retomar el pipeline con `/job-aplicar` en las ofertas abiertas, o `/job-scrape` para una corrida nueva apuntando a los gaps que ya se están cerrando. Si el `career-strategist` ubicó la fuga fuera de la etapa técnica, el siguiente paso es ese (`/cv-tailor`, `/interview-prep` o `/job-search`), no el plan de estudio.