From 42c38c30f7c5c9b59b90ee16c2e74ee9f14a764f Mon Sep 17 00:00:00 2001
From: Davide Grilli <davide.grilli@outlook.com>
Date: Mon, 13 Apr 2026 08:02:48 +0200
Subject: [PATCH] project setup: gitignore, CLAUDE.md, requirements

Aggiunge configurazione base del progetto:
- .gitignore: esclude venv, sources, processed, chroma_db e report generati
- CLAUDE.md: documenta l'uso obbligatorio del venv
- requirements.txt: dipendenze dirette (pdfplumber per step 0-1)
---
 .gitignore       | 27 +++++++++++++++++++++++++++
 CLAUDE.md        | 19 +++++++++++++++++++
 requirements.txt |  2 ++
 3 files changed, 48 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 CLAUDE.md
 create mode 100644 requirements.txt

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..4b233cc
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,27 @@
+# Virtual environment
+.venv/
+
+# PDF originali — file pesanti, non versionare
+sources/
+
+# Output pipeline — generati dagli script, non versionare
+processed/
+chroma_db/
+
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Report generati dagli script
+step-0/*_step0_report.txt
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..612c1f3
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,19 @@
+# CLAUDE.md — RAG from Scratch
+
+## Ambiente
+
+Questo progetto usa un **virtual environment Python**.
+Tutte le dipendenze e i comandi Python devono essere eseguiti nel venv.
+
+```bash
+# Creazione (una volta sola)
+python -m venv .venv
+
+# Attivazione
+source .venv/bin/activate
+
+# Installazione dipendenze
+pip install -r requirements.txt
+```
+
+Non installare mai pacchetti a livello di sistema con `pip install` senza venv attivo.
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..e5577a4
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,2 @@
+# Step 0-1 — Ispezione e verifica PDF
+pdfplumber==0.11.9