diff --git a/docs/RC2_NOTES.md b/docs/RC2_NOTES.md
new file mode 100644
index 0000000..1279a6f
--- /dev/null
+++ b/docs/RC2_NOTES.md
@@ -0,0 +1,55 @@
+# Claro RC2 Notes
+
+RC2 is the Beginner Polish Release.
+
+## Main changes
+
+### Natural ASK prompts
+
+RC1 could read input, but examples often used a separate `SAY` line before `ASK`.
+
+RC2 supports the natural beginner form:
+
+```claro
+ASK "What is your name?" AS name
+```
+
+### Easier number input
+
+User input is still stored as text, but RC2 treats number-looking text naturally in simple comparisons and basic math:
+
+```claro
+ASK "What is 2 + 2?" AS answer
+
+IF answer = 4
+    SAY "Correct!"
+ENDIF
+```
+
+```claro
+SET a TO "4"
+SET b TO "6"
+SAY a + b
+```
+
+prints:
+
+```text
+10
+```
+
+### More beginner examples
+
+The examples folder now includes a clearer first path for learners:
+
+- `hello.claro`
+- `name_input.claro`
+- `quiz.claro`
+- `guessing_game.claro`
+- `shopping_list.claro`
+- `save_and_load_file.claro`
+- `functions_example.claro`
+
+## Still not final 1.0
+
+RC2 is for testing and feedback. The next milestone should focus on documentation polish, fuller checker coverage, and final package cleanup.