CtrlK
BlogDocsLog inGet started
Tessl Logo

spec-driven-devlopment/spec-as-source

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

Quality

89%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

init-templates.mdskills/handoff/references/

Init Templates — Documenti Persistenti .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 — Template

# 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 — Template

# 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 — Template

# 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 — Template

# 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

skills

README.md

tile.json