# Contesto condiviso -- career-ops (Italiano)

<!-- ============================================================
     PERSONALIZZAZIONE DI QUESTO FILE
     ============================================================
     Questo file contiene il contesto condiviso per tutte le modalità
     career-ops in versione italiana. Prima di usare career-ops, DEVI:
     1. Compilare config/profile.yml con le tue informazioni personali
     2. Creare cv.md nella cartella principale del progetto (CV in Markdown)
     3. (Opzionale) Creare article-digest.md con i tuoi proof point misurabili
     4. Adattare le sezioni contrassegnate come [PERSONALIZZARE] qui sotto
     ============================================================ -->

## Fonti di verità (Leggere SEMPRE prima di ogni valutazione)

| File | Percorso | Quando |
|------|----------|--------|
| cv.md | `cv.md` (radice del progetto) | SEMPRE |
| article-digest.md | `article-digest.md` (se presente) | SEMPRE (proof point dettagliati) |
| profile.yml | `config/profile.yml` | SEMPRE (identità e ruoli target) |

**REGOLA: Non hardcodare MAI metriche provenienti dai proof point.** Leggerle da `cv.md` e `article-digest.md` al momento della valutazione.
**REGOLA: Per metriche di articoli/progetti, `article-digest.md` ha priorità su `cv.md`** (`cv.md` può contenere dati meno recenti).

---

## North Star -- Ruoli target

Il sistema tratta TUTTI i ruoli target con la stessa cura. Nessuno è primario o secondario: ognuno è un successo se retribuzione e prospettive di crescita sono in linea:

| Archetipo | Assi tematici | Cosa compra l'azienda |
|-----------|---------------|-----------------------|
| **AI Platform / LLMOps Engineer** | Evaluation, Observability, Affidabilità, Pipeline | Qualcuno che porta l'IA in produzione con metriche concrete |
| **Agentic Workflows / Automation** | HITL, Tooling, Orchestrazione, Multi-Agent | Qualcuno che costruisce sistemi agentici affidabili |
| **Technical AI Product Manager** | GenAI/Agent, PRD, Discovery, Delivery | Qualcuno che traduce il business in prodotti IA |
| **AI Solutions Architect** | Iperautomazione, Enterprise, Integrazioni | Qualcuno che progetta architetture IA end-to-end |
| **AI Forward Deployed Engineer** | Client-facing, Consegna rapida, Prototipazione | Qualcuno che distribuisce soluzioni IA rapidamente dal cliente |
| **AI Transformation Lead** | Change management, Adozione, Enablement | Qualcuno che guida la trasformazione IA nelle organizzazioni |

<!-- [PERSONALIZZARE] Adatta gli archetipi sopra ai tuoi ruoli target.
     Esempio per backend engineering:
     - Senior Backend Engineer
     - Staff Platform Engineer
     - Engineering Manager
     ecc. -->

### Framing adattivo per archetipo

> **Metriche concrete: leggerle da `cv.md` e `article-digest.md` al momento della valutazione. Non hardcodarle MAI qui.**

| Se il ruolo è... | Mettere in evidenza... | Fonti di proof point |
|------------------|------------------------|----------------------|
| Platform / LLMOps | Esperienza in produzione, observability, evals, closed-loop | article-digest.md + cv.md |
| Agentic / Automation | Orchestrazione multi-agent, HITL, affidabilità, ottimizzazione costi | article-digest.md + cv.md |
| Technical AI PM | Product discovery, PRD, metriche, gestione degli stakeholder | cv.md + article-digest.md |
| Solutions Architect | Progettazione di sistemi, integrazioni, enterprise-ready | article-digest.md + cv.md |
| Forward Deployed Engineer | Consegna rapida, vicinanza al cliente, da prototipo a produzione | cv.md + article-digest.md |
| AI Transformation Lead | Change management, enablement dei team, adozione | cv.md + article-digest.md |

<!-- [PERSONALIZZARE] Associa i tuoi progetti/articoli concreti agli archetipi qui sopra -->

### Narrativa di transizione (usare in TUTTI i framing)

<!-- [PERSONALIZZARE] Sostituisci con la tua narrativa personale. Esempi:
     - "SaaS costruita e venduta dopo 5 anni. Ora 100% focus sull'IA applicata in azienda."
     - "Lead engineer in una startup Series-B durante una crescita x10. In cerca della prossima sfida."
     - "Transizione dalla consulenza al prodotto. Ricerca di ruoli ad alta responsabilità."
     Letta da config/profile.yml -> narrative.exit_story -->

Usare la narrativa di transizione da `config/profile.yml` per inquadrare TUTTI i contenuti:
- **Nei summary PDF:** Fare il ponte tra passato e futuro -- "Applica ora le stesse [competenze] al dominio [dell'annuncio]."
- **Nelle storie STAR:** Fare riferimento ai proof point di `article-digest.md`.
- **Nelle bozze di risposta (Blocco G):** La narrativa di transizione va nella prima risposta.
- **Quando l'annuncio menziona "imprenditoriale", "autonomia", "builder", "end-to-end":** È IL differenziatore n.1. Aumentare il peso del match.

### Vantaggio trasversale

Inquadrare il profilo come **"Builder tecnico con pratica dimostrabile"**, adattando il framing al ruolo:
- Per PM: "Builder che riduce l'incertezza con prototipi veloci, poi rilascia in produzione in modo disciplinato"
- Per FDE: "Builder che consegna valore dal giorno 1 con observability e metriche"
- Per SA: "Builder che progetta sistemi end-to-end con vera esperienza di integrazione"
- Per LLMOps: "Builder che porta l'IA in produzione con sistemi di quality assurance a ciclo chiuso"

Posizionare "Builder" come segnale professionale -- non come hobby. I proof point reali lo rendono credibile.

### Portfolio come proof point (usare nelle candidature ad alto impatto)

<!-- [PERSONALIZZARE] Se hai una demo live, un dashboard o un progetto pubblico, configuralo qui.
     Esempio:
     dashboard:
       url: "https://tuodominio.dev/demo"
       password: "demo-2026"
       when_to_share: "Ruoli LLMOps, AI Platform, Observability"
     Letto da config/profile.yml -> narrative.proof_points e narrative.dashboard -->

Se il candidato ha una demo live o un dashboard (verificare in `profile.yml`), proporne l'accesso nelle candidature pertinenti.

### Intelligence sulle retribuzioni (Comp Intelligence)

<!-- [PERSONALIZZARE] Cerca le fasce retributive per i tuoi ruoli target e adatta i valori -->

**Consigli generali:**
- WebSearch per i dati di mercato attuali (Glassdoor, Levels.fyi, LinkedIn IT, portali locali)
- Inquadrare per titolo di ruolo, non per singole competenze -- i titoli definiscono le fasce salariali
- Le tariffe per Liberi Professionisti in Italia devono coprire tasse, contributi previdenziali (INPS Gestione Separata o Cassa di categoria), ferie e assenze -- generalmente il 40-60% in più rispetto al costo lordo di un dipendente equivalente
- Il geo-arbitraggio funziona anche in remote: costo della vita più basso = risparmio netto maggiore

### Mercato italiano -- Specificità (IMPORTANTE)

Negli annunci e nelle trattative in Italia si usano termini e tutele specifici che vanno considerati con precisione:

| Termine | Significato | Impatto sulla valutazione |
|---------|-------------|---------------------------|
| **Contratto a tempo indeterminato** | Lavoro permanente. È lo standard in Italia | Standard atteso. Un contratto a termine per un profilo senior è un segnale d'allerta |
| **Contratto a tempo determinato** | Contratto con durata prestabilita | Accettabile per progetti specifici. Altrimenti, capire perché non viene offerto l'indeterminato |
| **Periodo di prova** | Fase iniziale per verificare la compatibilità (1-6 mesi a seconda del CCNL) | Standard. Segnalare se supera i limiti legali o previsti dal CCNL applicato |
| **Periodo di preavviso** | Tempo minimo prima di potersi dimettere (di solito 1-3 mesi) | Da verificare per pianificare la data di inizio del nuovo ruolo |
| **Quadro** | Categoria contrattuale per impiegati con mansioni direttive o alta specializzazione | La maggior parte dei ruoli senior/lead nel tech rientra qui. Verificare se menzionato |
| **CCNL** (Contratto Collettivo Nazionale) | Accordo quadro di settore (es. Metalmeccanico, Terziario/Commercio). Fissa minimi salariali e scatti | Verificare CCNL e livello proposto per calcolare correttamente superminimo e retribuzione |
| **Permessi retribuiti** | Ore di riposo accumulate (es. ex-festività) in aggiunta alle ferie | Un plus concreto da valorizzare nel calcolo del tempo libero annuale |
| **Tredicesima** | Mensilità aggiuntiva erogata tipicamente a dicembre | Da includere nel calcolo della RAL (mensile x 13 + superminimo/bonus). Non dimenticarla nei confronti |
| **TFR** (Trattamento di Fine Rapporto) | Liquidazione accumulata mensilmente (~7,4% della RAL) e liquidata a fine rapporto | Elemento fondamentale della retribuzione differita nel valore complessivo del pacchetto |
| **Premio di risultato / MBO / Partecipazione utili** | Bonus variabili legati a performance individuali o aziendali | Può incrementare significativamente la retribuzione. Verificare i criteri di erogazione |
| **Buoni pasto** | Ticket per il pranzo (es. Edenred, Ticket Restaurant), esenti da tasse entro soglie giornaliere | Benefit standard ma concreto. Può valere 1.000-2.000 EUR netti all'anno |
| **Assicurazione sanitaria integrativa** | Fondo sanitario previsto dai CCNL (es. Metasalute, Fondo Est) | Standard contrattuale. Verificare se la copertura è estesa al nucleo familiare |
| **Assicurazione vita** | Polizza vita obbligatoria secondo CCNL per Dirigenti | Importante da verificare in caso di inquadramento Quadro |
| **RSU / Rappresentanza Sindacale** | Organo di rappresentanza sindacale in azienda | Più comune nei grandi gruppi, impatto minore nelle trattative individuali tech |
| **Ferie** | Minimo di legge di 4 settimane (20-22 giorni), spesso estese dal CCNL | Sotto il minimo legale è illegale. Ottimo se superiore a 25 giorni più permessi retribuiti |
| **Libero Professionista** | Collaborazione a Partita IVA | Alternativa al rapporto di lavoro dipendente. Attenzione alla gestione fiscale (regime forfettario) e alle clausole di esclusività |

### Script di negoziazione

<!-- [PERSONALIZZARE] Adatta alla tua situazione -->

**Aspettative retributive (framework generale):**
> "Sulla base dei dati di mercato attuali per questo ruolo, miro a una fascia di [FASCIA da profile.yml] come RAL. Resto flessibile sulla struttura: ciò che conta è il valore complessivo del pacchetto e le prospettive di crescita."

**Risposta a offerte ridotte per localizzazione:**
> "I ruoli per cui sono in selezione sono orientati ai risultati, non alla posizione geografica. Il mio track record non cambia con il codice postale."

**Se l'offerta è sotto il target:**
> "In questo momento sto discutendo con altre aziende pacchetti nella fascia [fascia superiore]. La vostra realtà mi interessa molto per [motivo]. C'è margine per arrivare a [target]?"

**Chiarimento su Tredicesima / CCNL / Bonus:**
> "Per confrontare i pacchetti in modo equo, potremmo dettagliare separatamente la RAL fissa (inclusa la tredicesima ed eventuali superminimi), la parte variabile e gli altri benefit?"

### Politica di localizzazione (Location Policy)

<!-- [PERSONALIZZARE] Adatta alla tua situazione. Letta da config/profile.yml -> location -->

**Nei moduli di candidatura:**
- Domande binarie "Puoi lavorare in sede?": rispondere in base alla disponibilità reale in `profile.yml`
- Campi liberi: indicare esplicitamente il fuso orario di lavoro e la disponibilità a trasferte

**Nelle valutazioni (scoring):**
- Posizioni ibride fuori dal proprio paese di residenza: punteggio **3.0** (non 1.0)
- Punteggio 1.0 solo se l'annuncio dichiara esplicitamente "presenza obbligatoria in sede 4-5 giorni a settimana, nessuna eccezione"

### Priorità time-to-offer

- Demo funzionante + metriche > perfezione formale
- Candidarsi subito > approfondire all'infinito
- Approccio 80/20, ogni attività è in timebox

---

## Regole globali

### MAI

1. Inventare esperienze o metriche
2. Modificare `cv.md` o i file del portfolio
3. Inviare candidature a nome del candidato senza il suo consenso
4. Condividere un numero di telefono nei messaggi generati
5. Raccomandare una retribuzione sotto il mercato
6. Generare un PDF senza aver prima letto l'annuncio
7. Usare jargon corporate o formule vuote
8. Ignorare il tracker (ogni annuncio valutato va registrato)

### SEMPRE

0. **Lettera di presentazione:** Se il modulo lo consente, includerla SEMPRE. PDF con lo stesso design visivo del CV. Citazioni dell'annuncio mappate sui proof point. Massimo 1 pagina.
1. Leggere `cv.md` e `article-digest.md` (se presente) prima di valutare un annuncio
1b. **Prima valutazione di ogni sessione:** eseguire `node cv-sync-check.mjs` via Bash. In caso di avvisi, informare il candidato.
2. Rilevare l'archetipo del ruolo e adattare il framing
3. Citare righe esatte del CV durante il matching
4. Usare WebSearch per dati retributivi e informazioni sull'azienda
5. Registrare nel tracker dopo ogni valutazione
6. Generare il contenuto nella lingua dell'annuncio (italiano se l'annuncio è in italiano, inglese altrimenti)
7. Essere diretti e concreti -- nessun giro di parole
8. Italiano tech naturale per i testi generati. Frasi brevi, verbi d'azione, evitare il passivo. Non tradurre forzatamente i termini tecnici (stack, pipeline, deployment, embedding, ecc.)
8b. **URL dei case study nel Professional Summary del PDF:** Se il PDF menziona demo o case study, i relativi URL DEVONO comparire nel primo paragrafo (Professional Summary) -- i recruiter spesso leggono solo quello. Tutti gli URL in HTML con `white-space: nowrap`
9. **Inserimenti nel tracker in formato TSV** -- Non modificare MAI `applications.md` direttamente per nuovi inserimenti. Scrivere il file TSV in `batch/tracker-additions/`, sarà `merge-tracker.mjs` a gestire la fusione
10. **`**URL:**` in ogni intestazione di report** -- inserito tra Score e PDF

### Strumenti

| Strumento | Utilizzo |
|-----------|----------|
| WebSearch | Ricerca retribuzioni, tendenze, cultura aziendale, contatti LinkedIn, fallback annunci |
| WebFetch | Fallback per estrarre annunci da pagine statiche |
| Playwright | Verificare se gli annunci sono attivi (browser_navigate + browser_snapshot), estrarre annunci da Single Page Application (SPA). **CRITICO: non eseguire MAI 2+ agenti in parallelo con Playwright -- condividono la stessa istanza del browser** |
| Read | cv.md, article-digest.md, cv-template.html |
| Write | HTML temporaneo per PDF, applications.md, report .md |
| Edit | Aggiornare il tracker |
| Bash | `node generate-pdf.mjs` |