create-nextwave-agent

Inizializza lo scaffolding agentico di Next Wave Web per la gestione automatizzata di agenti AI, workflow strutturati e allineamento del contesto di sviluppo.

Questo pacchetto consente di configurare istantaneamente l'infrastruttura di pair programming agentica per IDE e assistenti AI (come Gemini, Claude, Cursor, Windsurf) all'interno di qualsiasi nuovo progetto.

🚀 Utilizzo Rapido

Per inizializzare lo scaffolding in un nuovo progetto, apri il terminale nella root del progetto di destinazione ed esegui:

npx create-nextwave-agent

Cosa fa lo script di setup:

1. Copia la cartella unificata di contesto e configurazione .agents/ (contenente le istruzioni, le skill dell'agente, i master prompt e le regole del brand).
2. Copia il file opencode.json con la definizione dei workflow.
3. Copia il manuale operativo GUIDA_SVILUPPO.md.
4. Rileva se è presente un repository Git locale e, se confermato, configura automaticamente i Git Hooks pre-commit per l'allineamento automatico dei task e del changelog.

📖 Documentazione e Guida Operativa

Una volta completato il setup, apri il file GUIDA_SVILUPPO.md per visualizzare le linee guida complete sullo sviluppo assistito dall'AI, tra cui:

• Come inizializzare il progetto con il comando /init.
• Come allineare il contesto ad inizio sessione con il comando /sync.
• Come gestire i task quotidiani con i comandi /feature, /fix, /refactor e /checkpoint.
• Come generare le proposte commerciali in DOCX e PDF usando il compilatore integrato.

🛠️ Manutenzione e Sviluppo Locale

Se vuoi modificare questo scaffolding sul tuo computer e testarlo in tempo reale su altri progetti locali, esegui questo comando nella root di questa cartella:

npm link

Da questo momento, qualsiasi esecuzione del comando npx create-nextwave-agent o create-nextwave-agent sul tuo computer utilizzerà la tua cartella locale aggiornata.