failproofai 0.0.6-beta.1 → 0.0.6-beta.3

package/.next/standalone/docs/it/getting-started.mdx

@@ -1,5 +1,5 @@
 ---
-title: Per iniziare
+title: Iniziare
 description: "Installa failproofai, abilita le policy e lascia che i tuoi agenti funzionino in modo affidabile"
 icon: rocket
 ---
@@ -7,7 +7,7 @@ icon: rocket
 ## Requisiti
 
 - **Node.js** >= 20.9.0
-- **Bun** >= 1.3.0 (facoltativo - necessario solo per la compilazione dal sorgente)
+- **Bun** >= 1.3.0 (opzionale - necessario solo per compilare dal codice sorgente)
 
 ---
 
@@ -31,13 +31,13 @@ bun add -g failproofai
 
 <Steps>
   <Step title="Abilita le policy">
-    Le policy sono regole che vengono eseguite prima e dopo ogni chiamata a uno strumento dell'agente. Intercettano comandi distruttivi, fughe di segreti e altre modalità di errore prima che causino danni.
+    Le policy sono regole che vengono eseguite prima e dopo ogni chiamata a uno strumento dell'agente. Catturano i comandi distruttivi, le perdite di segreti e altre modalità di guasto prima che causino danni.
 
     ```bash
     failproofai policies --install
     ```
 
-    Questo scrive voci di hook nel file `settings.json` di Claude Code. Puoi anche installare per un singolo progetto o selezionare policy specifiche:
+    Questo scrive le entry di hook nel file `settings.json` di Claude Code. Puoi anche installare per un singolo progetto o selezionare policy specifiche:
 
     ```bash
     failproofai policies --install --scope project
@@ -49,17 +49,17 @@ bun add -g failproofai
     failproofai policies
     ```
 
-    Mostra ogni policy, se è abilitata e tutti i parametri configurati.
+    Mostra ogni policy, se è abilitata e i parametri configurati.
   </Step>
-  <Step title="Avvia il dashboard">
+  <Step title="Avvia la dashboard">
     ```bash
     failproofai
     ```
 
-    Apre un dashboard locale su `http://localhost:8020` dove puoi esplorare le sessioni, ispezionare le chiamate agli strumenti e gestire le policy.
+    Apre una dashboard locale su `http://localhost:8020` dove puoi sfogliare le sessioni, ispezionare le chiamate agli strumenti e gestire le policy.
   </Step>
   <Step title="Esegui il tuo agente">
-    Avvia Claude Code come al solito. Se l'agente tenta qualcosa di rischioso, failproofai lo intercetta automaticamente. Lascialo in esecuzione senza supervisione e rivedi cosa è accaduto nel dashboard.
+    Avvia Claude Code come al solito. Se l'agente tenta qualcosa di rischioso, failproofai lo intercetta automaticamente. Lascialo in esecuzione senza supervisione e rivedi quello che è accaduto nella dashboard.
   </Step>
 </Steps>
 
@@ -72,14 +72,14 @@ Ogni volta che un agente esegue uno strumento, Claude Code chiama failproofai co
 ```text
 Claude Code  →  failproofai --hook PreToolUse  →  legge JSON da stdin
                                                  valuta le policy
-                                                 scrive la decisione su stdout
+                                                 scrive la decisione in stdout
 ```
 
 Ogni policy restituisce una di tre decisioni:
 
 - **allow** - l'agente procede normalmente
 - **deny** - l'azione è bloccata, all'agente viene spiegato il motivo
-- **instruct** - viene aggiunto contesto aggiuntivo al prompt dell'agente
+- **instruct** - contesto aggiuntivo viene aggiunto al prompt dell'agente
 
 <Note>
 Le policy vengono eseguite nel tuo processo locale. Nulla viene inviato a un servizio remoto.
@@ -87,17 +87,69 @@ Le policy vengono eseguite nel tuo processo locale. Nulla viene inviato a un ser
 
 ---
 
+## Configura policy di team con policy basate su convenzione
+
+Il modo più veloce per stabilire standard di qualità in tutto il team è la convenzione `.failproofai/policies/`. Inserisci i file di policy in questa directory e vengono caricati automaticamente — nessun flag, nessuna modifica della configurazione, nessun comando di installazione.
+
+<Steps>
+  <Step title="Crea la directory delle policy">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="Aggiungi file di policy">
+    Copia gli esempi iniziali o scrivi i tuoi:
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    Oppure creane uno nuovo:
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Esegui i test prima di eseguire il commit.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Esegui il commit su git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+
+    Ogni membro del team che ha failproofai installato raccoglie automaticamente queste policy. Non è necessaria alcuna configurazione per sviluppatore.
+  </Step>
+</Steps>
+
+<Tip>
+Esegui il commit di `.failproofai/policies/` nel tuo repository in modo che l'intero team condivida gli stessi standard. Man mano che il tuo team scopre nuove modalità di guasto, aggiungi policy e esegui il push — tutti ricevono l'aggiornamento al prossimo `git pull`. Nel tempo queste policy diventano uno standard di qualità vivo che continua a migliorare.
+</Tip>
+
+---
+
 ## Archiviazione dei dati
 
 Tutta la configurazione e i log rimangono sul tuo computer:
 
-| Percorso | Cosa archivia |
-|----------|---------------|
+| Percorso | Cosa conserva |
+|------|----------------|
 | `~/.failproofai/policies-config.json` | Configurazione globale delle policy |
-| `~/.failproofai/hook-activity.jsonl` | Cronologia dell'esecuzione degli hook |
-| `~/.failproofai/hook.log` | Log di debug per errori hook personalizzati |
-| `.failproofai/policies-config.json` | Configurazione per progetto (committed) |
-| `.failproofai/policies-config.local.json` | Personalizzazioni personali (gitignored) |
+| `~/.failproofai/hook-activity.jsonl` | Cronologia dell'esecuzione dei hook |
+| `~/.failproofai/hook.log` | Log di debug per gli errori dei hook personalizzati |
+| `.failproofai/policies-config.json` | Configurazione per progetto (sottoposta a commit) |
+| `.failproofai/policies-config.local.json` | Override personali (gitignored) |
 
 ---
 
@@ -107,16 +159,16 @@ Tutta la configurazione e i log rimangono sul tuo computer:
 failproofai policies --uninstall
 ```
 
-Rimuove le voci di hook da `~/.claude/settings.json`. I file di configurazione in `~/.failproofai/` vengono conservati.
+Rimuove le entry di hook da `~/.claude/settings.json`. I file di configurazione in `~/.failproofai/` vengono mantenuti.
 
 ---
 
-## Prossimi passaggi
+## Passaggi successivi
 
 <CardGroup cols={2}>
 
 <Card title="Configurazione" icon="gear" href="/it/configuration">
-  Scope e formato del file di configurazione
+  Ambiti e formato del file di configurazione
 </Card>
 
 <Card title="Policy integrate" icon="shield" href="/it/built-in-policies">
@@ -127,8 +179,8 @@ Rimuove le voci di hook da `~/.claude/settings.json`. I file di configurazione i
   Scrivi le tue policy in JavaScript
 </Card>
 
-<Card title="Monitor agente" icon="chart-line" href="/it/dashboard">
-  Monitora le sessioni e esamina l'attività delle policy
+<Card title="Monitore agente" icon="chart-line" href="/it/dashboard">
+  Monitora le sessioni e rivedi l'attività delle policy
 </Card>
 
 </CardGroup>