claude-code-arcane 2.2.0 → 2.4.0

package/skills/cover-letter/SKILL.md

@@ -4,7 +4,7 @@ description: "Write concise, confident cover letters and application messages ta
 argument-hint: "[application-note | company + role]"
 category: "career"
 user-invocable: true
-allowed-tools: Read, Glob, Grep, Write, Edit, WebFetch
+allowed-tools: Read, Glob, Grep, Write, Edit, WebFetch, Task
 ---
 
 # Cover Letter - Mensaje de aplicación de élite
@@ -47,7 +47,8 @@ Escribís cover letters y mensajes de aplicación **concisos, seguros y custom**
 2. Elegir formato según canal.
 3. Draftear. Después **cortar sin piedad** todo lo genérico.
 4. Generar 2 variantes de apertura si el usuario quiere elegir.
-5. Guardar en la nota de aplicación (`03-Aplicaciones/`, sección cover letter) o en `07-Recursos/` si es reutilizable.
+5. **Review (regla drafter-reviewer, obligatorio si la carta va a una postulación concreta).** Lanzar el agente `cv-reviewer` de contexto fresco con el JD y el borrador inline; aplicar la Parte A e incorporar de la Parte B lo que corresponda. Una sola ronda. El primer renglón es lo que más gana con una lectura fresca: el que la escribió ya está convencido de su propio gancho. No aplica a mensajes cortos reutilizables de `07-Recursos/`.
+6. Guardar en la nota de aplicación (`03-Aplicaciones/`, sección cover letter) o en `07-Recursos/` si es reutilizable.
 
 ## Idioma
 
@@ -63,4 +64,4 @@ Inglés para roles internacionales; español si la empresa es hispanohablante. E
 
 ## Handoff
 
-Pedí aprobación (approval) antes de guardar la carta en la nota de aplicación o en `07-Recursos/`. Cuando la cover letter está READY, el siguiente paso es `/cold-outreach` si hay un contacto al que escribirle directo.
+Pedí aprobación (approval) antes de guardar la carta en la nota de aplicación o en `07-Recursos/`. Cuando la cover letter está READY y pasó el review del paso 5, el siguiente paso es `/cold-outreach` si hay un contacto al que escribirle directo.

package/skills/cv-tailor/SKILL.md

@@ -4,7 +4,7 @@ description: "Tailor a CV to a specific job description: extract ATS keywords, d
 argument-hint: "[job-url | path-to-jd | application-note]"
 category: "career"
 user-invocable: true
-allowed-tools: Read, Glob, Grep, Write, Edit, WebFetch
+allowed-tools: Read, Glob, Grep, Write, Edit, WebFetch, Task
 ---
 
 # CV Tailor - Adaptar el CV a la oferta
@@ -46,6 +46,14 @@ Tomás un job description y el perfil base del usuario, y producís un **CV cust
 - Documentar las decisiones (keywords, qué se resaltó/bajó) en las secciones del template - sirve para la entrevista y para iterar.
 - El cuerpo del CV en sí debe quedar listo para `/cv-ats-export` (markdown limpio: `# nombre`, `## secciones`, bullets, `---`).
 
+### 6. Review antes de exportar (regla drafter-reviewer, obligatorio)
+
+Con el `.md` aprobado y **antes** de mandar a `/cv-ats-export`, seguir `.claude/rules/drafter-reviewer.md`: lanzar el agente `cv-reviewer` de contexto fresco con el JD y el borrador inline. Aplicar la Parte A (reemplazos exactos) e incorporar de la Parte B lo que corresponda. Una sola ronda.
+
+Si el rol es senior o la postulación importa, lanzar además `hiring-manager` en paralelo - contesta si el CV convence a quien contrata, que es una pregunta distinta.
+
+El que redacta no se auto-revisa: no saltear este paso porque el CV "ya quedó bien". Si el usuario decide exportar sin review, avisar que se está saltando la regla y seguir.
+
 ## Formato del CV (ATS-friendly)
 
 - **Una columna.** Sin tablas, sin cajas de texto, sin columnas - los ATS las leen mal.
@@ -64,7 +72,8 @@ CV en **inglés** para roles internacionales/remotos globales; **español** si l
 - No keyword-stuffing: cada keyword debe vivir en un bullet verdadero.
 - Un CV custom por postulación - no pisar el perfil base ni el maestro.
 - Después de generar el `.md`, recordar al usuario correr `/cv-ats-export` para el PDF.
+- No exportar a PDF sin pasar por el review del paso 6.
 
 ## Handoff
 
-Pedí aprobación (approval) antes de escribir el CV custom. Cuando el `.md` está READY, el siguiente paso es `/cv-ats-export` para generar el PDF ATS y `/cover-letter` para el mensaje.
+Pedí aprobación (approval) antes de escribir el CV custom. Cuando el `.md` está READY, corré el review del paso 6 (`cv-reviewer`); recién con el feedback aplicado el siguiente paso es `/cv-ats-export` para generar el PDF ATS y `/cover-letter` para el mensaje.

package/skills/freelance-deliver/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: freelance-deliver
+description: "Track an active contract while it runs: log hours against the estimate, catch scope creep the day it happens instead of at invoice time, and draft the change order before doing the extra work. Triggers: registrar horas, el cliente me pidio algo mas, esto no estaba en el alcance, scope creep, como va el contrato, change order, cerrar el contrato."
+argument-hint: "[log | check | change | close]"
+category: "career"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit, Task
+---
+
+# Freelance Deliver - Ejecutar sin regalar horas
+
+El loop mientras el proyecto corre. Tres cosas: registrar horas, detectar cuando el alcance se movió, y cobrarlo antes de hacerlo.
+
+Rutas relativas al career workspace (`--workspace`, env `CAREER_WORKSPACE`, o `./career-workspace/`).
+
+Modo: `$ARGUMENTS`
+
+## Por qué el momento importa
+
+El scope creep no se detecta al facturar: **se detecta el día que pasa**, y casi siempre entra disfrazado de favor. "¿Me agregás esto rapidito?" es la frase que más plata cuesta en freelance, y funciona porque en el momento parece chico y decir no parece desproporcionado.
+
+Un mes después son 18 horas que nadie va a pagar, y ahí ya es tarde: pedir plata por trabajo entregado suena a reclamo; pedirla antes suena a profesional.
+
+## Modos
+
+### `log` - registrar horas
+
+Agregar filas a `## Horas registradas` de la nota del contrato: fecha, horas, qué se hizo, y **si es facturable o no**.
+
+Esa última columna es la que casi nadie lleva y la que hace toda la diferencia: las reuniones, el ida y vuelta por accesos y las rondas de revisión son horas reales de tu semana. Si no se registran, tu tarifa efectiva parece mejor de lo que es y vas a seguir cotizando mal.
+
+Después de registrar, correr `check` si el acumulado se acercó al estimado.
+
+### `check` - cómo va
+
+1. Sumar horas registradas y comparar contra `horas_estimadas` de la nota.
+2. Estado de los milestones: entregados, vencidos, pendientes de aprobación del cliente.
+3. Semáforo, y lo importante es qué hacer con cada color:
+
+| Consumido del estimado | Qué significa |
+|---|---|
+| Menos del 70% con el alcance avanzando | Va bien |
+| 70-100% con alcance pendiente | **Avisar al cliente ahora**, no al pasarse |
+| Arriba del 100% | Parar y ver si fue mala estimación (se absorbe y se aprende) o alcance nuevo (se cobra) |
+
+Esa distinción es la única que importa: **subestimé** contra **me pidieron más**. La primera es tu costo; la segunda es un change order. Confundirlas te hace pagar por errores del cliente o cobrarle por los tuyos.
+
+4. Detectar tareas hechas que no están en el alcance acordado. Si hay, ofrecer `change`.
+
+### `change` - el change order
+
+Cuando el cliente pide algo fuera del alcance acordado:
+
+1. **Nombrarlo como alcance nuevo** en el momento y sin dramatizar: no es un reclamo, es cómo funciona. "Eso lo puedo hacer, está fuera del alcance de este contrato, te paso el número."
+2. Estimar con `/estimate` y cotizar con el mismo criterio que la propuesta original: sobre el piso neto, con buffer.
+3. Redactar el change order con `/contract-and-proposal-writer`.
+4. Registrarlo en `## Change orders` de la nota con estado `propuesto`.
+5. **No hacer el trabajo hasta que esté aprobado.** Es la regla 3 de `freelance-guardrails`: alcance nuevo, precio nuevo.
+
+Si el usuario decide regalarlo (porque es chico, o por relación con el cliente), **está bien - pero se registra igual** con monto 0 y el motivo. Lo que no se registra no se puede medir, y `/freelance-pipeline` necesita saber cuánto trabajo regalado hay para decirte si es un patrón.
+
+### `close` - cerrar el contrato
+
+1. Completar `## Cierre`: entregado, cobrado, calificación recibida, y **qué haría distinto** (esa línea es la que sirve para cotizar el próximo).
+2. `estado: cerrado`, y `/job-outcome` para mover la nota de la propuesta.
+3. Comparar estimado contra real y dejarlo escrito. Es el dato más valioso del contrato entero: sin él, la próxima estimación es otra vez a ojo.
+4. Ofrecer `/freelance-pipeline` si ya hay volumen, y `/cold-outreach` para pedir la referencia mientras el trabajo está fresco.
+
+## Verificación rápida del estado
+
+Para ver de una todos los contratos con horas por encima de lo estimado, sin abrirlos uno por uno:
+
+```bash
+python .claude/skills/career-registry/scripts/career_registry.py audit
+```
+
+Devuelve `contratos_con_horas_arriba_de_lo_estimado` con el exceso en horas y en porcentaje. Es la entrada natural de este skill cuando el usuario pregunta "¿cómo vengo?".
+
+## Reglas
+
+- **Nunca hacer trabajo fuera del alcance sin cotizarlo primero.** Si el usuario decide regalarlo, se registra con monto 0 y motivo.
+- **Distinguir siempre subestimación de alcance nuevo.** Son dos cosas y se pagan distinto.
+- Registrar las horas **no facturables** también: son las que explican por qué tu tarifa real es menor que la nominal.
+- No editar el alcance acordado para que coincida con lo que se hizo. El alcance es el que se firmó; lo demás es change order.
+- Nunca marcar un milestone como cobrado sin que el usuario lo confirme.
+- Sin guiones largos en el texto agregado a las notas.
+
+## Handoff
+
+Pedí aprobación (approval) antes de escribir en la nota del contrato. Entrega COMPLETE cuando las horas están registradas y el alcance está alineado o hay un change order propuesto. Según el caso, el siguiente paso es `/contract-and-proposal-writer` (redactar el change order), `/job-outcome` (mover el estado al cerrar) o `/freelance-pipeline` (con 10+ propuestas resueltas, el diagnóstico del negocio).

package/skills/freelance-hunt/SKILL.md

@@ -0,0 +1,126 @@
+---
+name: freelance-hunt
+description: "Entry point for the freelance skillset: extends the career workspace with contracts and a Connects ledger, then routes to the right skill. Triggers: freelance, upwork, buscar proyectos como freelancer, conseguir clientes, pipeline freelance, setup freelance workspace, cuanto gano por hora."
+argument-hint: "[setup | status | next]"
+category: "career"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit
+---
+
+# Freelance Hunt - Orquestador del pipeline freelance
+
+Sos el punto de entrada de la suite freelance. Detectás (o extendés) el career workspace, entendés en qué etapa está el usuario, y ruteás al skill correcto. No hacés todo vos - orquestás.
+
+## Un solo workspace, no dos
+
+El perfil **reutiliza el career workspace** de `+job-hunt` (default `./career-workspace/`, o env `CAREER_WORKSPACE`). No crea uno paralelo, y esto es deliberado: `01-Perfiles/` es la única fuente de verdad de la experiencia del usuario. Dos workspaces serían dos perfiles maestros divergiendo, que es exactamente el problema que el perfil maestro resuelve.
+
+Lo que agrega el perfil freelance:
+
+```
+career-workspace/
+  03-Aplicaciones/         ← compartida: empleos Y propuestas (discrimina `tipo:`)
+  04-Empresas/             ← compartida: empresas Y clientes
+  08-Contratos/            NUEVA: contratos activos, milestones, horas, change orders
+  07-Recursos/
+    Connects - YYYY.md     NUEVO: ledger del costo de postularse (Connects en Upwork,
+                           bids en otras plataformas, horas en outreach directo)
+  Templates/
+    Propuesta.md           NUEVO
+    Contrato.md            NUEVO
+```
+
+Una propuesta **es** una aplicación: vive en `03-Aplicaciones/` con `tipo: freelance`. Un cliente **es** una empresa: vive en `04-Empresas/`. Así `/job-outcome`, `/cold-outreach` y `/master-profile` funcionan sobre las dos mitades sin cambios.
+
+Si el usuario no tiene `+job-hunt` instalado, el modo `setup` crea el árbol completo igual: el workspace no depende del otro perfil, solo lo comparte.
+
+## Vocabulario de estados
+
+Frontmatter `estado` para `tipo: freelance`:
+
+`interesado → screeneado → propuesta_enviada → en_conversacion → contrato_activo → entregado`
+
+Cierres: `ganado_cerrado | sin_respuesta | rechazado | descartado | disputa`
+
+`descartado` es una decisión activa y se registra igual que una propuesta enviada: los descartes son la mitad de los datos que `/freelance-pipeline` necesita (ver `freelance-guardrails`, sección Registro). Los estados los mueve `/job-outcome`; ninguna otra skill marca `propuesta_enviada`.
+
+## Modos
+
+### `setup` - Preparar el workspace
+
+1. Detectar si ya existe el career workspace. Si existe, **extenderlo**; si no, crear el árbol completo (mismo que `/job-hunt setup`).
+2. Crear `08-Contratos/` y copiar `Propuesta.md` y `Contrato.md` desde `references/templates/` a `Templates/`.
+3. Crear el ledger `07-Recursos/Connects - <año>.md` desde `references/templates/Connects.md`.
+4. Agregar al `00-Dashboard.md` las secciones freelance (propuestas activas, contratos en curso, Connects del mes). Si el dashboard no existe, crearlo.
+5. Preguntar y registrar en `01-Perfiles/` los **dos números que gobiernan todo el perfil**: el piso de tarifa neto y la capacidad semanal de horas facturables. Sin el piso, `/freelance-proposal` no puede validar un bid (ver `freelance-guardrails` regla 3).
+6. Si el usuario ya tiene cuenta en alguna plataforma, sugerir `/freelance-profile` como siguiente paso; si no, `/master-profile` primero. Si todavía no sabe qué piso poner, `/freelance-scan market` da la mediana de lo que cobran otros con su perfil.
+
+### `status` - Dónde estoy
+
+1. Leer `00-Dashboard.md`, escanear `03-Aplicaciones/` filtrando `tipo: freelance`, y `08-Contratos/`.
+2. Resumir: propuestas esperando respuesta (con días transcurridos), contratos activos y su avance, Connects gastados en el mes contra resultados, horas facturables comprometidas contra capacidad.
+3. Marcar lo que necesita acción hoy: propuestas sin respuesta hace 7+ días, milestones vencidos, contratos con horas por encima de lo estimado.
+4. Recomendar la acción de mayor impacto.
+
+### `next` - Qué hago ahora
+
+Según el estado del workspace, recomendar el skill siguiente (ver routing).
+
+## Routing
+
+| Situación | Skill |
+|-----------|-------|
+| No hay workspace | `/freelance-hunt setup` |
+| Falta perfil maestro | `/master-profile` |
+| Perfil de plataforma flojo o vacío | `/freelance-profile` |
+| Buscar y scorear ofertas | `/freelance-scan` |
+| Qué cobran otros con mi perfil | `/freelance-scan market` |
+| Evaluar riesgo de un cliente | `/client-screen` |
+| Escribir la propuesta y el bid | `/freelance-proposal` |
+| Contrato, SOW, NDA o change order | `/contract-and-proposal-writer` |
+| Estimar esfuerzo de un proyecto | `/estimate` |
+| Registrar respuesta o resultado | `/job-outcome` |
+| ¿Ya me postulé acá? / exportar el registro a CSV | `/career-registry` |
+| Mensaje directo a un cliente o follow-up | `/cold-outreach` |
+| Portfolio web | `/portfolio-site` |
+| Gané el proyecto: desarmar alcance y validar horas | `/freelance-kickoff` |
+| Registrar horas, scope creep, change orders | `/freelance-deliver` |
+| ROI de Connects, utilización, tarifa efectiva | `/freelance-pipeline` |
+
+## Los 4 agentes del perfil
+
+El perfil instala `agents/freelance/`. Existen porque hay lecturas que solo sirven con contexto fresco, y son read-only: devuelven análisis, los archivos los escribe la sesión principal.
+
+| Agente | Contesta | Lo lanza |
+|---|---|---|
+| `client-screener` | ¿Este cliente es un riesgo? (adversarial por diseño) | `/client-screen` |
+| `proposal-reviewer` | ¿Vale gastar Connects en esta propuesta? | `/freelance-proposal` |
+| `discovery-call` | ¿Aguanto la llamada, el regateo y el alcance de contrabando? | `/freelance-proposal`, `/client-screen` |
+| `pipeline-strategist` | ¿Esto es un negocio o un pasatiempo caro? | `/freelance-pipeline` (10+ propuestas resueltas) |
+
+`client-screener` y `proposal-reviewer` corren **en paralelo** cuando van los dos: son preguntas independientes.
+
+## Workflow estándar para una oportunidad
+
+1. `/freelance-scan` → ofertas scoreadas, dedup contra corridas anteriores.
+2. `/client-screen` → riesgo del cliente. **Si el veredicto es no postularse, se registra el descarte y termina acá.** Ese es el paso que ahorra plata.
+3. `/estimate` → esfuerzo real del alcance descrito.
+4. `/freelance-proposal` → propuesta + bid sobre el piso + review con `proposal-reviewer`.
+5. Enviar (**siempre manual**) → `/job-outcome` para marcar `propuesta_enviada` y registrar el gasto de Connects.
+6. Si el cliente responde → ensayar con `discovery-call`, después la llamada real.
+7. Si se cierra → `/contract-and-proposal-writer` para el SOW, nota en `08-Contratos/`.
+8. **`/freelance-kickoff`** → desarmar el alcance y validar si entra en lo cotizado. Acá se descubre la brecha, no en la semana 5.
+9. Mientras se ejecuta → `/freelance-deliver` para horas, scope creep y change orders.
+10. Al cerrar → `/freelance-deliver close`, y cada 2 semanas o con 10+ propuestas resueltas, `/freelance-pipeline`.
+
+## Reglas
+
+- Regla del perfil: `freelance-guardrails`. Las cuatro no son sugerencias - los Connects son plata, el JSS es un activo, el piso no se negocia y el envío es manual.
+- Nunca reorganizar carpetas ni renombrar notas sin preguntar - rompe `[[wikilinks]]` en silencio.
+- Nunca commitear datos sensibles (montos, datos de clientes, mails) a un remoto sin confirmación explícita.
+- Preservar los prefijos numéricos al crear archivos.
+- Máximo accionable: el usuario siempre termina sabiendo qué skill correr next.
+
+## Handoff
+
+Pedí aprobación (approval) antes de escribir o sobrescribir archivos del workspace. Cuando el workspace queda READY, el siguiente paso es `/freelance-profile` si ya hay cuenta en una plataforma, o `/master-profile` si falta el perfil maestro.

package/skills/freelance-hunt/references/templates/Connects.md

@@ -0,0 +1,39 @@
+---
+tipo: costo-postulaciones
+anio: {{date:YYYY}}
+fecha_actualizacion: {{date:YYYY-MM-DD}}
+---
+
+# Ledger del costo de postularse {{date:YYYY}}
+
+> Cada fila es plata gastada. Sin este registro, `/freelance-pipeline` no puede calcular costo de adquisición ni cuánto se fue en ofertas que nunca contrataron a nadie.
+>
+> La unidad depende de la plataforma: Connects en Upwork, bids en Freelancer.com, horas de escritura en outreach directo. Anotá la que uses y sé consistente.
+
+## Registro
+
+| Fecha | Propuesta | Costo | Unidad | Resultado | Días hasta respuesta |
+|---|---|---|---|---|---|
+|  | [[]] |  | connects | esperando |  |
+
+%% Resultado: esperando / sin_respuesta / respondio / llamada / ganado / oferta_nunca_contrato %%
+%% "oferta_nunca_contrato" es la categoria que mas duele y la mas evitable: el cliente cerro sin contratar a nadie. Marcarla cuando se detecte. %%
+
+## Compras de presupuesto de postulaciones
+
+| Fecha | Cantidad | Costo | Fuente |
+|---|---|---|---|
+|  |  |  | comprados |
+
+%% Fuente: incluidos_plan / comprados / devueltos %%
+
+## Resumen del año
+
+- **Total gastado:** 
+- **Contratos ganados:** 
+- **Costo de adquisición** (total gastado / contratos ganados): 
+- **Perdido en ofertas que nunca contrataron a nadie:** 
+- **Devuelto** (Upwork reintegra Connects en algunos casos): 
+
+## Notas
+

package/skills/freelance-hunt/references/templates/Contrato.md

@@ -0,0 +1,60 @@
+---
+tipo: contrato
+cliente: 
+propuesta: 
+plataforma: upwork
+estado: activo
+modalidad_precio: 
+monto_acordado: 
+horas_estimadas: 
+horas_reales: 
+fecha_inicio: {{date:YYYY-MM-DD}}
+fecha_cierre: 
+fecha_actualizacion: {{date:YYYY-MM-DD}}
+calificacion_recibida: 
+---
+%% estado: activo -> entregado -> cerrado | problemas: pausado / disputa %%
+
+# {{title}}
+
+## Contrato
+- **Cliente:** [[]]
+- **Propuesta origen:** [[]]
+- **SOW / contrato firmado:** 
+
+## Alcance acordado
+%% lo que entra. Todo lo que no este escrito aca es alcance nuevo y se cotiza aparte %%
+- 
+
+## Alcance explicitamente excluido
+%% lo que NO entra. Escribirlo ahorra la discusion de la semana 6 %%
+- 
+
+## Criterios de aceptación
+%% como sabemos que esta terminado. Sin esto, "terminado" lo define el cliente cuando quiera %%
+- 
+
+## Milestones
+| # | Entregable | Monto | Fecha objetivo | Estado |
+|---|---|---|---|---|
+| 1 |  |  |  | pendiente |
+
+## Horas registradas
+| Fecha | Horas | Qué se hizo | Facturable |
+|---|---|---|---|
+|  |  |  | sí |
+
+## Change orders
+%% alcance nuevo, precio nuevo. Cada pedido fuera del alcance acordado va aca ANTES de hacerlo %%
+| Fecha | Qué pidió | Horas | Monto | Estado |
+|---|---|---|---|---|
+|  |  |  |  | propuesto |
+
+## Cierre
+- **Entregado:** 
+- **Cobrado:** 
+- **Calificación recibida:** 
+- **Qué haría distinto:** 
+
+## Notas
+

package/skills/freelance-hunt/references/templates/Propuesta.md

@@ -0,0 +1,66 @@
+---
+tipo: freelance
+cliente: 
+plataforma: upwork
+perfil: 
+estado: interesado
+match_score: 
+riesgo_cliente: 
+connects_gastados: 
+bid: 
+modalidad_precio: 
+fecha_envio: 
+fecha_actualizacion: {{date:YYYY-MM-DD}}
+link_oferta: 
+presupuesto_cliente: 
+prioridad: media
+---
+%% estado: interesado -> screeneado -> propuesta_enviada -> en_conversacion -> contrato_activo -> entregado | cierres: ganado_cerrado / sin_respuesta / rechazado / descartado / disputa (los mueve /job-outcome) %%
+%% modalidad_precio: fijo | hora %%
+
+# {{title}}
+
+## Oferta y cliente
+- **Cliente:** [[]]
+- **Qué pide:** 
+- **Link:** 
+- **Presupuesto declarado:** 
+
+## Screen del cliente
+%% lo llena /client-screen - si el veredicto fue no postularse, estado: descartado y el motivo en Notas %%
+- **Nivel de riesgo:** 
+- **Payment verificado:** 
+- **Hire rate / contrataciones / total gastado:** 
+- **Promedio pagado por hora:** 
+- **Brecha presupuesto vs alcance:** 
+- **Red flags encontradas:**
+  - 
+- **Riesgo de JSS:** 
+- **Preguntas a hacer antes de comprometerse:**
+  - 
+
+## Match con mi perfil
+- Perfil usado: [[]]
+- Qué cubro con evidencia real:
+  - 
+- Gaps honestos:
+  - 
+
+## Cotización
+%% lo llena /freelance-proposal - el piso es neto, el bid tiene que cubrir la comision %%
+- **Esfuerzo estimado:** 
+- **Buffer de riesgo aplicado:** 
+- **Horas no facturables previstas:** 
+- **Piso neto del perfil:** 
+- **Bid final:** 
+- **Por qué este número:** 
+
+## Propuesta
+%% las dos primeras lineas son lo unico que el cliente ve en la lista %%
+
+
+## Timeline / seguimiento
+- {{date:YYYY-MM-DD}} - creada la nota
+
+## Notas
+

package/skills/freelance-kickoff/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: freelance-kickoff
+description: "Turn a won contract into an executable plan: break the scope into deliverables, write the acceptance criteria, and validate honestly whether what you promised fits the hours you quoted - before week five. Then hand off to the technical skills. Triggers: gane el proyecto, arrancar el contrato, kickoff, desarmar el alcance, criterios de aceptacion, me alcanzan las horas que cotice, planificar el proyecto freelance."
+argument-hint: "[nota de contrato | cliente]"
+category: "career"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit, WebFetch, Task
+---
+
+# Freelance Kickoff - Del contrato al plan
+
+Ganaste el proyecto. Ahora hay que convertir la propuesta en algo ejecutable, y sobre todo **descubrir ahora y no en la semana 5** si lo que prometiste entra en las horas que cotizaste.
+
+Rutas relativas al career workspace (`--workspace`, env `CAREER_WORKSPACE`, o `./career-workspace/`).
+
+Contrato o cliente: `$ARGUMENTS`
+
+## Por qué existe este paso
+
+El resto del perfil te ayuda a conseguir el trabajo. Este es el primero que te ayuda a **hacerlo**, y existe porque el momento de mayor riesgo del freelance no es postularse: es la brecha entre lo que la propuesta dice y lo que el trabajo realmente pide.
+
+Esa brecha se descubre siempre. La única variable es cuándo: acá, cuando todavía se puede renegociar, o en la semana 5, cuando ya es tu problema.
+
+## Inputs
+
+- **La nota del contrato** (`08-Contratos/`) y la propuesta que la originó (`03-Aplicaciones/`).
+- **El SOW o contrato firmado** si existe, y si no, avisar: sin alcance escrito no hay alcance.
+- La nota de `/client-screen`: lo que ahí quedó marcado como alcance difuso es exactamente lo que hay que cerrar ahora.
+- El perfil de `01-Perfiles/` para el piso de tarifa y la capacidad semanal.
+
+## Proceso
+
+### 1. Desarmar el alcance en entregables
+
+Cada entregable: qué es, qué incluye, **qué no incluye**, y de qué depende. Las dependencias importan porque las del lado del cliente (accesos, contenido, decisiones, aprobaciones) son la causa número uno de proyectos que se estiran sin que sea tu culpa - y sin que te lo paguen.
+
+Lo que la propuesta decía en una línea acá se convierte en tres o cuatro items. Si no se puede desarmar, es que el alcance no está definido, y ese es el hallazgo.
+
+### 2. Escribir los criterios de aceptación
+
+Por cada entregable: **cómo sabemos que está terminado**, en términos verificables.
+
+Sin esto, "terminado" lo define el cliente cuando quiera, y siempre está un poco más lejos. Es el mecanismo más barato que existe contra el scope creep, y casi nadie lo escribe.
+
+Si el usuario no sabe qué poner, la pregunta que lo desbloquea es: *"¿qué tendría que pasar para que el cliente lo apruebe sin pedir cambios?"*
+
+### 3. Estimar de verdad
+
+Usar `/estimate` por entregable. Sumar además lo que nunca entra en la estimación y siempre pasa: reuniones, rondas de revisión, ida y vuelta por accesos, setup del entorno.
+
+### 4. La validación honesta (el paso que justifica el skill)
+
+Comparar el total estimado contra las **horas implícitas en lo cotizado** (monto acordado dividido tu tarifa objetivo).
+
+| Resultado | Qué hacer |
+|---|---|
+| Entra con margen | Seguir. Registrar el margen para no regalarlo después |
+| Entra justo | Seguir, avisando que cualquier imprevisto sale de tu bolsillo |
+| **No entra** | **Parar y decirlo con el número** |
+
+Cuando no entra, las opciones reales son tres, y hay que ponerlas sobre la mesa antes de escribir una línea de código: **recortar alcance** al que cabe, **renegociar** el monto o el plazo con el desarme como evidencia, o **absorber la diferencia** como decisión consciente y registrada.
+
+Lo que no es una opción es empezar y ver qué pasa. Eso ya sabemos cómo termina.
+
+Nunca maquillar la estimación para que cierre. Si al desarmarlo son 90 horas y cotizaste 40, el número es 90.
+
+### 5. Plan de ejecución
+
+Secuenciar por dependencias, no por lo que da más ganas. Marcar el camino crítico y qué está bloqueado por el cliente. Definir milestones que coincidan con los pagos si el contrato los tiene: entregar tres cosas antes del primer cobro es financiar al cliente.
+
+### 6. Escribir y rutear
+
+Con approval, completar la nota de `08-Contratos/`: alcance acordado, alcance excluido, criterios de aceptación, milestones y estimación por entregable.
+
+Después **rutear al trabajo técnico**, que ya existe en el repo:
+
+| Si el proyecto es | Seguí con |
+|---|---|
+| Historias y tickets | `/create-stories`, `/create-epics` |
+| Backend, frontend, mobile | El perfil técnico que corresponda (`+backend-ts`, `+frontend`, ...) |
+| Algo sin especificar del lado del cliente | `/product-discovery` antes de codear |
+| Documentar lo que ya existe | `/reverse-document` |
+
+## Reglas
+
+- **Sin alcance escrito no se arranca.** Si no hay SOW ni propuesta con alcance, este skill produce el alcance propuesto y pide confirmarlo con el cliente antes de ejecutar.
+- **Nunca ajustar la estimación para que entre en lo cotizado.** El número es el número; la decisión es del usuario.
+- **Todo lo que no está en el alcance acordado va a "alcance excluido"**, explícito. Lo que no se escribe se discute después, y se discute gratis.
+- No inventar criterios de aceptación que el cliente no aceptó: si se proponen, se marcan como propuestos hasta que los confirme.
+- Sin guiones largos en el texto agregado a las notas.
+
+## Handoff
+
+Pedí aprobación (approval) antes de escribir en la nota del contrato. Kickoff COMPLETE cuando hay entregables, criterios de aceptación, estimación y el veredicto de si entra en lo cotizado. El siguiente paso es el skill técnico que corresponda para ejecutar, y `/freelance-deliver` para el seguimiento de horas y alcance mientras el proyecto corre.

package/skills/freelance-pipeline/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: freelance-pipeline
+description: "Diagnose the freelance business, not one proposal: Connects ROI, proposal funnel, real effective hourly rate net of unbilled hours, utilization, client concentration and scope drift on active contracts. Triggers: como va mi pipeline freelance, cuanto gano por hora de verdad, roi de connects, por que no me responden las propuestas, utilizacion, scope creep de un contrato."
+argument-hint: "[--desde YYYY-MM-DD]"
+category: "career"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Write, Edit, WebSearch, Task
+---
+
+# Freelance Pipeline - Diagnóstico del negocio
+
+Mirás el negocio entero, no la propuesta de mañana. La pregunta que contestás es si esto funciona como negocio, y si no, qué **una** cosa cambiar.
+
+Rutas relativas al career workspace (`--workspace`, env `CAREER_WORKSPACE`, o `./career-workspace/`).
+
+Ventana: `$ARGUMENTS` (vacío = todo el historial).
+
+## Inputs
+
+- `03-Aplicaciones/` con `tipo: freelance` - **todas**, incluidas las `descartado`. Los descartes dicen si tu criterio de selección funciona; sin ellos el diagnóstico está sesgado a las que sí mandaste.
+- `08-Contratos/` - activos y cerrados: estimado contra real, milestones, horas, change orders.
+- El ledger de Connects en `07-Recursos/` - gasto por propuesta y resultado.
+- `01-Perfiles/` - el piso de tarifa neto y la capacidad semanal declarada.
+
+### Los datos duros salen del export, no de la memoria
+
+Si el usuario tiene historial en una plataforma, **no le preguntes los montos y las horas**: que baje el CSV y usamos el importador. Nadie recuerda bien cuánto facturó.
+
+```bash
+python .claude/skills/freelance-pipeline/scripts/import_history.py inspect historial.csv
+python .claude/skills/freelance-pipeline/scripts/import_history.py summary historial.csv
+```
+
+Mismo patrón que `network_map.py` de `+job-hunt`: sin credenciales, sin tocar la cuenta. El usuario exporta, el script lee.
+
+**Correr `inspect` primero, siempre, y mostrarle el mapeo.** El script detecta las columnas porque los exports no tienen esquema estable, y reporta `columnas_sin_mapear` y `columnas_ambiguas`. Antes de creerle a un total hay que ver qué columna se usó; si eligió mal, se corrige con `--map "Columna=campo"`.
+
+Dos cosas que el summary te dice y hay que respetar: `tarifa_efectiva_calculable: false` significa que el export no trae horas y **la tarifa efectiva no se estima**, se pide el dato; y `muestra_suficiente: false` significa que no alcanza para hablar de tasas.
+
+## El guard de volumen (primero, obligatorio)
+
+Contar antes de afirmar.
+
+- **Menos de 10 propuestas resueltas:** no hay embudo. Entregar solo lo descriptivo (cuántas, Connects gastados, tiempo de respuesta) y nombrar la hipótesis más barata de testear. **Nada de patrones.**
+- **10 a 25:** tendencias, con la muestra a la vista en cada afirmación ("3 de 14").
+- **25+:** tasas de conversión.
+
+Tres propuestas sin respuesta no son un patrón. Tratarlas como tal manda al usuario a bajar la tarifa, que es el peor movimiento posible y el más difícil de revertir.
+
+## Las cinco métricas
+
+### 1. ROI de Connects
+
+`Connects gastados / contratos ganados` = costo de adquisición. Y el número que más duele: **cuántos Connects se fueron en ofertas que nunca contrataron a nadie**. Esa pérdida es evitable con mejor screening, así que se reporta aparte.
+
+### 2. Embudo
+
+```
+oferta vista → screen pasado → propuesta enviada → cliente responde → llamada → contrato
+```
+
+La etapa clave es **enviada → responde**. Cruzarla con el score cambia el diagnóstico:
+
+| Sin respuesta + score alto | Sin respuesta + score bajo |
+|---|---|
+| Problema de propuesta: apertura, precio, plantilla detectable | Problema de targeting: te postulás a lo que no te corresponde |
+| Va a `/freelance-proposal` | Va a `/freelance-scan` y `/freelance-profile` |
+
+### 3. Tarifa efectiva real
+
+`total cobrado / (horas facturadas + horas de propuestas + llamadas + admin)`, **neto de comisión**.
+
+No es la tarifa del contrato y casi siempre es bastante menor. Es el número que dice si el negocio funciona. **Si quedó abajo del piso declarado, ese es el hallazgo principal** y todo lo demás es secundario.
+
+### 4. Utilización y concentración
+
+- Horas facturables contra capacidad declarada. Muy baja = problema de pipeline. Muy alta sostenida = riesgo de burnout y de no tener tiempo para vender, que es cómo se llega al mes siguiente sin nada.
+- **Concentración**: porcentaje de ingresos del cliente más grande. Arriba de la mitad, no es un negocio: es un empleo sin sus protecciones y sin su estabilidad.
+
+### 5. Scope drift en contratos activos
+
+Contratos donde las horas reales superan lo estimado **sin change order**. Cada uno es trabajo regalado.
+
+El patrón importa más que el caso: si pasa en casi todos, el problema está en cómo se escriben los alcances (va a `/contract-and-proposal-writer`), no en los clientes. Por cada contrato con drift, ofrecer redactar el change order - alcance nuevo, precio nuevo (regla 3 de `freelance-guardrails`).
+
+## Proceso
+
+1. **Recolectar y contar.** Aplicar el guard de volumen y decir en qué banda estamos.
+2. **Calcular las cinco métricas.** Mostrarlas en el chat con la muestra explícita, antes de interpretar nada.
+3. **Lanzar `pipeline-strategist`** (contexto fresco, read-only) si hay 10+ propuestas resueltas. Devuelve punto de fuga, hipótesis con cómo testearlas, UN cambio recomendado y qué no tocar. Con menos volumen, saltear: el agente lo va a rechazar igual.
+4. **Reporte** en `07-Recursos/Pipeline - YYYY-MM-DD.md`, con approval del usuario sobre las métricas:
+   - Frontmatter: `tipo: pipeline`, `fecha`, `propuestas_analizadas`, `contratos_analizados`, `ventana`.
+   - Las cinco métricas con su muestra.
+   - El punto de fuga y su evidencia, con wikilinks a las notas que lo sostienen.
+   - El cambio recomendado y a qué skill se le pasa.
+   - Si existe un reporte anterior, sección "Desde el último reporte": qué se movió y qué no.
+5. **No editar** notas de propuestas ni de contratos. Solo crear el reporte y, si el usuario lo pide, los change orders de los contratos con drift.
+
+## Reglas
+
+- **Datos antes que consejos.** Cada afirmación se apoya en un conteo o en una cita del feedback registrado.
+- **UN cambio recomendado, no un plan de 8 puntos.** Si se cambian cinco cosas no se sabe cuál funcionó.
+- **Bajar la tarifa nunca es la primera palanca.** Solo entra si la evidencia dice que el posicionamiento está mal, y con ese fundamento explícito.
+- Nunca fabricar métricas: si falta el dato (horas no registradas, Connects sin anotar), reportar el hueco y qué habría que empezar a registrar.
+- Sin guiones largos, con wikilinks a las notas fuente.
+
+## Handoff
+
+Reporte COMPLETE en `07-Recursos/`. El siguiente paso es el que salga del punto de fuga: `/freelance-proposal` (propuesta), `/freelance-scan` o `/freelance-profile` (targeting y posicionamiento), `/client-screen` (criterios de descarte), o `/contract-and-proposal-writer` (alcances y change orders).