diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 000000000..4efcb7b86
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,6 @@
+# Contribuer
+
+1. Fork.
+2. Branche de feature.
+3. Commits clairs (conventional commits).
+4. PR avec description précise.
diff --git a/DEPLOY_STEPS.md b/DEPLOY_STEPS.md
new file mode 100644
index 000000000..df871c664
--- /dev/null
+++ b/DEPLOY_STEPS.md
@@ -0,0 +1,14 @@
+# Étapes de déploiement (Hardhat)
+
+1. Copier `.env.example` en `.env` et renseigner les variables (RPC + PRIVATE_KEY testnet).
+2. Installer: `pnpm install` (ou `yarn` / `npm i`).
+3. Compiler: `pnpm hardhat compile`.
+4. Déployer Greeter sur Base Sepolia:
+   ```
+   pnpm hardhat run scripts/deploy_greeter.ts --network baseSepolia
+   ```
+5. L'adresse est écrite dans `addresses/base-sepolia.json`.
+6. (Optionnel) Vérifier le contrat sur BaseScan:
+   ```
+   VERIFY_ADDRESS=0x... pnpm hardhat verify --network baseSepolia 0x...
+   ```