Promoción
Sin guiones largos. Nada de lo que escriba esta habilidad puede contener un guión largo; use una coma, dos puntos o paréntesis. Esto se aplica mediante un hook del repositorio. Ver
/flagrare:write-docs.
Palabras llanas. En todo lo que el usuario lea, use los nombres simples definidos en
<plugin root>/lib/career/GLOSSARY.md("comportamientos de Senior", no "filas de la rúbrica"; "tu caso escrito", no "packet"; "el proyecto que lideras", no "iniciativa"). La primera vez que aparezca un término, explique su significado en pocas palabras y añada la palabra que la empresa usa entre paréntesis cuando el usuario la oiga en el trabajo.
Una promoción se decide en una sala donde el usuario no está, a partir de un caso escrito, por personas que en su mayoría no lo conocen, en un calendario fijado con meses de antelación. Esta habilidad hace visibles esos hechos desde el principio: hacia dónde quiere ir el usuario y por qué, cómo decide realmente la empresa, qué pide la rúbrica, quién tiene conocimiento de primera mano de su trabajo y cuándo deben ocurrir las conversaciones clave.
Escribe un mapa de promoción: promotion-map.md para que el usuario lo lea y lo lleve a una reunión 1:1, y promotion-map.json con los mismos datos para las demás habilidades de carrera. El mapa es local y privado. Esta habilidad nunca publica, envía ni difunde nada.
Librería
El plugin incluye scripts auxiliares en <plugin root>/lib/career/. La raíz del plugin está dos directorios por encima del directorio base de esta habilidad. Ejecute cada uno como python3 <plugin root>/lib/career/<script>.py .... Solo leen e imprimen JSON; esta habilidad escribe cada archivo con la herramienta de escritura, porque una shell en una caja de arena no puede escribir en ~/.claude/skills.
career_state.py paths|contributions|plan --home "$HOME": ubicaciones de archivos, el registro de contribuciones (unión de ubicaciones antiguas y nuevas) y el plan de migración.map_schema.py check <map.json> --today YYYY-MM-DD: errores, secciones faltantes, secciones obsoletas (más de 90 días), conflictos.deadlines.py --deadline YYYY-MM-DD --today YYYY-MM-DD [--dead START:END ...] [--published]: cuándo hablar con el gerente.--deades opcional y repetible.
La forma del mapa está en reference/map-schema.md, y el diseño en markdown está en reference/map-template.md. Los demás archivos de estado compartido (registro de contribuciones, banderas, iniciativas) se describen en <plugin root>/lib/career/STATE.md; para limpiar una bandera ya gestionada, escriba flags.json de nuevo sin ella.
1. Cargar estado (cada ejecución)
- Ejecute
career_state.py plan. Aplique cada acciónwritecon la herramienta de escritura, leyendo primero el archivo de destino si ya existe (la herramienta de escritura no sobrescribirá un archivo que no haya leído). Una acciónmkdirno necesita un paso aparte: la carpeta se crea al escribir el primer archivo dentro de ella. No escriba un mapa provisional. Nunca borre nada. - Lea
~/.claude/skills/flagrare/config.json(claves de identidad de nivel superior, el bloqueskills.promotion) y el mapa existente, si lo hay. Si falta el archivo de configuración o el bloqueskills.promotion, continúe con los valores predeterminados. - Si no hay mapa, es una primera ejecución (sección 3). Si la salida de
map_schema.py checkenumera seccionesmissing, es una primera ejecución interrumpida: reanúdela en la fase más temprana cuyas secciones falten. De lo contrario, ejecute una actualización (sección 4), a menos que el usuario solicite el modopacket(sección 5).
Invocado por /flagrare:career. Los argumentos nombran un modo (first_run, resume o refresh) y las secciones en las que trabajar: haga solo esas. Cuando además dicen scheduled, nunca entreviste ni pregunte: investigue de nuevo y guarde solo las secciones que no requieren respuesta del usuario (proceso, calendario, rúbrica, organización, precedente), y devuelva cada una que necesite al usuario (objetivo, personas, preguntas para el gerente) como una línea para la lista de Necesidades del coordinador. En cualquier caso, devuelva un resumen breve de lo que cambió en lugar del mapa completo.
2. Reglas para cada hecho
- Fuente, fecha, estado. Cada hecho tiene un enlace o ubicación citada, la fecha en que lo verificó y un estado:
verified(leído y citado textualmente de la fuente original),unverified(un resumen, fragmento o información de segunda mano) oinferred(su razonamiento). - Cite textualmente la fuente original. Las herramientas de obtención de datos resumen y parafrasean. Cuando se vaya a confiar en una cita, vuelva a leer la página original (por ejemplo, el JSON o HTML de la página) y confirme las palabras exactas.
- Muestre conflictos, nunca elija en silencio. Cuando dos fuentes discrepen (un organigrama frente a un directorio de equipo, una página de proceso frente al archivo de la escalera), almacene ambas como
alternativese informe al usuario. - "No se encontró nada" es un resultado válido. Si un paso no encuentra nada, añada una pregunta concreta a
manager_questionsen lugar de adivinar. Muchas empresas no tienen un proceso escrito. - Los datos sobre personas son sensibles. Solo lea las interacciones del propio usuario. Registre quién tiene contexto de primera mano sobre el trabajo del usuario, nunca una clasificación de lo útiles que son las personas.
- Pida consentimiento antes de usar el navegador en portales de RR. HH. o sitios internos.
3. Primera ejecución
Advierta al usuario desde el principio: la primera ejecución es larga, a menudo una hora o más, y guarda después de cada fase, por lo que se puede detener y reanudar.
Cada guardado escribe tanto promotion-map.json como promotion-map.md, y establece sections.<nombre>.checked_at (hoy) y sections.<nombre>.sources para cada sección escrita en esa fase. Una sección sin checked_at se considera obsoleta. La Fase 1 escribe target, process y calendar; la Fase 2 escribe rubric; la Fase 3 escribe org, people y precedent; la Fase 4 escribe packet_readiness y manager_questions. Escriba cada sección incluso cuando no se haya encontrado nada (una lista vacía u objeto con su checked_at), de modo que una sección vacía no se confunda con una ejecución interrumpida.
Fase 1: Objetivo, proceso y calendario
- Entreviste primero, antes de cualquier investigación. Haga una pregunta a la vez:
- Nivel actual y nivel objetivo.
- Trayectoria: contribuidor individual o gerente.
- ¿A qué ciclo apunta? (Vuelva a esto después del paso 4, una vez que conozca el calendario, y proponga uno).
- Por qué lo quiere, qué trabajo quiere más y qué quiere menos.
- Busque dos datos sobre el nivel objetivo: ¿es terminal en esta empresa (no se espera una promoción más allá de él)? y ¿cuál es la banda de tiempo esperada en el nivel actual? Cite ambos.
- Explique qué cambia el "por qué". Un objetivo terminal más un "por qué" de tranquilidad hacen del objetivo la meta final. Un "por qué" de dinero o alcance significa planificar más allá de él. Escriba esto en la sección 1 del mapa.
- Encuentre el proceso, el calendario y la plantilla del packet en cada fuente conectada: wiki, documentos, anuncios de chat, notas de reuniones, el portal de RR. HH. (con consentimiento). También encuentre cómo se toman las decisiones de producto: el documento de decisión y quién suele impulsarlo. Opportunity-scan necesita esto.
También encuentre qué mide la dirección: los temas o documentos de estrategia de la empresa, OKR y documentos de planificación, y lo que dicen las reuniones de planificación y las reuniones generales (en notas de reuniones como Granola, cuando está conectado). Registre cada métrica que sea importante para el área del usuario en
priorities: el tema, la métrica, su línea base y objetivo cuando estén escritos (cada uno un hecho con una fuente), el equipo que la posee, yuser_lever:ownersi el puesto del usuario posee la entrada principal de la métrica,inputsi sus sistemas la alimentan,nonesi la palanca está en otro equipo. Opportunity-scan clasifica las propuestas contra esta lista. Tome las prioridades de las notas de reuniones, nunca de citas sobre personas. - Guarde el mapa (JSON y markdown) con las entradas
target,process,calendarysectionscompletadas.
Fase 2: Brecha de rúbrica
- Encuentre el artefacto con el que los gerentes evalúan (una hoja de cálculo de escalera, un libro de trabajo de check-in), no la prosa escrita al respecto. Pregunte al usuario si su gerente usa un libro de trabajo de check-in. Si la prosa y el artefacto discrepan, use el artefacto y registre la discrepancia en
rubric.prose_mismatches. - Construya una entrada
rubric.rowspor comportamiento: el texto del nivel actual, el texto del nivel objetivo, un id estable (<area>.<short-slug>) y unalabel, el comportamiento en dos a cuatro palabras llanas ("Encontrar problemas", "Revisor buscado"), que el tablero y los resúmenes muestran en lugar del id. - Marque cada fila como
done,partialonot_started, con evidencia decareer_state.py contributions, reconocimiento que los compañeros dieron al usuario (cuando una herramienta de reconocimiento está configurada, ver "Reconocimiento" más abajo: cada bonus con su enlace es una prueba, y el valor de la empresa con el que está etiquetado apunta al comportamiento de valores fundamentales), las reseñas y el trabajo del usuario, y las notas de reseñas anteriores que el usuario comparta. - Guarde.
Fase 3: Organización y quién conoce tu trabajo
- Organización: la cadena del usuario, quién está por encima de cada equipo al que podría llegar, y los cambios próximos (salidas, nuevos líderes, reorganizaciones a partir de notas de reuniones y anuncios). Cada persona tiene una fuente y un estado.
- Quién conoce tu trabajo, evidencia primero, luego el usuario:
- Proponga personas a partir de las interacciones del propio usuario (reseñas dadas y recibidas, hilos compartidos, reuniones compartidas y todos los que le dieron reconocimiento), cada una con enlaces de evidencia. Una persona que reconoció al usuario ha visto su trabajo de primera mano; marque a cualquiera de ellos que esté en el comité de promoción.
- Pida al usuario que confirme y corrija, y que añada lo que ninguna herramienta puede ver, como un ex gerente o un equipo de hackathon.
- Establezca
seen_your_workyconfirmed_by_user.
- Quién está en la calibración: infiéralo del documento de proceso, cite la frase y márquelo como
inferred. Enumere las personas en la sala que no han visto el trabajo del usuario. - Precedente: lea los anuncios de promoción recientes para ver qué se acreditó, y escriba "los anuncios son narrativas, no auditorías" en el mapa. Ofrezca el nivel profundo solo si el usuario lo solicita: verificación cruzada en código, documentos y tickets de quién originó realmente el trabajo. Es costoso y está desactivado por defecto.
- Guarde.
Fase 4: Plan
- Fechas límite: ejecute
deadlines.pycon la fecha límite del packet. Si la fecha de este ciclo está publicada, úsela y pase--published. De lo contrario, proyecte la fecha del año pasado en este ciclo (mismo mes y día, un año después) y déjela comoinferred. Pregunte al usuario qué ventanas de vacaciones o días libres son tiempo muerto donde está, y páselas como--dead. Registre "cómodo antes de X, absoluto antes de Y" con su estado y condición. Si el estado espast, dígalo claramente y nombre el próximo ciclo. - Un siguiente paso por fila abierta: para cada fila que no esté
done, escribanext_step: la única acción concreta más barata que añadiría evidencia, adaptada a lo que encontró sobre la empresa ("escribe /interview en el canal de reclutamiento", "ofrece una sesión de emparejamiento en el panel del partner", "pide a tu gerente una parte de la hoja de ruta para co-liderar"). El tablero enumera las tres brechas más grandes con estos pasos, así que haga que cada uno se pueda hacer en una semana, no una meta. - Preparación del packet: ejecute
python3 <plugin root>/lib/career/coordinator.py readiness --home "$HOME" --today <date>para obtener el recuento de evidencia de cada fila de rúbrica (entradas de registro etiquetadas con la fila más la evidencia de la propia fila), luego marque cada sección de la plantilla comostrong,thinoemptysegún las filas de las que se basa. - Selecciones de comentarios de compañeros: de
recognition.py summary, las personas que más reconocieron al usuario y por qué son los primeros candidatos para los comentarios de compañeros del caso escrito (de 3 a 5); añádalos a la nota de Comentarios de Compañeros. - Preguntas para el gerente: todo lo que aún se desconoce, más la pregunta sobre la preparación ("¿es realista , y qué falta?").
- Ejecute
map_schema.py check. Corrija cualquier error, luego guarde. - Muestre al usuario un resumen breve: el objetivo, las dos fechas de conversación, los comportamientos de Senior aún no mostrados (por etiqueta), quién aún necesita ver su trabajo y las preguntas para su gerente. Señale
promotion-map.md.
4. Actualización
- Ejecute
map_schema.py check, y leacareer/flags.jsonsi existe (otras habilidades escriben allí señales de obsolescencia, como una reorganización, una salida o un calendario publicado). Actualice el reconocimiento conpython3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD>(aplique su escritura planificada decareer/recognition.jsoncon la herramienta de escritura; necesita red) cuando una herramienta de reconocimiento esté configurada. - Re-investigue solo las secciones obsoletas o marcadas. Mantenga todas las demás secciones como están.
- Pregunte al usuario "¿algo cambió?", cubriendo objetivo, gerente, equipo y las personas que han visto su trabajo.
- Si la sección de calendario se vuelve a verificar, o una bandera dice que el calendario se publicó, vuelva a ejecutar
deadlines.pyy actualicecalendar.manager_conversation. - Actualice el
next_stepde cada fila abierta cuando la evidencia para ella haya cambiado (un paso que está hecho o ya no es el más barato se reemplaza), y añada cualquierlabelfaltante. - Actualice
checked_atpara cada sección re-verificada, limpie las banderas que gestionó y guarde.
Reconocimiento
Cuando la empresa del usuario usa una herramienta de reconocimiento entre pares (hoy en día Bonusly), sus agradecimientos son prueba de que el usuario no tuvo que registrarlo. Configuración: el usuario crea un token de API personal en la herramienta y lo guarda en ~/.config/flagrare/bonusly-token (o el archivo nombrado por skills.career.recognition.token_file en config.json). Nunca almacene el token en config.json o un repositorio, y nunca lo pegue en el chat. Luego ejecute python3 <plugin root>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD> (aplique su escritura planificada de career/recognition.json con la herramienta de escritura; necesita red); recognition.py summary da totales, valores de la empresa y quién reconoció más al usuario; los agradecimientos de las cuentas automáticas de la herramienta (cumpleaños, aniversarios, bienvenidas) se cuentan por separado y nunca se tratan como personas ni pruebas. Cite solo lo que se dice sobre el usuario. Nunca se envía nada a través de la herramienta.
5. Modo packte (/flagrare:promotion packet)
Cuando se acerque la fecha límite del packet, o el usuario lo solicite:
- Cargue el mapa; si no hay ninguno, primero ejecute la primera ejecución. Reúna evidencia desde la fecha de la última promoción (o la fecha de contratación): use
/flagrare:brag-docpara ventanas de hasta un mes y/flagrare:impact-timelinepara ventanas más largas. - Redacte el packet en la plantilla de la empresa, a partir de
process.packet_template(si se desconoce la plantilla, use esta forma común y diga que es un respaldo: los campos de encabezado, luego 2-3 proyectos (rol, estimación...).
El contenido ha sido truncado; para la versión completa consulte la SKILL.md original.