Spec-driven development on OpenSpec, with mechanical spec-as-source enforcement: a custom 'spec-as-source' OpenSpec schema adds file-ownership (targets) and test-verification ([@test]) metadata to every capability spec, three scripts (link check, ownership check, manifest build) keep code and specs from drifting apart, plus requirement-gathering, spec-writer, work-review, and a session-handoff skill with a proactive context-warning hook.
71
89%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
.handoff/Questi template vengono usati durante /handoff init per creare i 4 documenti
persistenti. Adattare il contenuto al progetto rilevato dal contesto della conversazione.
# CLAUDE.md — Istruzioni Persistenti
> Progetto: [nome] | Aggiornato: [data]
> Leggere all'inizio di ogni sessione Claude Code.
## Chi sono / Contesto
[Nome del progetto, brand, tipo di lavoro, operatore principale]
## Stack & Tool
- Generazione immagini: [es. NanoBanana, GPT Image 2]
- Animazione video: [es. Kling 3.0, Seedance 2.0]
- Post-produzione: Photoshop, Premiere
- Sviluppo web: [es. WordPress, Next.js]
- AI: Claude (strategia, copy, prompt engineering)
## Regole operative
- [Regola 1 — es. "Non generare mai testo in-frame: aggiungerlo sempre in Photoshop"]
- [Regola 2 — es. "Palette fissa per cliente X: #D62027 + cream + black"]
- [Regola 3]
## Preferenze di comunicazione
- Lingua: [italiano per conversazione, inglese per prompt]
- Formato output: [es. "JSON per prompt, markdown per copy"]
- Tono: [es. "diretto, tecnico, senza over-spiegazioni"]
## Path importanti
- Assets: [path]
- Output: [path]
- Documentazione: `.handoff/`# PROMPTS.md — Libreria Prompt Validati
> Progetto: [nome] | Aggiornato: [data]
> Prompt testati e approvati. Aggiungere solo dopo validazione in sessione.
## Formato entry
**[ID] — [Descrizione breve]**
- Tool: [NanoBanana / Kling / Seedance / GPT Image 2 / ...]
- Cliente/Progetto: [nome]
- Prompt: `[testo esatto del prompt]`
- Parametri: [aspect ratio, model, duration, ecc.]
- Risultato: [descrizione outcome + perché funziona]
- Data validazione: [YYYY-MM-DD]
---
## Image Prompts
### [PROG-001] — [Descrizione]
- Tool:
- Cliente/Progetto:
- Prompt: ``
- Parametri:
- Risultato:
- Data:
## Video Prompts
### [VID-001] — [Descrizione]
- Tool:
- Cliente/Progetto:
- Prompt: ``
- Parametri:
- Risultato:
- Data:
## Copy Prompts
### [COPY-001] — [Descrizione]
- Tool: Claude
- Cliente/Progetto:
- Prompt: ``
- Output tipo:
- Data:# CLIENTS.md — Schede Clienti Attivi
> Progetto: [nome] | Aggiornato: [data]
---
## [Nome Cliente]
- **Settore**: [es. Automotive, Food, Nautica, Interior Design]
- **Contatto**: [nome referente]
- **Canali**: [Instagram, LinkedIn, sito web, ...]
- **Visual Identity**:
- Palette: [hex codes]
- Font: [nome font]
- Mood: [es. "luxury dark", "warm artisanal", "tech minimal"]
- **Regole fisse**:
- [Regola 1 — es. "Logo sempre in basso a destra"]
- [Regola 2 — es. "Mai usare il rosso concorrente"]
- **Progetti attivi**: [link a HANDOFF o descrizione]
- **Note**: [info utili per il lavoro]
---
## [Nome Cliente 2]
[...]# WORKFLOW.md — Metodologia TheNewA(i)telier
> Aggiornato: [data]
> Documento vivo: aggiornare quando la metodologia evolve.
## Pipeline standard
### 1. Brief & Strategy (Claude)
- Analisi brief cliente
- Definizione obiettivi e KPI
- Mood board testuale + direzione creativa
### 2. Prompt Engineering (Claude → Generazione)
- Scrittura prompt in inglese strutturato
- Parametri: modello, aspect ratio, lighting, mood, references
- Output: JSON prompt block per archiviazione in PROMPTS.md
### 3. Generazione Immagini (Higgsfield / NanoBanana / GPT Image 2)
- A/B test tra modelli su asset chiave
- Selezione best output
- Export in formato nativo
### 4. Animazione Video (Kling / Seedance)
- Start frame + end frame per Kling (maggior controllo)
- Seedance per sequenze con audio/dinamismo
- Speed max 0.6 per contenuti luxury
### 5. Post-Produzione (Photoshop / Premiere)
- Aggiunta testo/logo (mai generato AI)
- Color grading finale
- Export formati piattaforma
### 6. Copy & Captioning (Claude)
- Tono: [definire per ogni cliente in CLIENTS.md]
- Lingua: italiano (con variante EN se richiesta)
- Hashtag research: max 20, mix niche + broad
## Naming Convention Assets[CLIENTE]-[PROGETTO]-[TIPO]-[VERSIONE].[ext] es. ESAC-BARRA36-CAROUSEL-v2.psd FERRARI-812-HERO-v1.png
## Archivio sessioni
Tutte le sessioni di lavoro sono documentate in `.handoff/HANDOFF-NNN.md`---
## Note per la generazione
Durante `/handoff init`, adatta i template al progetto specifico:
- Se rilevi un progetto web → aggiungi stack tech in CLAUDE.md
- Se rilevi clienti già nominati nella conversazione → pre-compila CLIENTS.md
- Se rilevi prompt già discussi → pre-compila PROMPTS.md con quelli validati
- WORKFLOW.md può essere lasciato come scaffold se è un nuovo progetto.tessl-plugin
skills
handoff
openspec-apply-change
openspec-archive-change
openspec-explore
openspec-propose
openspec-sync-specs
requirement-gathering
spec-as-source-setup
templates
openspec-schema
spec-as-source
templates
spec-ci-sync
spec-rebuild
spec-verify
spec-writer
work-review