Il problema da cui parte
Crei un AGENTS.md, scrivi un piano, annoti qualche decisione. Poi lavori sul progetto. Il codice cambia, i documenti magari meno, e alla prossima sessione l’agente trova una descrizione molto convincente di qualcosa che non esiste più.
Repo Forge prova a mantenere quel contesto leggibile e aggiornato. È una nostra raccolta: lo diciamo subito, anche perché sarebbe un po’ buffo fingere di averla trovata per caso 😀
Da dove partire
| La situazione | Il passaggio |
|---|---|
| Non sai quali documenti siano affidabili | Scan: leggere prima di cambiare |
| Il progetto è nuovo e vuoto | Seed: preparare il contesto |
| Una richiesta non è ancora definita | Intake: scegliere il prossimo passo |
| I documenti non seguono più il progetto | Keeper: riallineare |
Non servono sempre tutte
Su un repository esistente partirei da scan. Su uno nuovo, da seed. Le quattro skill sono passaggi diversi, e puoi installare soltanto quello che ti serve.
Il comando della raccolta apre la scelta guidata. Per selezionare tutte e quattro mantenendo la scelta dell’agente:
npx skills add peorthyr/repo-forge --skill '*'Nel README trovi anche --all: quella scorciatoia comprende tutti gli agenti senza prompt. Qui teniamo il percorso guidato, così la destinazione la scegli tu.
Che cosa sappiamo, per ora
Queste schede descrivono le istruzioni lette alla revisione indicata. Non sono una promessa di risultato su qualunque repository. Le prove future avranno ambiente, versione ed esito, compresi i punti che non funzionano.
Le skill della raccolta
- ai-project-scan
Capire il contesto prima di cambiarlo
Legge i documenti di un repository esistente e segnala cosa conservare, cosa manca e cosa non torna.
- ai-project-seed
Preparare un progetto nuovo
Costruisce i primi documenti di governance per un progetto nuovo e vuoto.
- intake
Dare un posto alle nuove richieste
Classifica una richiesta ancora da definire prima che diventi lavoro non pianificato.
- ai-project-keeper
Riallineare i documenti al progetto
Trova e corregge le differenze fra i documenti di governance e lo stato attuale del progetto.