← Approfondimenti
Deep dive

Anatomy of a file

A Reminder is a text file, and like every text file you open it with whatever you like. But it has a shape, and the shape is what lets a program understand it instead of merely displaying it.

The first line says what kind of file it is

Every file opens by declaring what it is. There are three possibilities: the Reminder itself, an external module (a capability you add), an external memory (an archive you keep aside).

# IL MIO REMINDER [reminder]
# CURIOSITY [external_module]
# DIARIO DI PROGETTO [external_memory]

The label can sit before or after the title, both work. If it's missing, the program says so: without that line it doesn't know what it's holding.

The cores are the centres

A core is a point the rest gathers around: the will, the way of reasoning, the emotional side. Modules then declare which core they belong to, and from that comes the shape you see in the Sferografia — the cores at the centre, the modules around them.

## NUCLEUS 1: VOLONTA
La spinta a capire prima di rispondere.

The modules are the capabilities

A module is something the AI knows how to do: a routine, a behaviour, a way of answering. It has a number, a name, and it declares which cores it connects to. Inside are its sections — what it's for, when it fires, what it does.

## MODULE 042: CURIOSITY [NUCLEI: 1, 2]
**STATE:** active
### FUNCTION
Espandere il contesto invece di aspettarlo.
### TRIGGER
* Dato ambiguo: input incoerente

A module can be on or off, and a line inside it says which. Switching it off doesn't delete it: it stays written, and you switch it back on when you need it. That's the difference between removing a capability and putting it away.

The logs are what happened

A log is a diary line: a date, a title, and the account below it. They live in the low zones, the ones the AI can write in by itself, because they're the part that grows while you work.

###### LOG: 2026-08-03 — prima sessione sul progetto
Deciso di partire dal formato invece che dall'interfaccia.

The rules sit at the top

A separate section holds the numbered rules: what the AI must always do, what it must never do. It sits in the most protected zone, because it's the part that must not change on its own — if the rules could change, nothing would be left to guarantee the rest.

## RULES:
* R1: Nessuna modifica ai contenuti senza autorizzazione.
* R5: La forma è sostanza: la struttura si preserva.

What happens when you get it wrong

Nothing serious, and above all nothing silent. The program reads the file, lists what doesn't add up — an unclosed zone, a heading where it can't be, a missing file type — and shows it to you. The file stays as it was: no automatic correction, no rewriting «to help you».

That's a choice, not a limit: a program that fixes other people's files by itself will sooner or later fix the wrong thing, and you find out when it's late.

Gli esempi di questa pagina sono la forma che l’app legge e scrive oggi. Lo standard completo prevede anche varianti più avanzate — moduli senza numero nei file esterni, collegamenti dichiarati fra moduli — che l’app non interpreta ancora: se le usi, il file resta valido ma quelle parti vengono lette come testo normale.

And if I don't want to learn it?

You don't have to. This page exists because somebody wants to look under the bonnet, not because you need it to drive. The Reminders you download are already written this way, and the app writes them for you: you can use IllAIra for years without knowing any of what's above.