🔦 Faro — Illumina il tuo progetto dall'idea alla produzione

Faro è un plugin universale per Claude Code che inizializza, guida e accompagna qualsiasi progetto software. Dal gestionale all'esperienza 3D immersiva.

Filosofia

Faro NON è un runtime da invocare ogni volta. È un inizializzatore + advisor:

1. Configura il progetto generando file nativi Claude Code (.claude/rules/, commands/, agents/) 2. Una volta configurato, Claude Code segue le regole da solo — senza bisogno di invocare Faro 3. L'Advisor con memoria persistente ti accompagna nel tempo

Installazione

Sessione singola

/plugin install faro@[marketplace]

Permanente

claude plugin add faro

Directory plugins

Clona in ~/.claude/plugins/faro-claude-plugin/

Come si usa

4 percorsi + porting

| Percorso | Quando | Comando | |----------|--------|---------| | Nuovo | Cartella vuota | faro → wizard automatico | | Esistente | Codice senza Faro | faro → adopt automatico | | Riprendi | .faro/ esiste | faro → riprende | | Reskin | Cambiare design | /project:reskin | | Port | Nuova piattaforma | Invoca faro-multiplatform |

4 tier di design

| Tier | Nome | Per chi | Animazioni | |------|------|---------|------------| | 1 | Funzionale | Gestionale, ERP | Zero | | 2 | Professionale | SaaS, e-commerce | Framer Motion sottili | | 3 | Cinematic | Portfolio, brand | GSAP + Lenis | | 4 | Immersivo | Luxury, architettura | Three.js + 3D |

Comandi progetto (generati nel progetto)

| Comando | Cosa fa | |---------|---------| | /project:status | Stato, score, piano | | /project:audit | Audit design + sicurezza + performance + a11y | | /project:reskin | Cambia design senza rompere logica | | /project:advisor | Consulente prodotto con memoria | | /project:review | Review coerenza con rules | | /project:update-context | Aggiorna rules dopo modifiche | | /project:timeline | Report cronologico | | /project:explore | Mappa codebase | | /project:debug | Debugging guidato |

Skill del plugin

Orchestrazione (11)

faro, faro-wizard, faro-adopt, faro-beginner, faro-tier-system, faro-stack-advisor, faro-blueprints, faro-generator, faro-autopilot, faro-multiplatform, faro-stitch

Dominio (13)

faro-devops, faro-security, faro-testing, faro-legacy, faro-supabase, faro-multitenant, faro-mobile, faro-ai, faro-payments, faro-python, faro-cli, faro-team, faro-pm

File generati nel progetto (33 file)

11 rules + 10 commands + 6 agents + 3 docs + 2 tracking + CLAUDE.md = 33 file nativi Claude Code

Faro sostituisce

Faro è progettato per essere l'UNICO plugin di cui hai bisogno:

| Plugin | Sostituito? | Come | |--------|------------|------| | superpowers | ✅ Sì | Brainstorming (workflow.md), TDD (testing.md), piani (.faro/plans/), review (code-reviewer), worktree (workflow.md), debugging (debugging.md) | | frontend-design | ✅ Sì | 4 tier design + audit anti-AI-slop | | claude-mem | ✅ Sì | Advisor con memoria + /project:timeline + /project:explore | | claude-code-setup | ✅ Sì | faro-wizard | | claude-hud | ✅ Sì | /project:status | | claude-md-management | ✅ Sì | CLAUDE.md generato e aggiornato da context-updater | | commit-commands | ✅ Sì | Git workflow in code-style.md + /project:commit | | omega | ✅ Sì | Faro è il successore | | vercel-plugin | ❌ Tieni | Plugin vendor-specifico per Vercel — Faro non sostituisce tool vendor-specifici |

Per disinstallare i plugin sostituiti

/plugin remove superpowers
/plugin remove frontend-design
/plugin remove claude-mem
/plugin remove claude-code-setup
/plugin remove claude-hud
/plugin remove claude-md-management
/plugin remove commit-commands
/plugin remove omega

Plugin complementari consigliati (opzionali)

| Plugin | Perché | |--------|--------| | vercel-plugin | Se usi Vercel per il deploy | | Token Optimizer | Se vuoi controllo avanzato sul context window | | gstack | Se vuoi browser QA headless automatizzato (feature fuori scope Faro) |

FAQ

Devo invocare Faro ogni volta che lavoro al progetto?

No. Una volta configurato, Claude Code legge automaticamente .claude/rules/ ad ogni messaggio. Faro serve per inizializzare, adottare, cambiare design o riprendere — non per tutte le interazioni.

Posso disinstallare Faro dopo l'inizializzazione?

Sì. Le regole in .claude/rules/, i comandi in .claude/commands/, gli agent in .claude/agents/ e i documenti in docs/ e .faro/ sono file nativi Claude Code. Continuano a funzionare senza il plugin Faro installato. Reinstallerai Faro solo se vorrai un nuovo reskin, adopt o porting.

Funziona con progetti esistenti?

Sì — usa il percorso adopt. Faro analizza il codice esistente (package.json, struttura cartelle, Tailwind config, schema DB) e genera rules che RIFLETTONO lo stato attuale, non template generici.

Cosa succede se il mio progetto usa uno stack non supportato?

Faro supporta 80+ tecnologie in 3 tier di supporto (pattern completi, pattern base, guida generica). Se la tua tech è in Tier 3, Faro ti darà consigli generali e rimanderà alla documentazione ufficiale via /faro:fetch-docs. Puoi sempre adattare i template a mano.

Posso cambiare design (reskin) senza rompere la logica?

Sì — usa /project:reskin. Faro classifica ogni file del progetto in DESIGN / LOGICA / MISTO e tocca solo le classi Tailwind e i componenti UI. I file lib/, actions/, queries/, auth/,

validations/, prisma/, api/ non vengono mai toccati durante un reskin.

Come funziona l'autopilot?

faro-autopilot esegue un piano di lavoro autonomamente, fermandosi a 4 gate obbligatori:

• Gate DB: prima di creare/modificare tabelle database
• Gate Deploy: prima di deployare in produzione
• Gate Distruttivo: prima di eliminare file/dati/funzionalità
• Gate Costo: prima di aggiungere servizi a pagamento

In più, anti-loop automatico: se lo stesso errore compare 3 volte, l'autopilot si ferma e chiede input.

Posso usare Faro con utenti non-tecnici?

Sì — il wizard rileva il livello dell'utente dalla prima risposta. Se sei un utente non-tecnico, invoca il flusso BEGINNER che usa linguaggio semplice, max 3 domande, 6 profili preconfezionati e 4 livelli visivi (Semplice / Bello / Wow / 3D invece di Tier 1-4).

Faro funziona in inglese?

Il plugin è pensato in italiano (trigger, documentazione, prompts). Puoi usarlo con Claude Code in qualsiasi lingua, ma le rules generate saranno in italiano per default. Per un progetto in inglese, chiedi esplicitamente "rules in english" al wizard.

Come si integra con il plugin vercel-plugin?

Sono complementari. Faro gestisce inizializzazione, design system, sicurezza, review e workflow generali. vercel-plugin gestisce deploy, functions, env variables, rollback, domini e altre feature vendor-specifiche di Vercel. Mantieni entrambi installati se usi Vercel.

Dove va la memoria dell'advisor?

faro-advisor usa memory: project (feature nativa Claude Code) per ricordare decisioni, pattern e pitfall tra le sessioni. Le learning strutturate vanno in .faro/learnings/ (append-only, filesystem, nessun MCP server richiesto).

Posso contribuire al plugin?

Sì. Il plugin è open source. Proponi pull request su pattern di dominio mancanti (es: nuove combo stack, nuovi blueprint settoriali), ma evita di aggiungere feature fuori scope (browser QA, token compression binaria, parallelismo multi-sprint massivo) — quelle sono scelte di posizionamento deliberate.

Il plugin è davvero necessario se Claude Code ha già tutti gli strumenti?

Faro non aggiunge strumenti a Claude Code. Li ORCHESTRA. La differenza: senza Faro, ogni progetto parte da zero — Claude deve chiedere ad ogni sessione quali sono i colori, la struttura, la sicurezza, il workflow. Con Faro, queste informazioni vivono in .claude/rules/ e Claude le legge in automatico. Meno prompt ingegneria, più lavoro reale.

Changelog

Vedi CHANGELOG.md per la storia completa delle release.

Ultima release: v1.2.0 (2026-04-12) — integrazione pattern ECC, nuovo /project:cleanup, CI GitHub Actions, FAQ, CONTRIBUTING.

Licenza

MIT