docs: add PythonBox llms discovery context

Author: Lukas Geiger

.github/workflows/stale.yml

@@ -13,7 +13,7 @@ jobs:
   stale:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/stale@v9
+      - uses: actions/stale@v10
         with:
           stale-issue-message: >
             This issue has been automatically marked as stale because it has not had

.github/workflows/welcome.yml

@@ -14,7 +14,7 @@ jobs:
   welcome:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/first-interaction@v1
+      - uses: actions/first-interaction@v3
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           issue-message: |

CHANGELOG.md

@@ -6,6 +6,8 @@ Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
 ## [Unreleased]
 
 ### Hinzugefügt / Added
+- `llms.txt` mit kanonischem Repo-Kontext, Zielgruppe, Suchphrasen und Abgrenzung zu Devbox/Python-Box/Pybricks.
+- README-Starttabelle und GitHub-Actions-Badge für schnellere Nutzerführung.
 - App- und Fenstericon über `PythonBox.ico`.
 - `build_exe.bat` für lokale PyInstaller-Builds.
 - `PORTIERUNGSPLAN.md` mit Desktop-only-Strategie für Windows, macOS und Linux.
@@ -14,6 +16,7 @@ Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
 - README-SEO-Einstieg, präzisere Screenshot-Beschreibung und Discovery-Keywords für die GitHub-Suche.
 
 ### Geändert / Changed
+- Community-Workflows auf `actions/stale@v10` und `actions/first-interaction@v3` aktualisiert.
 - README, Security Policy, Contributing Guide und Code of Conduct auf das aktuelle Repository `dev-bricks/pythonbox` und die MIT-Lizenz ausgerichtet.
 - `.gitignore` um interne Steuerungsdateien, Secrets, Datenbanken, Logs, Test-Locks und Windows-/Build-Artefakte erweitert.
 - Dokumentierte Mindestversion auf Python 3.10+ vereinheitlicht, passend zur Startdatei und Testmatrix.

README.md

@@ -6,8 +6,19 @@ PythonBox ist eine lokale Python-IDE für Windows-Entwicklerinnen und -Entwickle
 
 ![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)
 ![PySide6](https://img.shields.io/badge/PySide6-6.5+-green.svg)
+![PythonBox tests](https://github.com/dev-bricks/pythonbox/actions/workflows/tests.yml/badge.svg)
 ![License](https://img.shields.io/badge/License-MIT-yellow.svg)
 
+## Start here
+
+| If you want to... | Start with |
+|---|---|
+| Try the IDE from source | `python PythonBox_v8.py` |
+| Build a local Windows EXE | `build_exe.bat` |
+| Check the regression suite | `python -m unittest discover -s tests -v` |
+| Understand the platform boundary | [PORTIERUNGSPLAN.md](PORTIERUNGSPLAN.md) |
+| Give an LLM or crawler the repo context | [llms.txt](llms.txt) |
+
 ## Why PythonBox?
 
 PythonBox is built for small Python scripts, local automation tools, learning workflows, and LLM-assisted coding sessions where a full IDE can feel too heavy. It keeps the core loop in one desktop window: open a file, edit Python, run it with the current interpreter, inspect output, debug with breakpoints, and check Git changes before handing the file to a larger IDE when needed.

llms.txt

@@ -0,0 +1,37 @@
+# PythonBox
+
+Canonical repository: https://github.com/dev-bricks/pythonbox
+Primary README: https://github.com/dev-bricks/pythonbox#readme
+Owner organization: dev-bricks
+Default branch: master
+License: MIT
+
+## Summary
+
+PythonBox is a lightweight local-first Python IDE for Windows. It combines a PySide6 editor, PDB debugging, code folding, linting hooks, Git status/diff visibility, and optional handoff to VS Code or PyCharm.
+
+## Audience
+
+- Windows users who want a focused Python editor without a full IDE setup.
+- Learners and automation builders who need run/debug/lint/Git feedback in one local desktop app.
+- LLM-assisted coding workflows where files remain local and users want a small GUI around scripts.
+
+## What this repository contains
+
+- `PythonBox_v8.py`: main PySide6 application.
+- `README.md`: user-facing overview, installation, features, privacy boundary, and discovery keywords.
+- `PORTIERUNGSPLAN.md`: platform strategy for Windows-first desktop use and source-smoke portability.
+- `tests/`: regression tests for Qt6 compatibility, execution routing, Git diff/status handling, minimap settings, and an offscreen window smoke test.
+- `.github/workflows/tests.yml`: Windows regression test workflow for Python 3.10, 3.11, and 3.12.
+
+## Search phrases
+
+python ide; lightweight python editor; pyside6 code editor; windows python ide; local-first developer tool; pdb debugger gui; python linting; code folding; git diff editor; offline python editor; VS Code handoff; PyCharm handoff.
+
+## Disambiguation
+
+PythonBox is not Jetify Devbox, Microsoft Dev Box, Box Python SDK, Pybricks, or a containerized development environment. It is a local desktop Python editor and debugger.
+
+## Safety and privacy boundary
+
+PythonBox does not include telemetry, cloud sync, bundled credentials, or built-in external service API calls. It opens, saves, and executes files only through user-triggered local workflows.