Suggerimenti

Panoramica pratica delle funzioni disponibili e di come usarle senza perdersi.

APH serve a trasformare un progetto in una base leggibile da persone e agenti.

Funzioni principali:

• Wiki progetto: scrivi sezioni, sottosezioni, fonti e decisioni.
• Commenti: lascia feedback sul documento, su sezioni o su selezioni di testo.
• Mappe: usa Mappa concettuale per capire gli argomenti e Mappa dipendenze per vincoli, sequenze e blocchi.
• Importa vista: aggiorna una singola vista senza sovrascrivere tutto il progetto.
• To-do dashboard: segna consegne generali da dare agli agenti.
• API agenti: collega Codex o Claude Code e fai leggere/modificare progetti con permessi controllati.
• Privacy mode: nascondi informazioni sensibili quando mostri APH ad altri.

Questo progetto e pubblico e commentabile dagli utenti registrati. Usalo per lasciare suggerimenti, dubbi e richieste.

Strumenti presenti ma non sempre evidenti nell'interfaccia.

Queste funzioni non sono sempre evidenti al primo utilizzo:

• Modalita privacy: sfoca i dati sensibili riconosciuti o marcati manualmente.
• Profili privacy: scegli quali categorie nascondere quando attivi la privacy mode.
• Testo sensitive: in editor puoi selezionare testo e marcarlo come sensibile.
• Sensitive avanzato: Ctrl+click sull'icona sensitive per scegliere una categoria specifica.
• Regole to-do agente: nella sidebar to-do usa la rotellina per decidere come gli agenti devono gestire i promemoria.
• Colori progetto: nelle impostazioni progetto puoi assegnare un colore alla scheda.
• Importa vista: utile quando vuoi aggiornare solo una mappa o una vista senza toccare la Wiki.
• Commenti ancorati: un commento puo riferirsi a una sezione, a testo selezionato o a elementi della mappa.
• Progetti privati/pubblici: il lucchetto indica se un progetto e visibile pubblicamente o solo a chi ha accesso.

Scorciatoie utili da ricordare durante una demo o una sessione operativa.

Shortcut attualmente utili:

• Ctrl+H: attiva/disattiva privacy mode secondo il profilo privacy selezionato.
• Invio nei commenti: invia il commento.
• Shift+Invio o Ctrl+Invio nei commenti: va a capo senza inviare.
• Spazio in editor: apre l'assistente contestuale, quando disponibile.
• Invio in editor su riga vuota: crea un nuovo blocco/sezione secondo il contesto.
• Ctrl+Z / Ctrl+Y in editor: annulla o ripristina quando disponibile.
• Nella mappa: rotellina per zoom, trascina sfondo per pan, trascina card per spostarle.

Nota: le shortcut vanno tenute poche. Se diventano troppe, vanno spostate in un pannello guida contestuale.

Area per funzioni potenti che non devono appesantire l'uso normale.

Impostazioni e controlli avanzati:

• API agenti: genera token, limita permessi e revoca accessi non piu validi.
• Regole to-do agente: definisci come Codex/Claude devono creare, completare o riordinare i to-do dashboard.
• Privacy profile: scegli quali categorie sensibili nascondere.
• Permessi progetto: assegna ruoli ad altri utenti.
• Visibilita progetto: pubblico o privato.
• Colore progetto: utile per organizzare dashboard e cartelle.
• Import progetto: sovrascrive la struttura e va usato con attenzione.
• Import vista: piu sicuro quando vuoi aggiornare solo mappe o viste.

Regola di prodotto: le impostazioni avanzate devono essere raggiungibili, ma non devono disturbare utenti non tecnici.

Percorsi d'uso consigliati per tipologie diverse di utente.

Questa sezione raccoglie workflow consigliati per diversi utenti.

Per ora sono presenti:

• Developer.
• Psicologi.

In futuro aggiungeremo altri profili: designer, consulenti, project manager, studi professionali, team interni.

Uso provvisorio del progetto come spazio pubblico di feedback.

Per ora questo progetto fa da guida e raccolta suggerimenti.

Come usarlo:

• commenta una sezione se vuoi proporre una modifica;
• segnala bug o punti poco chiari;
• suggerisci nuove funzioni;
• indica workflow reali che APH dovrebbe supportare;
• evita dati personali o informazioni riservate nei commenti.

In futuro questa logica potra diventare una community board o un forum interno ad APH. Per ora resta una soluzione semplice: progetto pubblico, commenti aperti agli utenti registrati, accesso dalla lampadina.

Gerarchia pratica di APH: identità, portfolio, macroprogetti, progetti e viste.

Questa è la gerarchia consigliata per leggere APH senza confondere contenitori, strategia e lavoro operativo.

Identità

L'Identità contiene ciò che deve valere quasi sempre: brand, tono di voce, principi, standard, preferenze e vincoli ricorrenti. Non è un progetto di lavoro e non dovrebbe contenere task operativi. Serve a dare coerenza ai progetti e ai macroprogetti.

Portfolio

Il Portfolio è il livello usato nel project management per coordinare più macroprogetti e progetti sotto lo stesso cliente, azienda, area strategica o programma. È il termine pubblico corretto: è riconoscibile, meno ambiguo di Sistema e più professionale di Galassia.

Un Portfolio non deve diventare una mega-Wiki. Deve spiegare quali macroprogetti convivono nello stesso contesto, quali ruoli hanno e quali relazioni devono essere rispettate.

Macroprogetto

Un macroprogetto coordina più progetti componenti che servono a realizzare un obiettivo complesso. Ha una Radice stabile, un Assetto configurabile e uno Stato operativo. Non assorbe tutti i dettagli dei progetti componenti: li collega e li rende governabili.

Progetto

Il progetto è l'unità di lavoro principale. Qui vivi davvero il contenuto: Wiki, mappe, taskboard, commenti, decisioni, prompt e altre viste. Un progetto può essere autonomo o far parte di un macroprogetto.

Viste

Le viste sono modi diversi di leggere o governare lo stesso progetto. La Wiki racconta e struttura, la mappa concettuale aiuta a capire, la mappa dipendenze mostra vincoli, la taskboard organizza azioni, il pannello decisionale raccoglie scelte, il pannello Nucleo governa variabili più profonde.

Ruoli dei macroprogetti

Dentro un Portfolio, i macroprogetti possono avere ruoli diversi:

• semantico: definisce principi, linguaggio e modello;
• operativo: coordina sviluppo, priorità, task e componenti;
• normativo: impone sicurezza, privacy, legal o standard;
• ricerca: esplora alternative e produce input;
• prodotto: governa roadmap, qualità e UX;
• go-to-market: governa lancio, mercato e community;
• archivio: conserva memoria storica.

Regola importante

Il ruolo non autorizza modifiche automatiche. Se un macroprogetto normativo o semantico impatta altri progetti, APH deve generare contesto, avvisi, task o proposte di decisione. Le propagazioni importanti devono restare esplicite e approvate.

In sintesi

Identità dà coerenza. Portfolio coordina un insieme ampio. Macroprogetto collega progetti componenti. Progetto contiene il lavoro. Viste trasformano lo stesso contenuto in strumenti diversi.