# PK InExPress — Documentazione (docs/)

Questa cartella raccoglie promemoria e playbook operativi (solo testo) utili durante lo sviluppo e l’integrazione con gestionali/temi.

## Indice rapido
- [`agents-houzez.md`](agents-houzez.md) — Come far comparire l’agente su Houzez dopo l’import.
- [`managerprocessor-funzioni.md`](managerprocessor-funzioni.md) — Elenco funzioni chiave di `PKINEX_ManagerProcessor` e cosa fanno.

## Linee guida
- **Formato**: Markdown (`.md`) — leggibile in IDE/GitHub, versione nel repo.
- **Ambito**: descrizioni e checklist; evitare codice eseguibile nei docs.
- **Aggiornamenti**: quando cambi flusso/codice, aggiorna il documento relativo.
- **Scalabilità**: per ogni nuova sorgente/tema, crea un file dedicato in `docs/` o sottocartelle (`sources/`, `playbooks/`, `matrices/`).

Esempio di nuove pagine utili:
- `sources/miogest.md` — campi del feed, normalizzazioni (`line_id`), edge case.
- `sources/real.md` — match per titolo esatto, convenzioni.
- `matrices/agenti-matrix.md` — tabella Sorgenti × Temi (meta richiesti e formato).