fairmind-plugins-academy

Il repository di esercitazione del corso Fairmind Coding con Claude Code.

Un log di eventi append-only, piccolo abbastanza da leggerlo in due minuti. Solo libreria standard di Python 3: niente da installare, niente virtualenv.

git clone https://github.com/FairMind-Gen-AI-Studio/fairmind-plugins-academy.git
cd fairmind-plugins-academy
./run_tests.sh

Cosa c'è dentro

eventlog/store.py     il log append-only: si aggiunge e si legge, non si toglie
eventlog/api.py       il confine da cui un evento entra dall'esterno
eventlog/errors.py    una classe per ogni rifiuto
tests/                la suite, unittest della libreria standard
tickets/              i ticket degli esercizi
broken-checks/        cinque descrittori per l'attività sull'ammissione

L'invariante

Il log è append-only. Gli eventi entrano e non escono: non c'è modifica e non c'è cancellazione. È l'unica ragione per cui qualcuno a valle può fidarsi di una lettura.

Gli esercizi

tickets/EX2-last-event.md — una feature da quindici righe. Il test si scrive prima, e si guarda fallire per la ragione giusta prima di implementare.

tickets/TASK-1-since-filter.md — un loop intero, dall'arm al gate umano. I criteri sono verificabili a macchina e il contratto compila pulito.

tickets/TASK-2-ergonomics.md — lo stesso percorso su un ticket scritto come vengono scritti davvero. Non arrivate al verde: il prodotto di quel task è il gap report.

broken-checks/ — quattro check scritti male apposta e uno scritto bene. Si dà tutto in pasto all'ammissione e si guarda cosa intercetta, e perché.

Una cosa da sapere prima di partire

C'è un difetto messo lì di proposito, e non è un errore di chi ha scritto il repository. Trovarlo è parte dell'esercizio, e chi lo trova senza che glielo dicano ha capito la lezione della mattina meglio di chiunque altro.

Il difetto non è in nessun test che fallisce. La suite è verde.

Serve il plugin

Gli esercizi girano con il plugin fairmind-coding, che si installa in Claude Code dal marketplace Fairmind. Il gate eseguito, l'ammissione e il gate umano vogliono git, python3 e bash, e nient'altro: nessun account e nessuna configurazione.

Le note per chi conduce non sono qui

Contengono la risposta, quindi stanno da un'altra parte. Se conducete il corso e non le avete, chiedetele.

---

MIT. Fairmind · fairmind.ai