diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 0000000..16e481d
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,13 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+max_line_length = 100
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
index 93f0dff..096faac 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,7 +6,6 @@ dist
 .env.*
 *.log
 .DS_Store
-.vscode/
 .idea/
 coverage/
 
diff --git a/.vscode/extensions.json b/.vscode/extensions.json
new file mode 100644
index 0000000..a1ba4ba
--- /dev/null
+++ b/.vscode/extensions.json
@@ -0,0 +1,6 @@
+{
+  "recommendations": [
+    "editorconfig.editorconfig",
+    "esbenp.prettier-vscode"
+  ]
+}
\ No newline at end of file
diff --git a/.vscode/settings.json b/.vscode/settings.json
new file mode 100644
index 0000000..7dc9573
--- /dev/null
+++ b/.vscode/settings.json
@@ -0,0 +1,9 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "editor.insertSpaces": true,
+  "editor.tabSize": 2,
+  "files.eol": "\n",
+  "prettier.configPath": ".prettierrc",
+  "prettier.useEditorConfig": true
+}
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 111ac0d..e087cf7 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -61,6 +61,13 @@ O script `scripts/validate-wordlists.ts` verifica:
 
 O CI roda isso automaticamente em todo PR.
 
+## Setup do editor (VS Code / Cursor)
+
+Para manter a formatação consistente (Prettier/ESLint) e reduzir ruído no diff, instale as **extensões recomendadas do workspace**:
+
+- Ao abrir o projeto, aceite o prompt de **instalar as extensões recomendadas**.
+- Alternativamente, abra a aba de Extensões e procure por **Recomendadas** (workspace) ou use o comando **“Extensions: Show Recommended Extensions”**.
+
 ## Checklist do PR
 
 - [ ] Palavra em lowercase, sem acentos