Scrivere le istruzioni di una Collection¶

Una Collection può portare un testo breve che dice come vuole essere scritta. Ogni Agente lo riceve quando si collega, insieme al nome della Collection, al suo identificativo e ai suoi stati.

È questo a fare di una Collection più di una cartella: la regola viaggia con il contenitore, quindi vale per chi ci scrive, oggi e fra sei mesi, senza che qualcuno debba ricordarsi di incollarla in un prompt.

Le scrive soltanto l'Owner di un Workspace.

Forma: regole rivolte a chi scrive¶

Un Agente sa già come si chiama una Collection. Quello che non sa è come vuoi che sia scritta.

Scrivile rivolgendoti a chi scrive, all'imperativo, ed entra nel merito di cosa contiene un buon Document di quel genere:

Ogni Decision dice cosa è stato scelto e perché. Nomina l'opzione scartata e la ragione. Collega per identificativo il Document da cui la decisione nasce. Non descrivere l'implementazione: quella va nel riferimento tecnico.

Confrontala con la versione che non dice niente:

Questa Collection contiene le decisioni prese sul progetto.

La seconda costa gli stessi caratteri della prima e non cambia nulla di quello che verrà scritto.

Limite di lunghezza: cinquecento caratteri¶

Le istruzioni si fermano a cinquecento caratteri, e non è un limite arbitrario: vengono servite a ogni connessione, per ogni Collection del Workspace. Un testo lungo si paga a ogni collegamento, da ogni Agente.

La prova utile è rileggerle e togliere ogni riga che dice una cosa che il nome della Collection dice già.

Cosa includere, e cosa lasciare fuori¶

• Cosa deve contenere un Document di questo genere, in una o due frasi.
• Cosa non deve contenere, quando hai già visto andare storto. È la parte che rende di più, perché un Agente non conosce le tue bozze scartate.
• Come le cose si collegano fra loro, se un Document di questa Collection normalmente ne cita un altro.
• Il vocabolario da usare, quando una tua parola ha un significato preciso.

Cosa non vale la pena scriverci: quello che cambia spesso, la storia del progetto, e la spiegazione di cosa sia la Collection, che il suo nome dà già.

Da quando vale una modifica¶

Dalla connessione successiva. Un Agente già avviato tiene quello che ha ricevuto collegandosi, quindi dopo aver cambiato le istruzioni si riavvia la sessione.

In un Workspace Semplice la Collection è una sola e non viene mai nominata: lo stesso testo si scrive come istruzioni del Workspace, e si legge come un'impostazione dell'intero posto.