Per iniziare01 / 16
Scopri Noea Code
In questa pagina
Noea Code (in breve Noea) ti aiuta a esaminare come il software scritto dall’IA risponde ai tuoi requisiti. Parti da un’implementazione esistente: usa l’intento come base per verificare comportamento e prove, comprendere le scelte importanti e registrare le tue decisioni per il lavoro futuro.
Inizia da una sola regola in un progetto esistente. Un comportamento del prodotto, un vincolo architettonico o un requisito di un algoritmo possono essere il tuo primo intento.
Intento indica i requisiti che vuoi che il software continui a soddisfare. Restano validi anche dopo il completamento di una funzionalità. Quando decidi di cambiarne il comportamento, modifichi le parole corrispondenti. Non serve descrivere l’intera applicazione: parti da ciò che ti interessa.
Collega l’intento all’implementazione
Supponi di creare un’app per i check-in giornalieri e di scrivere:
Assegna una ricompensa all’utente dopo 7 giorni consecutivi di check-in.
Questo definisce la condizione per una ricompensa, ma lascia aperte diverse scelte: cosa conta come giorno, cosa succede se si salta un check-in e quale ricompensa assegnare. L’Agent deve comunque decidere questi aspetti quando implementa la regola.
Noea collega la frase a una spiegazione dell’implementazione. Puoi leggere come il codice conta i giorni, aprire i riferimenti al codice o i materiali di test alla base della spiegazione e individuare requisiti non soddisfatti o scelte da discutere. Se decidi che un giorno deve seguire la data di calendario locale dell’utente, aggiungi questa decisione all’intento perché il lavoro futuro la rispetti.
Distingui i tre tipi di contenuto
| Contenuto | Scopo | Dove trovarlo |
|---|---|---|
| Documenti di intento | Registrano i comportamenti e i vincoli richiesti | La sezione degli intenti nella barra laterale; i file terminano con .noea.md |
| Implementazione | Codice, configurazione e file correlati del software | La cartella di implementazione collegata al progetto |
| Spiegazioni dell’implementazione | Descrivono come l’implementazione risponde a una parte dell’intento, con prove e aspetti da valutare | Note a margine del documento di intento |
I documenti di intento sono file Markdown. Puoi versionarli con Git o modificarli in un altro editor. Noea conserva separatamente le spiegazioni dell’implementazione e le mostra nelle note a margine. Alcune etichette dell’interfaccia inglese chiamano i documenti di intento Source; si tratta di contenuti distinti dal codice nella cartella di implementazione.
Segui il flusso di lavoro quotidiano
- Conferma la base della revisione. Scrivi il requisito da verificare oppure discutine con l’Agent e conferma la formulazione proposta.
- Esamina l’implementazione. Indaga come il codice esistente risponde al requisito, verifica le prove e individua le scelte che richiedono il tuo giudizio.
- Registra le tue decisioni. Fai domande su un paragrafo specifico, aggiungi i requisiti da conservare e continua a implementare e verificare.
Se il codice esiste già, scrivi il requisito da verificare ed esegui Spiega (Explain). Se deve ancora essere implementato, usa una chat o l’azione Implementa (Realize).
Puoi accettare una scelta che comprendi senza trasformare ogni dettaglio dell’implementazione in un requisito duraturo. Consulta Leggere spiegazioni e prove per decidere cosa includere nell’intento.
Esaminare l’implementazione significa verificare comportamento, prove e scelte rispetto al tuo intento. Esaminare una modifica all’intento significa controllare la formulazione proposta prima di accettarla nei documenti. La prima attività ti aiuta a decidere cosa cambiare; la seconda registra i requisiti che scegli di conservare.
Comprendi i ruoli di Noea e dell’Agent
Noea offre l’ambiente di lavoro per scrivere documenti, discutere decisioni, esaminare modifiche e leggere spiegazioni. L’Agent legge il progetto, richiama strumenti e modifica il codice. Scegli un Agent supportato e usa i modelli e i metodi di accesso che mette a disposizione.
Nel flusso delle proposte di Noea, le modifiche ai documenti di intento richiedono una tua decisione. Puoi modificare e accettare una proposta oppure ignorarla. Le modifiche al codice e i comandi dipendono dalle capacità dell’Agent e dalle impostazioni delle autorizzazioni.
Le spiegazioni dell’implementazione non sostituiscono i test o l’uso diretto. Controlla le prove relative ai comportamenti importanti e verificale quando necessario.
Parti da una domanda piccola ma significativa
Scegli un aspetto circoscritto con un risultato osservabile: quando viene assegnata una ricompensa, come si gestiscono scorte insufficienti o un vincolo che un’API deve rispettare. Per il resto del progetto puoi continuare a usare il tuo processo di sviluppo abituale.
Ora installa e prepara l’app, poi segui La tua prima revisione.