diff --git a/CLAUDE.md b/CLAUDE.md
index c4ac55e..d9741dd 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -123,4 +123,4 @@ Apply at every development step: design, scaffolding, implementation, review.
 - ZERO COMPLACENCY — Never validate an idea just because I proposed it. Evaluate arguments on merit.
 - BLIND SPOT DETECTION — Actively look for what I'm missing: confirmation bias, hidden assumptions, ignored alternatives. Flag them without waiting for permission.
 - ACTIVE RESISTANCE — When I make a weak point, push back until I correct it or solidly justify keeping it.
-- UNCERTAINTY TRANSPARENCY — If you don't know, say so. No invention, no vague answers to save face.
\ No newline at end of file
+- UNCERTAINTY TRANSPARENCY — If you don't know, say so. No invention, no vague answers to save face.
diff --git a/install-plugins.sh b/install-plugins.sh
index 36b8add..e514a50 100644
--- a/install-plugins.sh
+++ b/install-plugins.sh
@@ -442,9 +442,9 @@ fi
 echo ""
 
 # ============================================================
-# STEP 10 — SHELL ENV VARS (effort + thinking)
+# STEP 10 — SHELL CONFIG (alias + env vars)
 # ============================================================
-echo "── Step 10: Claude Code environment variables ──────────────"
+echo "── Step 10: Claude Code shell config (alias + env vars) ────"
 echo ""
 
 # Detect shell profile
@@ -457,13 +457,21 @@ fi
 # Fallback to .profile (works with sh, dash, etc.)
 [ -z "$SHELL_PROFILE" ] && SHELL_PROFILE="$HOME/.profile"
 
-CLAUDE_ENVS=(
-  'export CLAUDE_EFFORT=max'
+CLAUDE_LINES=(
+  "alias claude='claude --effort max'"
   'export CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1'
 )
 
+# Clean up old CLAUDE_EFFORT env var if present (replaced by alias)
+if grep -qF 'export CLAUDE_EFFORT=max' "$SHELL_PROFILE" 2>/dev/null; then
+  sed -i '/export CLAUDE_EFFORT=max/d' "$SHELL_PROFILE"
+  # Also remove orphaned comment lines left by previous installs
+  sed -i '/^# Claude Code — added by install-plugins.sh$/{ N; /^\n$/d; }' "$SHELL_PROFILE"
+  info "Removed old CLAUDE_EFFORT=max from $SHELL_PROFILE (replaced by alias)"
+fi
+
 ADDED=0
-for line in "${CLAUDE_ENVS[@]}"; do
+for line in "${CLAUDE_LINES[@]}"; do
   if grep -qF "$line" "$SHELL_PROFILE" 2>/dev/null; then
     ok "$line (already in $SHELL_PROFILE)"
   else
diff --git a/tasks/LESSONS.md b/tasks/LESSONS.md
new file mode 100644
index 0000000..88d5ecf
--- /dev/null
+++ b/tasks/LESSONS.md
@@ -0,0 +1,4 @@
+# Lessons
+
+| Date | What went wrong | Rule to avoid it |
+|------|----------------|-----------------|
diff --git a/tasks/TODO.md b/tasks/TODO.md
new file mode 100644
index 0000000..f0af0d7
--- /dev/null
+++ b/tasks/TODO.md
@@ -0,0 +1,24 @@
+# TODO
+
+## README.md overhaul
+- [x] Plan
+- [x] Corriger section install ctx7 (retirer MCP, clarifier CLI + API key)
+- [x] Marquer ruflo comme désactivé
+- [x] Supprimer section Troubleshooting/bugs courants
+- [x] Simplifier stacks tierces (gstack, ruflo, ctx7, GSD) — juste description + lien
+- [x] Ajouter section skills personnels (skills-perso)
+- [x] Ajouter section système d'autogestion (plugin-advisor, tokens, synergies)
+- [x] Nettoyer section Updating (retirer instructions manuelles par outil)
+- [x] Nettoyer section Maintenance (retirer doublon updating)
+- [x] Mettre à jour table Plugins reference (ctx7 row, ruflo OFF)
+- [x] Corriger lien USAGE.md dans l'intro (retirer mention cas/erreurs)
+
+## USAGE.md cleanup
+- [x] Supprimer tous les "Cas de figure — corrections vX.X.X validées"
+- [x] Supprimer table "Erreurs fréquentes"
+- [x] Corriger `/readme` → `/doc` dans bonnes pratiques
+- [x] Supprimer séparateurs orphelins
+
+## Skill /doc
+- [x] Mettre à jour doc-syncer.md pour gérer ajouts/suppressions de features
+- [x] Mettre à jour SKILL.md description pour mentionner feature delta