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.