From d6c8fee61f94b8daba5b83ce0ce40a09a552c3a4 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Mon, 10 Aug 2026 23:29:22 +0000
Subject: [PATCH] feat: add llms.txt v2 support for AI agents

Added `public/llms.txt` following the llms.txt v2 specification to help AI agents navigate and understand the project's structure and contents. Included a `<link rel="describedby" href="/llms.txt" />` tag in the `index.html` file to make the file discoverable by agents.

Co-authored-by: albertoivo <1276520+albertoivo@users.noreply.github.com>
---
 index.html         |  3 +++
 public/llms.txt    | 26 ++++++++++++++++++++++++++
 public/sitemap.xml | 32 ++++++++++++++++----------------
 3 files changed, 45 insertions(+), 16 deletions(-)
 create mode 100644 public/llms.txt

diff --git a/index.html b/index.html
index 65ee7cc..67e699d 100644
--- a/index.html
+++ b/index.html
@@ -110,6 +110,9 @@
 
   <link rel="manifest" href="/manifest.webmanifest" />
 
+  <!-- LLMs.txt para IA -->
+  <link rel="describedby" href="/llms.txt" />
+
   <!-- Icons -->
   <link rel="icon" type="image/svg+xml" href="/icons/icon.svg" />
   <link rel="icon" type="image/x-icon" href="/favicon.ico" />
diff --git a/public/llms.txt b/public/llms.txt
new file mode 100644
index 0000000..1583003
--- /dev/null
+++ b/public/llms.txt
@@ -0,0 +1,26 @@
+# PyExplorer
+
+> PyExplorer is an innovative educational game developed in ReactJS, specially created to teach Python programming in a gamified and engaging way for children and teenagers (8 to 15 years old). It uses modern web technologies like Pyodide (WebAssembly) to execute Python code directly in the browser.
+
+Important notes:
+- The platform features 4 Epic Sagas and 18 Worlds covering everything from basic concepts to APIs and Data manipulation.
+- Includes advanced gamification with stars, coins, achievements, daily streaks, dynamic missions, and a virtual store.
+- Supports 8 interactive question types, including multiple choice, code filling, Parsons problems, and visual Turtle challenges.
+- PyExplorer functions as a PWA, allowing offline play, and includes an embedded Monaco Editor for writing Python code.
+
+## Main Pages
+
+- [Home](https://pyexplorer.com.br/): The landing page and main entry point.
+- [Learn](https://pyexplorer.com.br/learn): Educational articles and tutorials about Python and programming for kids.
+- [About](https://pyexplorer.com.br/about): Information about the project and its goals.
+
+## Game and User Areas
+
+- [Game](https://pyexplorer.com.br/game): The main game area where users solve Python challenges (Requires login or guest mode).
+- [Profile](https://pyexplorer.com.br/profile): User profile, progress, and settings (Requires login or guest mode).
+- [Rewards](https://pyexplorer.com.br/rewards): The virtual store and achievements page (Requires login or guest mode).
+- [Certificate](https://pyexplorer.com.br/certificate): Generate a custom PDF certificate upon completion.
+
+## Optional
+
+- [Sitemap](https://pyexplorer.com.br/sitemap.xml): The XML sitemap containing all indexable URLs.
diff --git a/public/sitemap.xml b/public/sitemap.xml
index 9f32875..dd491dc 100644
--- a/public/sitemap.xml
+++ b/public/sitemap.xml
@@ -2,97 +2,97 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://pyexplorer.com.br</loc>
-    <lastmod>2026-06-07</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>1.0</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/login</loc>
-    <lastmod>2026-07-24</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.5</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/register</loc>
-    <lastmod>2026-07-24</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.5</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/learn</loc>
-    <lastmod>2026-05-16</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>weekly</changefreq>
     <priority>0.9</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/python-para-criancas</loc>
-    <lastmod>2026-06-07</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.5</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/aprender-python-jogando</loc>
-    <lastmod>2026-06-07</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.5</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/about</loc>
-    <lastmod>2026-05-16</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.5</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/learn/o-que-e-python</loc>
-    <lastmod>2026-07-24</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/learn/por-que-aprender-python</loc>
-    <lastmod>2026-07-24</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/learn/python-para-criancas</loc>
-    <lastmod>2026-07-24</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/learn/como-ensinar-python-criancas</loc>
-    <lastmod>2026-07-24</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/learn/primeiros-passos-python</loc>
-    <lastmod>2026-07-24</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/learn/jogos-aprender-programacao</loc>
-    <lastmod>2026-07-24</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/learn/exercicios-python-criancas</loc>
-    <lastmod>2026-07-24</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/learn/scratch-vs-python</loc>
-    <lastmod>2026-07-24</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://pyexplorer.com.br/learn/projetos-python-criancas</loc>
-    <lastmod>2026-07-24</lastmod>
+    <lastmod>2026-08-10</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>