Un esempio completo

Parole chiave: esempio completo modello template progetto riusabile cartella pronta fatto bene tutto insieme.

La cartella

stroop-anxiety/
├── README.md                        cos'è e come si riproduce
├── CITATION.cff                     come citare il progetto (non essenziale)
├── LICENSE                          licenze di dati, codice, materiali
├── renv.lock                        versioni esatte dei pacchetti R
├── stroop-anxiety.Rproj             progetto RStudio (working directory)
├── data/
│   ├── raw/                         export originali, sola lettura
│   ├── stroop_data.csv              un trial per riga
│   ├── stroop_dictionary.csv        definizione di ogni colonna
│   ├── questionnaire_data.csv       un partecipante per riga
│   └── questionnaire_dictionary.csv definizione di ogni colonna
├── materials/                       task e istruzioni
├── scripts/
│   ├── 01_preprocessing.R           dai grezzi ai dati puliti
│   └── 02_analysis.R                analisi e figure
└── docs/                            preregistrazione, preprint

Nomi senza spazi né accenti, script numerati nell’ordine di esecuzione, i dati grezzi separati e in sola lettura.

Il README

# Stroop and trait anxiety

Stroop interference as a function of trait anxiety.
100 adults; colour-word Stroop task (PsychoPy) and a STAI-Y questionnaire,
collected in the lab in March 2026.

## Contents
- data/stroop_data.csv — one trial per row
- data/stroop_dictionary.csv — its columns
- data/questionnaire_data.csv — one participant per row
- data/questionnaire_dictionary.csv — its columns
- data/raw/ — original exports, read-only
- scripts/01_preprocessing.R — cleans and merges the data
- scripts/02_analysis.R — models and figures
- materials/ — task and instructions
- renv.lock — exact R package versions
- stroop-anxiety.Rproj — RStudio project

## How to reproduce
Open stroop-anxiety.Rproj in RStudio (R >= 4.3), then:
  renv::restore()   # installs the exact package versions (renv.lock)
  source("scripts/01_preprocessing.R")
  source("scripts/02_analysis.R")

## License
Data CC0-1.0, code GPL-3.0, materials CC BY 4.0 (see LICENSE).
STAI-Y is a third-party instrument: not included, cite it.

## How to cite
See CITATION.cff. Dataset: https://doi.org/10.5281/zenodo.XXXXXXX

## Links
Article: https://doi.org/10.xxxx/xxxxx
Preregistration: https://doi.org/10.17605/OSF.IO/XXXXX

Il data dictionary

Un estratto di data/stroop_dictionary.csv: una riga per ogni colonna del dataset (questionnaire_dictionary.csv fa lo stesso per il questionario).

variable_name	label	type	unit	allowed_values	missing_values
participant	participant code	string		p01-p100
block	block number	integer		1-4
congruent	congruent trial (word = colour)	boolean		TRUE / FALSE
rt_ms	reaction time	integer	ms	200-2000	empty cell
correct	correct response	boolean		TRUE / FALSE

Le licenze

Componente	Licenza
Dati (data/)	CC0-1.0
Codice (scripts/)	GPL-3.0
Materiali propri (materials/)	CC BY 4.0
Strumenti di terzi (STAI-Y)	nessuna: non si depositano, si citano