From 98b1974e43d901588642ec0d89d9ab51803f2503 Mon Sep 17 00:00:00 2001
From: Felipe Domingues <53182096+domfelipe@users.noreply.github.com>
Date: Sun, 26 Apr 2026 16:10:16 -0300
Subject: [PATCH] docs: add XP system overview

---
 docs/XP_SYSTEM.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 docs/XP_SYSTEM.md

diff --git a/docs/XP_SYSTEM.md b/docs/XP_SYSTEM.md
new file mode 100644
index 0000000..6a05171
--- /dev/null
+++ b/docs/XP_SYSTEM.md
@@ -0,0 +1,14 @@
+# XP System
+
+PokeBuddy companions grow as developers work.
+
+XP can be awarded for local tasks, successful commands, tests, builds, lint, commits and future hooks.
+
+The first version keeps everything local in `~/.pokebuddy/state.json`.
+
+## Principles
+
+- Reward progress, not vanity metrics.
+- Prefer successful outcomes over raw lines of code.
+- Keep code and personal data local.
+- Make every reward feel delightful but not distracting.