REPOFORGE

PER CHI COSTRUISCE CON L’IA

Le idee prendono forma.
Il progetto
tiene il filo.

L’IA scrive il codice. Repo Forge aiuta a tenere in ordine ciò che le serve per continuare: istruzioni, decisioni e lavoro da fare. Anche nella prossima chat.

Installa Repo Forge Guarda cosa cambia

Open source · Licenza MIT · 4 skill per il tuo agente

IL TUO PROGETTOCONTESTO / 01
la-tua-idea/ esempio
  • AGENTS.mdCome deve lavorare l’IA
    istruzioni
  • ARCHITECTURE.mdCome è fatto il progetto
    struttura
  • BACKLOG.mdCosa fare, cosa tenere per dopo
    priorità
  • PLANS.mdIl percorso per il prossimo lavoro
    direzione
  • adr/Le decisioni e il loro perché
    memoria
Il codice evolve. Anche il contesto deve farlo.
DAL PROMPT AL PROGETTO.FORGIATO PER CONTINUARE
NEL TUO FLUSSO DI LAVORO

Claude Code / Codex / Cursor / GitHub Copilot

Requisiti e installazione ↗

01 / IL PUNTO IN CUI SI PERDE IL FILO

Ieri funzionava.
Oggi devi rispiegare
tutto.

Hai un’idea, apri il tuo strumento IA e inizi a costruire. Poi cambi una cosa, ne aggiungi un’altra, provi una strada diversa. Il progetto cresce.

Le ragioni delle scelte, però, restano sparse nelle chat. Una nuova sessione parte senza sapere perché avete fatto così. E anche un file di istruzioni, se nessuno lo aggiorna, finisce per descrivere un progetto che non esiste più.

Repo Forge porta quel contesto dentro il progetto e ti aiuta a mantenerlo aderente a ciò che stai costruendo.

02 / IL BANCO DI LAVORO

Quattro skill.
Un progetto che si spiega.

Una skill è un insieme di istruzioni che il tuo agente può usare per svolgere un lavoro preciso. Queste quattro si occupano del contesto del repository: la cartella del progetto, con i suoi file e la sua storia.

01

Capisci da dove parti.

ai-project-scan

Legge un progetto esistente, cerca le informazioni che mancano e segnala le incoerenze. Parti da quello che c’è, preservando il contesto utile.

SCAN
02

Dagli una struttura.

ai-project-seed

Prepara istruzioni per gli agenti, architettura, piani e decisioni per un progetto nuovo o poco documentato. Hai un posto dove ritrovare il perché delle cose.

SEED
03

Decidi cosa farne.

intake

Arriva un’idea nuova? Prima di farla diventare codice, chiarisce se serve un piano, un’analisi, un intervento diretto o una voce da tenere per dopo.

INTAKE
04

Riallinea dopo il lavoro.

ai-project-keeper

Confronta i documenti con il progetto che è cambiato. Aiuta a chiudere i piani, aggiornare le istruzioni e conservare le decisioni prese.

KEEP

Tra una skill e l’altra, costruisci con il tuo agente come fai già. Poi aggiorni il contesto.

03 / ANCHE SE NON SEI UN DEV

“Backlog”?
È la lista delle cose
da fare.

Puoi costruire con l’IA senza aver mai lavorato in un team di sviluppo. Alcune abitudini di quel lavoro, però, iniziano a servirti appena il progetto cresce.

Backlog
Le cose da fare, con priorità e stato. Così una buona idea può aspettare il suo turno senza sparire.
Architettura
Come sono collegati i pezzi. Serve a capire dove intervenire e quali vincoli rispettare.
Registro delle decisioni
Cosa avete scelto e perché. Serve quando, due chat dopo, viene voglia di rifare tutto al contrario.
Istruzioni per gli agenti
Le regole del tuo progetto, scritte dove l’IA può leggerle quando riprende il lavoro.

04 / ACCENDI LA FORGIA

Porta Repo Forge
nel tuo progetto.

Ti serve un agente che possa leggere e modificare i file del progetto, come Claude Code, Codex o Cursor. Una normale chat nel browser, da sola, non basta.

  1. 01

    Installa le quattro skill

    Apri il terminale nella cartella del progetto e incolla questo comando. Serve Node.js, che include npx. L’installer ti guida nella scelta dell’agente e della destinazione.

    npx skills add peorthyr/repo-forge --skill '*'

    Non sai dove si trova il terminale? Chiedi al tuo agente: «Guidami a installare Repo Forge in questo progetto con il comando qui sopra».

  2. 02

    Parti dal tuo progetto

    Se hai già iniziato a costruire, chiedi prima una lettura dello stato attuale. Puoi copiare questa richiesta nella chat del tuo agente:

    Usa ai-project-scan per analizzare questo repository. Spiegami quali istruzioni, decisioni e piani sono già documentati, cosa manca e da dove conviene iniziare. Per ora prepara solo il report, senza modificare i file.

    Parti da zero? Chiedi invece di usare ai-project-seed per preparare il contesto iniziale insieme a te.

  3. 03

    Continua a costruire. Poi riallinea.

    Usa intake quando arriva una nuova richiesta da inquadrare. Dopo aver cambiato il progetto, chiedi a ai-project-keeper di verificare se istruzioni e documenti descrivono ancora la realtà.

Leggi le istruzioni su GitHub ↗Trovalo su skills.sh ↗

05 / PRIMA DI INIZIARE

Due cose
da chiarire.

Devo sapere programmare?

Puoi usarlo anche se costruisci soprattutto attraverso i prompt. Ti serve poter aprire il progetto nel tuo agente e seguire l’installazione. Le skill aiutano a rendere esplicite struttura e decisioni; il giudizio su cosa costruire e la verifica del risultato restano necessari.

Funziona su un progetto già iniziato?

Sì. Parti da ai-project-scan per capire cosa c’è e cosa manca. Se esiste già una buona documentazione, va conservata e riallineata: non serve sostituirla con un modello da zero.

Scrive il codice della mia app?

Le skill di Repo Forge lavorano sul contesto: istruzioni, architettura, backlog, piani e decisioni. Lo sviluppo dell’app continua con il tuo agente abituale.

Una volta installato, fa tutto da solo?

L’installazione rende le skill disponibili all’agente. Il modo in cui vengono richiamate dipende dallo strumento e dalla richiesta. Puoi chiamarle esplicitamente per nome, come negli esempi sopra. Per mantenere i documenti aggiornati, usa keeper dopo il lavoro.

Quanto costa?

Repo Forge è open source con licenza MIT. Puoi leggere e usare le skill gratuitamente. Il tuo strumento IA mantiene i propri costi e le proprie condizioni.

LA PROSSIMA CHAT PARTE DA QUI.

La tua idea merita
un progetto che regge.

Installa Repo Forge

Quattro skill. Dentro il tuo flusso di lavoro.