Vai al contenuto

Rilievo dei progetti esistenti

Su un codice esistente il loop parte con un passo in più, il rilievo. Il motore mappa il codice in modo deterministico; gli agenti scrivono una documentazione sostenuta da prove; il risultato diventa il contesto indicizzato di tutti i passi successivi.

Stato

Questa pagina descrive il progetto del rilievo. Oggi nessuna sua parte è costruita. Ciò che viene dopo è nella roadmap.

Passo Chi lo fa Risultato
Scansione Motore Albero dei moduli, linguaggi, punti di ingresso, dipendenze, conteggio dei token per file
Mappa Motore Simboli estratti con tree-sitter, grafo di import e chiamate, classifica dei file centrali, una mappa entro un budget di token
Documentazione con prove Agenti, sopra la mappa Architettura, convenzioni, glossario di dominio, flussi principali; ogni affermazione cita file e riga, e ciò che non si può dimostrare va in una sezione di elementi non verificati
Specifiche rilevate Agenti Specifiche vive ricostruite dal comportamento attuale, in stato Surveyed finché il maintainer non le approva
Lacune Agenti Un documento delle sole lacune (test mancanti, parti non documentate, rischi), senza ridocumentare ciò che esiste già
Indice Motore Un indice lessicale e strutturale, aggiornato in modo incrementale, interrogato tramite il motore

Prove, non plausibilità

Le risposte distinguono osservazioni, limiti e cose sconosciute, e "non trovato" è una risposta valida. È questo che impedisce a un agente di inventare un'architettura.

Niente embedding

L'indice è lessicale (BM25) e strutturale (simboli tree-sitter): veloce, deterministico e ripetibile. Gli embedding aggiungerebbero un modello, un archivio da mantenere e risultati non ripetibili, per aiutare solo con le domande in linguaggio naturale. Chi vuole la ricerca semantica usa uno strumento esterno accanto a Wayloop. Vedi ADR 0004.

Risparmiare token

  • Una mappa entro un budget invece dei file interi.
  • Letture filtrate delle specifiche: solo i requisiti che contano per il passo.
  • Uscite JSON compatte da ogni comando.
  • Per l'output della shell, l'integrazione con un compressore esistente invece di riscriverne uno.