RepoKernel

Project kernel pubblico per repository AI: stato corrente, fonti, confini operativi, receipt, rientro e integrazione con coder o runtime agentici.

RepoKernel è un project kernel pubblico per repository seguite da coder e assistenti AI. Porta nel progetto stato corrente, fonti, confini operativi, receipt e prossima azione.

Oggetto

  • Tipo: pacchetto repository / project kernel.
  • Ambiente: repository software, documentale o operativa.
  • Lettori: Codex, Claude Code, OpenCode, Cursor, altri coder agentici, operatori umani.
  • Stato pubblico: repository GitHub disponibile e documentazione leggibile.

Input

  • struttura della repository;
  • file di stato, istruzioni, README, documentazione e decisioni esistenti;
  • fonti da seguire e fonti da non seguire;
  • regole locali, confini di scrittura, comandi di verifica;
  • residui storici che possono confondere il rientro.

Output

  • entry gate: istruzioni iniziali per chi entra nel progetto;
  • CURRENT_STATE: superficie attiva, fonte di verità, confine, residui, prima mossa;
  • source atlas: mappa di fonti, evidenza, documenti utili e file da non usare come autorità;
  • receipt: prova leggibile di proposta, verifica, scarto o promozione;
  • update reading rule: controllo degli aggiornamenti pubblici prima di iniziare una nuova stanza;
  • propagation contract: criterio per portare una regola utile in un Project Kernel locale.

Sequenza operativa

  1. Inventory: legge la superficie e identifica cosa esiste.
  2. Source pass: separa fonte, evidenza, inferenza e residuo.
  3. State pass: scrive o aggiorna lo stato corrente del progetto.
  4. Boundary pass: registra cosa si può leggere, proporre, scrivere, eseguire o pubblicare.
  5. Receipt pass: conserva la prova di ciò che è stato deciso o verificato.
  6. Reentry pass: lascia la prossima azione per la stanza successiva.

Integrazione

  • manuale: il coder legge RepoKernel e applica la procedura nel progetto;
  • skill: un sistema con skill può richiamarlo come competenza di setup o rientro;
  • Project Kernel: il progetto riceve una versione locale adattata al dominio;
  • hook: un sistema che supporta hook può usarli per boot, update check o digest;
  • runtime: una funzione destinata a ciclo autonomo passa da manifest, receipt, reducer o validator.

Autorità operativa

RepoKernel registra orientamento e condizioni. L'autorità di scrittura, esecuzione, pubblicazione o deploy appartiene al progetto ospite, all'operatore e ai gate locali. Se una funzione viene collegata a un runtime, il manifest dichiara azioni ammesse, azioni escluse, ricevuta prodotta e condizione di arresto.

Uso previsto

  • repository con molte sessioni AI;
  • progetti che passano tra più coder o più nodi;
  • rientro dopo compact, pausa, cambio modello o cambio macchina;
  • trasferimento di regole, skill e metaskill dentro un progetto reale;
  • preparazione di un progetto prima di automazioni più forti.

Prova pubblica

Repository: github.com/GrazianoGuiducci/RepoKernel.

Pagine collegate: Prodotti e superfici, Portfolio tecnico, Open source e continuità, Prossimi passi.