claude-code-arcane 2.2.0 → 2.4.0

package/CHANGELOG.md

@@ -1,3 +1,40 @@
+# [2.4.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.3.0...v2.4.0) (2026-08-13)
+
+
+### Bug Fixes
+
+* **agents:** add the three ue-* sub-specialists unreal-specialist delegates to ([9b52708](https://github.com/SebastianLuser/claude-code-arcane/commit/9b527081c9d7166a96a299c2658a1b0adfb4db58))
+
+
+### Features
+
+* **hooks:** detect Unreal projects on session start ([dfb66ae](https://github.com/SebastianLuser/claude-code-arcane/commit/dfb66ae6b70f40dda226f18027aefe574005a5d8))
+* **install-mcp:** handle Unreal's engine-provided MCP alongside Unity ([96fe518](https://github.com/SebastianLuser/claude-code-arcane/commit/96fe51817015d69d31aebc84088c774c9a55dd0b))
+* **unreal:** add the unreal-dev profile with 29 ue-* skills ([011a3f1](https://github.com/SebastianLuser/claude-code-arcane/commit/011a3f1992f1ac515acf9595cfc568f2824a6d21))
+* **unreal:** add ue-naming-conventions from the Gamemakin style guide ([301880e](https://github.com/SebastianLuser/claude-code-arcane/commit/301880e25c8ebd71987e96387fbf74650d313574))
+
+# [2.3.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.2.0...v2.3.0) (2026-08-12)
+
+
+### Bug Fixes
+
+* **cli:** stop update and remove from reporting work they never did ([4473090](https://github.com/SebastianLuser/claude-code-arcane/commit/44730906cd0f62e349841bc728a09105498d9825))
+* **docs:** name the published package in every install instruction ([2cc21ec](https://github.com/SebastianLuser/claude-code-arcane/commit/2cc21ecbc0bb949715857d6594426f47fd17be72))
+* **freelance-kickoff:** repair a word split in the acceptance criteria step ([cd5140d](https://github.com/SebastianLuser/claude-code-arcane/commit/cd5140d3d23809d69b14cb1916b2c6b58f8074d5))
+* **freelance-scan:** filter by relevance, GetOnBrd search only ranks ([8f2a088](https://github.com/SebastianLuser/claude-code-arcane/commit/8f2a0887d134f15e0490e106a8248f741a6d5c84))
+* **freelance-scan:** split search terms on commas, not only spaces ([03eaf18](https://github.com/SebastianLuser/claude-code-arcane/commit/03eaf18b9de6d876f9a41c11c940a9df0d9c8d69))
+* **freelance:** source projects from public keyless APIs, not a per-user key ([6cb1c73](https://github.com/SebastianLuser/claude-code-arcane/commit/6cb1c738a55f0ca83501fd38421746d750ff02e4))
+
+
+### Features
+
+* **career:** add /career-registry for traceability across job hunt and freelance ([0dfe091](https://github.com/SebastianLuser/claude-code-arcane/commit/0dfe0914be20c14c8f04ebb482c4ce75e305e873))
+* **freelance-scan:** expand category searches into the words clients write ([6ef3a93](https://github.com/SebastianLuser/claude-code-arcane/commit/6ef3a932d9345e6cbb0d48fe9b81421d6f368c3f))
+* **freelance-scan:** reach the marketplaces through WebSearch, and open the door for API keys ([84a46f3](https://github.com/SebastianLuser/claude-code-arcane/commit/84a46f33b1828387ef2c125d15087835335dbfce))
+* **freelance:** add +freelance profile for Upwork project hunting ([6612336](https://github.com/SebastianLuser/claude-code-arcane/commit/66123369545fcba3853a855eb9ff500c6b462e5e))
+* **freelance:** close the loop from won contract to delivered work ([01dd077](https://github.com/SebastianLuser/claude-code-arcane/commit/01dd0774aed710b4f339dab6f58de97d647d9f87))
+* **job-hunt:** add 4 fresh-context career agents ([97ecfa8](https://github.com/SebastianLuser/claude-code-arcane/commit/97ecfa8139158c5cf159615381d74d0973b81211))
+
 # [2.2.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.1.0...v2.2.0) (2026-08-08)
 
 

package/README.md

@@ -1,6 +1,6 @@
 # Claude Code Arcane
 
-> **388 skills, 98 agents, 16 hooks and 26 rules for Claude Code — selective deploy by profile.**
+> **427 skills, 109 agents, 17 hooks and 28 rules for Claude Code — selective deploy by profile.**
 
 A configuration harness installable via `npx`. Pick a **profile** that matches your stack and only the relevant tools get installed into your project's `.claude/` directory.
 
@@ -13,7 +13,7 @@ A configuration harness installable via `npx`. Pick a **profile** that matches y
 cd ~/projects/my-app
 
 # Install a profile (no clone needed)
-npx arcane install backend-ts+agile
+npx claude-code-arcane install backend-ts+agile
 
 # Open Claude Code
 claude
@@ -44,7 +44,7 @@ permissions:
 ### 2. Combine profiles with `+`
 
 ```bash
-npx arcane install backend-ts+agile+testing
+npx claude-code-arcane install backend-ts+agile+testing
 #                  ^^^^^^^^^^  ^^^^^  ^^^^^^^
 #                  base        addon  addon
 ```
@@ -82,27 +82,27 @@ my-project/.claude/
 ### Install a profile
 
 ```bash
-npx arcane install backend-ts+agile     # Install profile combination
-npx arcane install                       # Show available profiles (interactive)
-npx arcane install unity-dev --dry-run   # Preview without installing
+npx claude-code-arcane install backend-ts+agile     # Install profile combination
+npx claude-code-arcane install                       # Show available profiles (interactive)
+npx claude-code-arcane install unity-dev --dry-run   # Preview without installing
 ```
 
 ### Add skills or profiles to an existing installation
 
 ```bash
-npx arcane add api-design                # Add a single skill
-npx arcane add security-audit owasp      # Add multiple skills
-npx arcane add +security                 # Add an entire profile as addon
-npx arcane add +database +testing        # Add multiple profiles
+npx claude-code-arcane add api-design                # Add a single skill
+npx claude-code-arcane add security-audit owasp      # Add multiple skills
+npx claude-code-arcane add +security                 # Add an entire profile as addon
+npx claude-code-arcane add +database +testing        # Add multiple profiles
 ```
 
 ### Remove skills, profiles, or agents
 
 ```bash
-npx arcane remove api-design             # Remove a single skill
-npx arcane remove slack postman          # Remove multiple skills
-npx arcane remove +agile                 # Remove entire profile (skills + agents + rules)
-npx arcane remove +testing api-design    # Mix: remove a profile and a skill
+npx claude-code-arcane remove api-design             # Remove a single skill
+npx claude-code-arcane remove slack postman          # Remove multiple skills
+npx claude-code-arcane remove +agile                 # Remove entire profile (skills + agents + rules)
+npx claude-code-arcane remove +testing api-design    # Mix: remove a profile and a skill
 ```
 
 When removing a profile, Arcane only deletes assets **exclusive** to that profile. Skills, agents, and rules shared with other active profiles are preserved.
@@ -112,9 +112,9 @@ Core skills (21) and the core profile cannot be removed.
 ### Global hooks (worktree-isolation auto-apply)
 
 ```bash
-npx arcane global                        # Install global SessionStart hook
-npx arcane global --status               # Show global hooks status
-npx arcane global --remove               # Remove global hooks
+npx claude-code-arcane global                        # Install global SessionStart hook
+npx claude-code-arcane global --status               # Show global hooks status
+npx claude-code-arcane global --remove               # Remove global hooks
 ```
 
 Installs worktree-isolation scripts into `~/.claude/scripts/` and adds a `SessionStart` hook to `~/.claude/settings.json` that auto-applies isolation on every new Claude Code session.
@@ -122,10 +122,10 @@ Installs worktree-isolation scripts into `~/.claude/scripts/` and adds a `Sessio
 ### Other commands
 
 ```bash
-npx arcane list                          # List all profiles and skills
-npx arcane status                        # Show current installation
-npx arcane update                        # Check for updates
-npx arcane clean --force                 # Remove Arcane entirely from project
+npx claude-code-arcane list                          # List all profiles and skills
+npx claude-code-arcane status                        # Show current installation
+npx claude-code-arcane update                        # Check for updates
+npx claude-code-arcane clean --force                 # Remove Arcane entirely from project
 ```
 
 ---
@@ -163,6 +163,7 @@ Once installed, manage the installation from within a Claude Code session:
 |---------|-------|--------|--------|
 | `unity-dev` | Unity programmer — C#, architecture, performance, builds | 25 | game |
 | `unity-design` | Game designer — GDDs, balance, art bible, playtesting | 17 | game |
+| `unreal-dev` | Unreal Engine 5 programmer — C++, Blueprints, GAS, replication, rendering, packaging | 49 | game |
 | `audio` | Game audio — direction, composition, sound design, middleware, VO, QA | 13 | audio |
 | `backend-ts` | Backend TypeScript — Fastify, Prisma, Zod, API design | 33 | engineering |
 | `backend-go` | Backend Go — Clean Arch, DB, auth, API, CI | 19 | engineering |
@@ -193,7 +194,8 @@ Once installed, manage the installation from within a Claude Code session:
 | `+finance` | Investment analysis, financial modeling, SaaS metrics | 3 | business |
 | `+marketing` | Content, growth, SEO/CRO, strategy, analytics | 44 | marketing |
 | `+regulatory` | ISO 13485, GDPR, FDA, SOC 2, ISMS, QMS, MDR | 13 | regulatory |
-| `+job-hunt` | Job search end-to-end — master profile, ATS CV with verification, job scraping with dedup, LinkedIn, portfolio, cover letters, outreach, interview prep | 16 | — |
+| `+job-hunt` | Job search end-to-end — master profile, ATS CV with verification, job scraping with dedup, LinkedIn, portfolio, cover letters, outreach, interview prep, registry/CSV traceability, fresh-context review agents | 17 | career |
+| `+freelance` | Freelance projects — keyless public-source scanning with dedup, market rate intel, client risk screening, proposals priced above your net floor rate, contracts/SOWs, registry/CSV traceability, kickoff scope validation, delivery and change orders, acquisition-cost pipeline | 15 | freelance |
 | `+ecommerce` | Commerce end-to-end agnóstico de lenguaje — data model, checkout, inventario, órdenes, pagos, promociones, shipping/tax, listings, analytics, feeds, storefront, suscripciones | 12 | ecommerce |
 | `+second-brain` | Second brain en Obsidian — captura sin fricción, reviews diario/semanal/mensual, notas atómicas y hub files (PARA + Zettelkasten), búsqueda con ranking, caché de contexto entre sesiones, auditoría de salud del vault, sintaxis nativa (markdown, Bases, Canvas) | 14 | — |
 | `+self-improving` | Agent self-improvement and skill extraction | 2 | — |
@@ -205,41 +207,77 @@ Once installed, manage the installation from within a Claude Code session:
 
 ---
 
+## Recommended MCPs
+
+Several profiles ship skills that drive an external tool over MCP. **Arcane does not bundle any
+MCP server** — install the ones your stack needs and Claude Code connects to them.
+
+### Game engines
+
+| Engine | MCP server | Where it comes from | Wire it up with |
+|--------|------------|---------------------|-----------------|
+| **Unreal Engine 5** | `ModelContextProtocol` + `AllToolsets` | **Ships with the engine** — nothing to add to the project, just enable the plugins in the `.uproject` | `/install-mcp unreal` |
+| **Unity** | [CoplayDev — MCP for Unity](https://github.com/CoplayDev/unity-mcp) | UPM package added to `Packages/manifest.json` | `/install-mcp unity` |
+| **Unity** (alternative) | [CoderGamester — mcp-unity](https://github.com/CoderGamester/mcp-unity) | UPM package, opt-in | `/install-mcp unity --secondary` |
+
+Both engines need the editor **open and running** for the server to answer — registering the
+client does not start the server.
+
+For Unreal, Epic also publishes a companion plugin:
+[unreal-engine-skills-for-claude-code-plugin](https://github.com/EpicGames/unreal-engine-skills-for-claude-code-plugin).
+It ships the in-editor skills that operate and extend the MCP (`unreal-mcp`, `create-toolset`,
+`unreal-skill`), which Arcane deliberately does **not** duplicate — see `ATTRIBUTION.md`.
+
+### Other integrations
+
+| MCP server | Used by | Profile |
+|------------|---------|---------|
+| ClickUp | `/clickup` | `+clickup` |
+| Figma | `/figma`, `/figma-to-code`, `/figma-tokens` | `+design` |
+| Atlassian (Confluence) | `/confluence-expert`, `/atlassian-templates` | `+agile` |
+| TestRail + BrowserStack | `/playwright-pro` (ships its own `.mcp.json`) | `+testing` |
+
+`/jira-tickets` is the exception: it talks to the Jira REST API v3 over `curl`, not MCP.
+
+Building your own server? `/mcp-server-builder` scaffolds one.
+
+---
+
 ## Examples by Project
 
 ```bash
 # Unity dev only
-npx arcane install unity-dev
+npx claude-code-arcane install unity-dev
 
 # Unity with team and management
-npx arcane install unity-dev+unity-design+agile+clickup
+npx claude-code-arcane install unity-dev+unity-design+agile+clickup
 
 # Go microservice with infra
-npx arcane install backend-go+infra+agile+jira
+npx claude-code-arcane install backend-go+infra+agile+jira
 
 # Full-stack monorepo
-npx arcane install backend-ts+frontend+testing+database
+npx claude-code-arcane install backend-ts+frontend+testing+database
 
 # Mobile app with CI/CD
-npx arcane install mobile+agile+clickup+testing
+npx claude-code-arcane install mobile+agile+clickup+testing
 
 # Secure backend with docs
-npx arcane install backend-ts+security+docs+database
+npx claude-code-arcane install backend-ts+security+docs+database
 
 # AI/ML project with data pipelines
-npx arcane install backend-go+ai+infra
+npx claude-code-arcane install backend-go+ai+infra
 
 # SaaS with full marketing stack
-npx arcane install backend-ts+marketing+business+finance
+npx claude-code-arcane install backend-ts+marketing+business+finance
 
 # Regulated medical device
-npx arcane install backend-ts+regulatory+security+testing
+npx claude-code-arcane install backend-ts+regulatory+security+testing
 
 # Founder advisory setup
-npx arcane install clevel+business+finance+marketing
+npx claude-code-arcane install clevel+business+finance+marketing
 
 # With status bar
-npx arcane install backend-ts+agile+statusline
+npx claude-code-arcane install backend-ts+agile+statusline
 ```
 
 ---
@@ -248,26 +286,26 @@ npx arcane install backend-ts+agile+statusline
 
 ```bash
 # Start with a base profile
-npx arcane install backend-ts
+npx claude-code-arcane install backend-ts
 
 # Later, add testing and security
-npx arcane add +testing +security
+npx claude-code-arcane add +testing +security
 
 # Add a specific skill you need
-npx arcane add docker-setup
+npx claude-code-arcane add docker-setup
 
 # Realize you don't need testing anymore
-npx arcane remove +testing
+npx claude-code-arcane remove +testing
 
 # Remove a specific skill
-npx arcane remove docker-setup
+npx claude-code-arcane remove docker-setup
 
 # Check what you have now
-npx arcane status
+npx claude-code-arcane status
 
 # Start over
-npx arcane clean --force
-npx arcane install backend-ts+agile
+npx claude-code-arcane clean --force
+npx claude-code-arcane install backend-ts+agile
 ```
 
 ---
@@ -280,24 +318,24 @@ Work on multiple features in parallel using git worktrees, each with its own Arc
 
 ```bash
 # Create worktree + install Arcane in one step
-npx arcane worktree feat/new-api --profile backend-ts+agile
+npx claude-code-arcane worktree feat/new-api --profile backend-ts+agile
 
 # Inherits profile from current installation
-npx arcane worktree feat/new-api
+npx claude-code-arcane worktree feat/new-api
 
 # With dependency install and Docker port isolation
-npx arcane worktree feat/new-api --install-deps --isolate
+npx claude-code-arcane worktree feat/new-api --install-deps --isolate
 
 # Custom path and base branch
-npx arcane worktree feat/new-api --path ../my-api-worktree --base develop
+npx claude-code-arcane worktree feat/new-api --path ../my-api-worktree --base develop
 
 # Preview without creating
-npx arcane worktree feat/new-api --dry-run
+npx claude-code-arcane worktree feat/new-api --dry-run
 ```
 
 ### Worktree-aware installation
 
-When you run `npx arcane install` inside a git worktree, Arcane automatically:
+When you run `npx claude-code-arcane install` inside a git worktree, Arcane automatically:
 - Detects it's in a worktree
 - Finds the main worktree's Arcane installation
 - **Shares** hooks/ and docs/ via symlink (read-only, identical across worktrees)
@@ -305,10 +343,10 @@ When you run `npx arcane install` inside a git worktree, Arcane automatically:
 
 ```bash
 # Manual: share from a specific installation
-npx arcane install backend-ts --share-from /path/to/main/worktree
+npx claude-code-arcane install backend-ts --share-from /path/to/main/worktree
 
 # Disable sharing
-npx arcane worktree feat/api --no-share
+npx claude-code-arcane worktree feat/api --no-share
 ```
 
 ### What gets shared vs independent
@@ -326,7 +364,7 @@ npx arcane worktree feat/api --no-share
 ### Status shows worktree info
 
 ```bash
-npx arcane status
+npx claude-code-arcane status
 # === Arcane Status ===
 #   Profiles:  backend-ts + agile
 #   Worktree:  yes (main: /path/to/main/checkout)
@@ -350,11 +388,11 @@ claude-code-arcane/
 │   ├── manifest.ts            # Read/write arcane-manifest.json
 │   ├── types.ts               # TypeScript interfaces
 │   └── utils.ts               # Cross-platform helpers
-├── skills/                    # 388 skills (flat, one dir per skill)
-├── profiles/                  # 36 profiles (YAML)
-├── agents/                    # 13 dirs, 86+ agents (Markdown)
-├── hooks/                     # 15 lifecycle hooks (Bash)
-├── rules/                     # 26 rules (Markdown)
+├── skills/                    # 427 skills (flat, one dir per skill)
+├── profiles/                  # 38 profiles (YAML)
+├── agents/                    # 17 dirs, 109 agents (Markdown)
+├── hooks/                     # 17 lifecycle hooks (Bash)
+├── rules/                     # 28 rules (Markdown)
 ├── templates/                 # Gamedev templates
 ├── docs/                      # Documentation
 └── skills-selftest/           # QA framework
@@ -375,3 +413,14 @@ claude-code-arcane/
 - **OS:** Windows 10/11, macOS, Linux
 - **Node:** 20+
 - **Claude Code:** v1.0+
+
+---
+
+## Attribution
+
+Arcane is MIT licensed (see `LICENSE`). The `ue-*` skills shipped by the `unreal-dev` profile
+are derived from three upstream collections — [quodsoler/unreal-engine-skills](https://github.com/quodsoler/unreal-engine-skills)
+(MIT), [EpicGames/unreal-engine-skills-for-claude-code-plugin](https://github.com/EpicGames/unreal-engine-skills-for-claude-code-plugin)
+(MIT), and [gamedev-skills/awesome-gamedev-agent-skills](https://github.com/gamedev-skills/awesome-gamedev-agent-skills)
+(Apache-2.0). See `ATTRIBUTION.md` for the per-skill provenance, the changes made, and the
+required license notices.

package/agents/career/career-strategist.md

@@ -0,0 +1,88 @@
+---
+name: career-strategist
+description: "Diagnostica el embudo completo de la busqueda, no una postulacion: calcula tasas de conversion por etapa, ubica donde se pierde el candidato y propone UN cambio de estrategia (targeting, perfil, seniority o upskill). Exige volumen minimo antes de afirmar patrones. Read-only."
+tools: Read, Glob, Grep, WebSearch
+model: opus
+maxTurns: 20
+memory: user
+disallowedTools: Bash, Write, Edit
+skills: [job-outcome, job-upskill, job-search, master-profile]
+---
+
+Sos el **Career Strategist**. Mirás la búsqueda entera, no una oferta. Tu unidad de análisis es el **embudo**: 30 postulaciones y sus resultados, no el CV de mañana.
+
+Sos read-only. Diagnosticás y recomendás; los cambios los aplica la main session con los skills correspondientes.
+
+## Por qué existís
+
+Los demás skills del perfil optimizan la próxima aplicación. Ninguno contesta la pregunta que importa después de 20 rechazos: **¿por qué siempre me frenan en la misma etapa?**
+
+`/job-outcome` registra datos y tiene prohibido interpretarlos. La interpretación es tuya.
+
+## Qué leés
+
+Del career workspace:
+
+- `03-Aplicaciones/` - todas las notas: frontmatter (`estado`, `empresa`, `match_score` o `score`, fechas) y las secciones `## Timeline / seguimiento`, `## Entrevistas` y `## Notas` (ahí está el feedback textual recibido).
+- `00-Dashboard.md` - para cruzar y detectar notas que quedaron fuera de sincronía.
+- `01-Perfiles/` - el perfil maestro y los derivados, para juzgar si el problema es el material o su presentación.
+- `06-Entrevistas/` - patrones de qué preguntas se repiten y en cuáles se cae.
+
+Research web solo para calibrar mercado: bandas salariales, qué se pide hoy para ese seniority, si el rol que busca existe en su región/modalidad.
+
+## El guard de volumen (obligatorio, primero)
+
+Antes de afirmar cualquier patrón, contá.
+
+- **Menos de 10 aplicaciones resueltas:** no hay embudo. Decílo explícitamente, entregá solo lo descriptivo (cuántas, en qué estado, cuánto tardan en responder) y nombrá la hipótesis más barata de testear. Nada de patrones.
+- **10 a 25:** hablás de tendencias, con la muestra a la vista en cada afirmación.
+- **25+:** hablás de tasas de conversión.
+
+Nunca conviertas 2 rechazos en una teoría sobre la carrera de alguien. Es el error más fácil y el más caro: manda al usuario a arreglar lo que no estaba roto.
+
+## El embudo
+
+```
+interesado → aplicado → entrevista → oferta → contratado
+```
+
+Calculá el pase de cada etapa y comparalo con lo esperable:
+
+| Transición | Referencia sana | Si está muy abajo, la hipótesis es |
+|---|---|---|
+| aplicado → entrevista | 10-20% | CV/ATS, o targeting: aplicás a roles donde no calificás |
+| entrevista → siguiente ronda | ~50% | Storytelling: los logros no se cuentan como impacto |
+| técnica → siguiente | ~50% | Gap real de skill → `/job-upskill` |
+| oferta → contratado | alto | Negociación o banda salarial mal targeteada |
+
+Mirá también lo que no es una transición:
+
+- **`sin_respuesta` masivo** (>60%): casi nunca es el CV. Suele ser volumen de canal equivocado o aplicar tarde a ofertas viejas.
+- **`descartado` alto** (el usuario pierde interés): los criterios de búsqueda están mal definidos, se está gastando esfuerzo antes de filtrar.
+- **`declinada`**: si declina por comp, el targeting de banda está mal desde `/job-search`.
+- **`match_score` alto con rechazo temprano**: el scoring está inflado y no predice nada. Eso es un bug del proceso, no del candidato.
+- **Tiempo muerto**: aplicaciones abiertas sin movimiento hace 3+ semanas. Son ruido en el embudo.
+
+## Output
+
+1. **Foto del embudo** - números absolutos y tasas, con la muestra explícita ("4 de 31"). Si no alcanza el volumen, decilo acá.
+2. **El punto de fuga** - UNO. La etapa donde se pierde más valor. Con la evidencia que lo sostiene, incluyendo citas del feedback real recibido.
+3. **Hipótesis** - 2 o 3 explicaciones posibles de esa fuga, ordenadas por probabilidad, y para cada una **cómo se testea**. Una hipótesis que no se puede testear en 2 semanas no sirve.
+4. **UN cambio recomendado** - la palanca con mejor relación impacto/esfuerzo, y a qué skill se lo pasás (`/job-search` para criterios, `/master-profile` para el perfil, `/cv-tailor` para presentación, `/job-upskill` para gap real, `/interview-prep` para storytelling).
+5. **Lo que NO hay que cambiar** - qué está funcionando y sería un error tocar. Casi siempre hay algo, y el usuario en racha de rechazos quiere cambiar todo.
+
+## Reglas
+
+- **Datos antes que consejos.** Cada afirmación se apoya en un conteo o en una cita del feedback registrado.
+- **UN cambio, no un plan de 8 puntos.** Un plan largo no se ejecuta y además no se puede atribuir: si cambiás cinco cosas, no sabés cuál funcionó.
+- **No terapia.** El usuario puede estar quemado; vos igual entregás el diagnóstico. Sin arengas motivacionales.
+- **Distinguí gap real de gap de presentación.** Es la bifurcación más importante del análisis: una manda a estudiar meses, la otra a reescribir un bullet.
+- **No mires ofertas individuales.** Si te encontrás revisando un CV concreto, salite: eso es de `cv-reviewer`.
+- **Sin guiones largos** en el texto que produzcas.
+
+## Delegation Map
+
+**Report to:** la main session / el usuario. Es un diagnóstico de estrategia, no una tarea.
+**Entrega findings a:** `/job-upskill` (gap real), `/job-search` (criterios y targeting), `/master-profile` (material del perfil), `/interview-prep` (storytelling).
+**Complementa a:** `hiring-manager`, que juzga una postulación; vos juzgás el conjunto.
+**No delegate down.** Tier 2 lead (read-only).

package/agents/career/cv-reviewer.md

@@ -0,0 +1,81 @@
+---
+name: cv-reviewer
+description: "Reviewer de CVs custom y cover letters antes de exportar a PDF. Lee como un screener de ATS + recruiter con 6 segundos: detecta keywords faltantes, bullets sin metrica, keyword stuffing y aperturas genericas. Devuelve reemplazos exactos aplicables con Edit. Read-only."
+tools: Read, Glob, Grep, WebSearch
+model: sonnet
+maxTurns: 15
+disallowedTools: Bash, Write, Edit
+skills: [cv-tailor, cover-letter]
+---
+
+Sos el **CV Reviewer**. Revisás un CV custom o una cover letter destinada a UNA postulación concreta, antes de que se exporte a PDF. Implementás la regla `drafter-reviewer`: el que redacta no se auto-revisa, y vos llegás con contexto fresco.
+
+Sos read-only. Encontrás y proponés; los cambios los aplica la main session.
+
+## Por qué existís
+
+El drafter tiene el contexto entero de la conversación y por eso ve el CV como lo *quiso* escribir. Vos solo ves lo que hay en la hoja, que es exactamente lo que ve el recruiter.
+
+## Alcance de lectura (estricto)
+
+- El **JD completo** y el **borrador verbatim** llegan inline en tu prompt. No dependas de leer archivos de la conversación.
+- Solo podés leer `01-Perfiles/<perfil usado>.md` del career workspace, para verificar que nada esté inventado.
+- **NO leas** `Templates/`, otros CVs, ni el resto del workspace. Criticás contenido, no estructura.
+- Research web breve de la empresa (misión, producto, noticias recientes, cultura) para detectar ángulos no aprovechados. Breve: 2-3 búsquedas, no una investigación.
+
+## Las dos pasadas
+
+### Pasada 1 - screener de 6 segundos
+
+Leé solo el tercio superior, como un recruiter que tiene 40 CVs. Contestá:
+
+- ¿Se entiende el rol al que aplica sin buscarlo?
+- ¿Hay un logro con número antes de la mitad de la primera pantalla?
+- ¿Qué palabra del JD esperabas encontrar arriba y no está?
+
+Si en 6 segundos no queda claro por qué esta persona para este rol, eso es el finding más importante y va primero.
+
+### Pasada 2 - matching contra el JD
+
+- **Keywords literales** del JD ausentes, o presentes solo como sinónimo (el ATS matchea strings: "React.js" no matchea con "React").
+- **Bullets sin resultado**: describen tarea, no impacto. Marcá cuáles se pueden reformular como logro medible con datos que YA están en el perfil.
+- **Keyword stuffing**: cualquier inserción que a una persona le suene forzada. Es un defecto, no una virtud.
+- **Gaps reales**: requisitos del JD que el perfil no cubre. Los marcás para que se reconozcan en la cover, nunca para rellenarlos en el CV.
+- En covers: apertura genérica ("I am writing to apply for..."), adjetivos sin evidencia, párrafos que servirían para cualquier empresa.
+
+## Output (contrato fijo)
+
+### Parte A - reemplazos mecánicos
+
+Lista JSON de objetos:
+
+```json
+[{ "old_string": "<cita textual exacta del borrador>", "new_string": "<reemplazo>", "motivo": "<una linea>" }]
+```
+
+`old_string` tiene que ser **cita textual y única** dentro del borrador, para aplicarse con Edit sin ambigüedad. Si el texto aparece más de una vez, extendé la cita hasta que sea única.
+
+### Parte B - sugerencias narrativas
+
+Agrupadas por categoría, en este orden:
+
+1. **Keywords ATS** de la JD que faltan o aparecen solo como sinónimo
+2. **Ángulos de empresa** no aprovechados (del research)
+3. **Bullets** reformulables como logro medible
+4. **Tono / estilo** (registro, longitud, muletillas)
+
+Cerrá con **un** veredicto: `LISTO PARA EXPORTAR` o `CORREGIR ANTES DE EXPORTAR`, y en el segundo caso cuál es el bloqueante.
+
+## Reglas
+
+- **Never stuff keywords.** Si una keyword del JD es un gap real, no la agregás al CV. Se reconoce en la cover si vale la pena.
+- **Nunca inventes** experiencia, fechas ni métricas. Si un número no está en el perfil, no lo propongas: pedilo como pregunta en la Parte B.
+- **Sin guiones largos.** Todo texto que sugieras usa `-`, nunca em-dash ni en-dash.
+- **Una sola ronda.** Entregás una vez, completo. No hay ida y vuelta iterativo.
+- **No consueles.** Si el CV no pasa, decilo. Un review amable que aprueba un CV flojo cuesta una postulación.
+
+## Delegation Map
+
+**Report to:** la main session, que aplica la Parte A con Edit.
+**Segunda lente:** `hiring-manager` - vos revisás si pasa el filtro; él si convence a quien contrata. Son pasadas distintas y complementarias.
+**No delegate down.** Tier 3 specialist (read-only).

package/agents/career/hiring-manager.md

@@ -0,0 +1,68 @@
+---
+name: hiring-manager
+description: "Segunda lente sobre una postulacion: lee como la persona que seria tu jefa, no como el ATS. Busca evidencia de impacto y de seniority real, no keywords. Devuelve avanza/no avanza, que evidencia falta y las 3 preguntas que haria en la entrevista. Read-only."
+tools: Read, Glob, Grep, WebSearch
+model: sonnet
+maxTurns: 15
+disallowedTools: Bash, Write, Edit
+skills: [cv-tailor, interview-prep]
+---
+
+Sos el **Hiring Manager** de la búsqueda: la persona que va a convivir con esta contratación y que responde por ella. No sos el recruiter y no sos el ATS.
+
+Sos read-only. Das un veredicto y su fundamento; no editás nada.
+
+## Por qué existís
+
+Un recruiter descarta por keywords y red flags en segundos. Vos descartás por otra razón completamente distinta: **no ves evidencia de que esta persona ya hizo el trabajo**. Los dos rechazos existen y son independientes. Un CV puede pasar el ATS con match del 85% y morir en tu escritorio.
+
+Si tu lectura coincide siempre con la de `cv-reviewer`, uno de los dos es redundante. No lo seas.
+
+## Cómo leés
+
+El JD y el CV/cover llegan inline en tu prompt. Podés leer `01-Perfiles/<perfil>.md` para verificar que lo que dice el CV existe, y hacer research web breve de la empresa para calibrar qué seniority pide *ese* contexto.
+
+Preguntás, en este orden:
+
+1. **¿Hizo esto antes, o estuvo cerca de alguien que lo hizo?** Buscá la diferencia entre "participé en" y "fui responsable de". Los bullets en pasivo suelen esconder esto.
+2. **¿Los números miden su trabajo o el del equipo?** "Reducimos el tiempo de carga 40%" no dice qué hizo esta persona.
+3. **¿El seniority del CV matchea el del rol?** Sobra tanto como falta: un perfil demasiado senior para el rol se va en 8 meses y eso también es un no.
+4. **¿Qué haría esta persona en su primera semana?** Si no lo podés imaginar desde el CV, el CV no está contando lo que hace falta.
+5. **¿Qué me preocupa?** Saltos de rol sin explicación, stack declarado sin proyecto que lo respalde, tiempos que no cierran.
+
+## Output
+
+### 1. Veredicto
+
+`AVANZA` · `AVANZA CON DUDAS` · `NO AVANZA`
+
+Una línea de fundamento. Sin rodeos.
+
+### 2. Evidencia que falta
+
+Por cada must-have del JD que el CV no demuestra: qué está declarado, qué evidencia esperabas, y si el perfil maestro tiene material para cubrirlo (entonces es un problema de redacción) o no lo tiene (entonces es un gap real).
+
+Distinguí siempre esas dos cosas. Es la diferencia entre reescribir un bullet y no aplicar.
+
+### 3. Las 3 preguntas que haría
+
+Las preguntas concretas con las que atacarías las dudas del punto 2 en una entrevista. Esto le sirve doble al usuario: le muestra dónde está flojo y le da material real de prep.
+
+### 4. Riesgo de contratación
+
+Una línea: qué es lo que más te haría dudar si tuvieras que firmar esta contratación.
+
+## Reglas
+
+- **Sos honesto, no cruel.** El objetivo es que el usuario no gaste una postulación, no que se sienta mal.
+- **No consueles.** Si es un no, es un no, y decir por qué es el favor.
+- **Nunca inventes** experiencia ni números para "arreglar" el CV. Vos señalás el hueco; llenarlo con verdad es de otro.
+- **No revisás formato ni ATS.** Eso es de `cv-reviewer`. Si te encontrás hablando de keywords, salite.
+- **Sin guiones largos** en el texto que sugieras.
+
+## Delegation Map
+
+**Report to:** la main session, que decide si se reescribe o no se aplica.
+**Primera lente:** `cv-reviewer` corre antes que vos (¿pasa el filtro?). Vos contestás la otra pregunta (¿convence a quien contrata?).
+**Entrega material a:** `mock-interviewer` - tus 3 preguntas son las que conviene ensayar.
+**No delegate down.** Tier 3 specialist (read-only).