La tua prima revisione

Questo tutorial parte da una funzionalità di check-in esistente. Scriverai un requisito da esaminare, verificherai l’implementazione e le prove e registrerai una nuova decisione. Se la funzionalità deve ancora essere implementata, segui prima il percorso di implementazione descritto sotto, poi torna alla revisione.

Ti servono Noea con un Agent contrassegnato come Pronto e un progetto locale su cui lavorare. Se il progetto non ha una funzionalità di check-in, sostituiscila con un’altra regola altrettanto specifica.

Apri il progetto di codice

Scegli Apri cartella… (Open Folder…) nell’ambiente di lavoro oppure File → Apri cartella di implementazione… (File → Open Implementation Folder…) e seleziona la cartella che contiene il codice.

La prima volta che apri quella cartella, Noea crea un progetto collegato. Se esiste già un progetto lo apre direttamente; se ne sono collegati diversi, ti chiede quale aprire. Consulta Aprire e gestire i progetti per gli altri modi di aprire un progetto.

Conferma la base della revisione

Fai clic su Nuovo intento (New Intent) nella barra laterale e chiamalo “Check-in giornalieri”. Noea aggiunge l’estensione .noea.md e apre il documento. Scrivi:

# Check-in giornalieri

Gli utenti possono effettuare un check-in al giorno. Assegna una ricompensa all’utente dopo 7 giorni consecutivi di check-in.

Salva con ⌘S su macOS o Ctrl+S su Windows / Linux. Parti da ciò che hai deciso; non serve elencare già tutti i casi limite.

Indaga l’implementazione esistente

Spiega (Explain) verifica nel progetto i contenuti le cui spiegazioni richiedono attenzione. L’azione Indagine (Investigation) di un paragrafo verifica solo quel contenuto. Entrambe esaminano l’implementazione e generano o aggiornano le spiegazioni; non modificano il codice.

Se i check-in esistono già, fai clic su Spiega (Explain) nella barra laterale. Per verificare solo questo paragrafo, passaci sopra con il puntatore e scegli Indagine (Investigation) a sinistra.

Se la regola deve ancora essere implementata, avvia una nuova chat, digita @ nel campo di input per selezionare il documento di intento e invia:

Implementa la ricompensa per i check-in in questo progetto secondo l’intento indicato. Esamina prima il codice esistente, segui la struttura del progetto e verifica sia una serie di 7 giorni sia un check-in saltato.

Puoi anche usare il pulsante Implementa (Realize) nella barra laterale, quando disponibile; consulta Lavorare con un Agent sull’implementazione. La chat mostra risposte, chiamate agli strumenti e modifiche ai file mentre l’Agent lavora.

Dopo l’implementazione, fai clic su Spiega (Explain) se non è partito automaticamente. Non tutte le modifiche al codice in una chat normale avviano un aggiornamento delle spiegazioni.

Esamina l’implementazione e le prove

Torna al documento di intento e fai clic sullo spazio vuoto all’interno del paragrafo, fuori dal testo, per aprire la nota a margine. Leggi queste sezioni:

• Realizzazione (Realization): come il codice conta i giorni consecutivi e assegna le ricompense.
• Prove (Evidence): codice, output dei comandi o materiali di test citati dalla spiegazione.
• Attenzione (Attention): lacune, scelte di implementazione, rischi o suggerimenti che richiedono il tuo giudizio.

Per esempio, potresti scoprire che l’implementazione definisce i giorni di calendario usando il fuso orario del dispositivo. Verifica cosa fa davvero il progetto e se corrisponde ai tuoi requisiti. Apri i riferimenti per valutare fino a che punto le prove sostengono la spiegazione.

Una spiegazione completata non significa che i test siano stati rieseguiti. Distingui il codice dei test, i risultati passati e le verifiche eseguite in questa attività; consulta Leggere spiegazioni e prove. Se l’implementazione non soddisfa il requisito originale, correggila invece di riscrivere la regola per adattarla al codice.

Fai una domanda e registra una decisione

Passa con il puntatore sul paragrafo e scegli Chiedi informazioni (Ask about this) a sinistra. Noea inserisce un riferimento nel campo della chat. Aggiungi la domanda e invia:

Come gestisce i viaggi tra fusi orari l’implementazione attuale? Effettuare il check-in da due luoghi diversi può influire sulla serie? Spiegalo usando il codice.

Una volta compreso il comportamento, decidi se vuoi vincolare il calcolo. In tal caso, invia:

Aggiungi “Un giorno segue la data di calendario della posizione attuale dell’utente” a questo intento. Proponi prima la modifica all’intento perché io possa esaminarla.

Quando l’Agent presenta una proposta, fai clic su Visualizza modifiche (View Changes) e leggi le aggiunte e le sostituzioni. Modifica la nuova formulazione se necessario, poi scegli Accetta le mie modifiche (Accept My Edits), oppure Accetta (Accept) se non servono modifiche.

Se la proposta richiede lavoro di implementazione, l’accettazione prosegue quel lavoro nella stessa chat. Se l’implementazione esistente la soddisfa già, non serve avviare una nuova implementazione. Controlla poi i risultati dell’attività di spiegazione oppure avvia manualmente un’indagine quando necessario.

Verifica cosa hai imparato

Prima di finire, salva il documento e conferma che la spiegazione copra il testo attuale. Prova a rispondere a quattro domande con parole tue:

1. Come è implementato questo requisito e quali prove sostengono questa conclusione?
2. Quale scelta importante ha fatto l’Agent che non era specificata nell’intento?
3. Comprendo e accetto quella scelta? Dovrebbe diventare un vincolo duraturo?
4. Quale frase cambierei la prossima volta che volessi modificare questo comportamento?

Per esempio, dovresti saper spiegare come viene definito un giorno, trovare le prove a sostegno e indicare “7 giorni consecutivi” come condizione della ricompensa. Se una risposta non è chiara, fai una domanda sul paragrafo interessato.

Non devi registrare ogni regola al primo utilizzo. Aggiungi la prossima decisione da conservare quando la incontri.

Continua con Scrivere intenti che contano e Leggere spiegazioni e prove.