docs(marketing): add LLM-Ready/Ecosystem badges, GFM callouts, Mermaid architecture & update llms.txt date

Author: lukisch

CHANGELOG.md

@@ -6,8 +6,10 @@ Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
 ## [Unreleased]
 
 ### Geändert / Changed
+- Discoverability & Marketing Audit (2026-07-26): `README.md` & `README_de.md` mit LLM-Ready-, Ecosystem- und Umbrella-Badges, GFM-Hinweisboxen (`> [!NOTE]` / `> [!TIP]`) und Mermaid-Systemarchitekturdiagramm erweitert; `llms.txt` Header auf `Last-checked: 2026-07-26` aktualisiert (92/92 Pytest-Tests 100% grün).
 - Dokumentations- & Sichtbarkeitspflege (2026-07-24): `llms.txt` auf `Last-checked: 2026-07-24` mit aktualisierter Testsuite-Beschreibung (92 Pytest-Tests) aktualisiert, dedizierte deutsche Startseite (`README_de.md`) angelegt, zweisprachige Sprachwahl-Navigation (`[English](README.md) | [Deutsch](README_de.md)`) oben in den READMEs integriert und Test-Badge ergänzt.
 
+
 ### Build / Release
 - EXE neu gebaut 2026-06-04 (PyInstaller, OneDrive-externer Build); `START_PythonBox_v8.bat` startet jetzt bevorzugt `dist\PythonBox.exe` und fällt danach auf Root-EXE bzw. Python-Fallback zurück. SHA256: `1F5C024682B5B77BD04963E972F3EDAB9D9E606DE1339D390D2181A8606672BC`.
 - EXE neu gebaut 2026-06-01 (PyInstaller `--onefile`, `PythonBox.exe`); 14/14 Tests grün, Smoke-Test bestanden. Vorherige EXE: 2026-04-29.

README.md

@@ -10,10 +10,19 @@
 [![PySide6](https://img.shields.io/badge/PySide6-6.5+-green.svg)](https://pypi.org/project/PySide6/)
 [![PythonBox tests](https://github.com/dev-bricks/pythonbox/actions/workflows/tests.yml/badge.svg)](https://github.com/dev-bricks/pythonbox/actions/workflows/tests.yml)
 [![Tests](https://img.shields.io/badge/Tests-92%20passed-brightgreen.svg)](tests/)
+[![LLM-Ready](https://img.shields.io/badge/LLM--Ready-llms.txt-blueviolet.svg)](llms.txt)
+[![Ecosystem](https://img.shields.io/badge/Ecosystem-dev--bricks-blue.svg)](https://github.com/dev-bricks)
+[![Umbrella](https://img.shields.io/badge/Umbrella-open--bricks-indigo.svg)](https://github.com/open-bricks)
 [![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 PythonBox is a local-first Python IDE for Windows developers who want a focused editor with PySide6, PDB debugging, code folding, linting, Git status, and optional handoff to VS Code or PyCharm.
 
+> [!NOTE]
+> **Local-First & Zero Telemetry**: PythonBox is engineered to run 100% offline with zero cloud sync, zero telemetry, and local file storage. It is fully indexable and optimized for LLM-assisted workflows via `llms.txt`.
+
+> [!TIP]
+> **PDB Debugging & Headless Mode**: Toggle breakpoints directly in the GUI editor or launch PythonBox headlessly in CI/automation pipelines using `--run demo.py` or `--lint demo.py`.
+
 ## Start here
 
 | If you want to... | Start with |
@@ -28,8 +37,34 @@ PythonBox is a local-first Python IDE for Windows developers who want a focused
 
 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.
 
+## System Architecture
+
+```mermaid
+flowchart TD
+    subgraph GUI ["PythonBox PySide6 Desktop GUI"]
+        ED["Editor Window (QTextEdit / Minimap)"]
+        DBG["PDB Debugger Panel"]
+        OUT["Console & Output Log"]
+        GIT_PANEL["Git Status & Diff Markers"]
+    end
+
+    subgraph CORE ["Core Engine"]
+        LINT["Linter Hook (Flake8 / Pylint / AST Fallback)"]
+        EXEC["Interpreter Runner (sys.executable)"]
+        HANDOFF["Handoff Bridge (VS Code / PyCharm)"]
+    end
+
+    ED --> EXEC
+    ED --> LINT
+    EXEC --> OUT
+    EXEC --> DBG
+    ED --> HANDOFF
+    GIT_PANEL --> ED
+```
+
 ## Screenshot
 
+
 ![PythonBox dark-theme Python IDE with editor, minimap, output panel, and local debugging controls](README/screenshots/main.png)
 
 ## Features

README_de.md

@@ -10,10 +10,19 @@
 [![PySide6](https://img.shields.io/badge/PySide6-6.5+-green.svg)](https://pypi.org/project/PySide6/)
 [![PythonBox tests](https://github.com/dev-bricks/pythonbox/actions/workflows/tests.yml/badge.svg)](https://github.com/dev-bricks/pythonbox/actions/workflows/tests.yml)
 [![Tests](https://img.shields.io/badge/Tests-92%20passed-brightgreen.svg)](tests/)
+[![LLM-Ready](https://img.shields.io/badge/LLM--Ready-llms.txt-blueviolet.svg)](llms.txt)
+[![Ecosystem](https://img.shields.io/badge/Ecosystem-dev--bricks-blue.svg)](https://github.com/dev-bricks)
+[![Umbrella](https://img.shields.io/badge/Umbrella-open--bricks-indigo.svg)](https://github.com/open-bricks)
 [![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 PythonBox ist eine lokale Python-IDE für Windows-Entwicklerinnen und -Entwickler, die einen fokussierten Editor mit PySide6, PDB-Debugging, Code Folding, Linting, Git-Status und optionaler Übergabe an VS Code oder PyCharm suchen.
 
+> [!NOTE]
+> **Local-First & Zero-Telemetry**: PythonBox läuft 100% lokal ohne Cloud-Zwang, ohne Telemetrie und speichert Daten ausschließlich auf dem lokalen Dateisystem. Das Repository ist für KI-Agenten und LLM-Workflows über `llms.txt` optimiert.
+
+> [!TIP]
+> **PDB-Debugging & Headless-Modus**: Breakpoints lassen sich direkt im GUI-Editor setzen oder in CI/Automatisierungs-Pipelines headless über `--run demo.py` bzw. `--lint demo.py` ausführen.
+
 ## Schnellstart
 
 | Ziel | Startbefehl / Datei |
@@ -28,8 +37,34 @@ PythonBox ist eine lokale Python-IDE für Windows-Entwicklerinnen und -Entwickle
 
 PythonBox wurde für kleine Python-Skripte, lokale Automatisierungstools, Lern-Workflows und KI-unterstützte Coding-Sessions entwickelt, bei denen eine vollständige IDE zu schwerfällig wirkt. Es hält den Kern-Workflow in einem einzigen Desktop-Fenster: Datei öffnen, Python editieren, mit dem aktuellen Interpreter ausführen, Ausgaben prüfen, mit Breakpoints debuggen und Git-Änderungen einsehen, bevor die Datei bei Bedarf an eine größere IDE übergeben wird.
 
+## Systemarchitektur
+
+```mermaid
+flowchart TD
+    subgraph GUI ["PythonBox PySide6 Desktop GUI"]
+        ED["Editor-Fenster (QTextEdit / Minimap)"]
+        DBG["PDB-Debugger Panel"]
+        OUT["Konsole & Output-Log"]
+        GIT_PANEL["Git-Status & Diff-Markierungen"]
+    end
+
+    subgraph CORE ["Kern-Engine"]
+        LINT["Linter-Hook (Flake8 / Pylint / AST-Fallback)"]
+        EXEC["Interpreter-Runner (sys.executable)"]
+        HANDOFF["Handoff-Brücke (VS Code / PyCharm)"]
+    end
+
+    ED --> EXEC
+    ED --> LINT
+    EXEC --> OUT
+    EXEC --> DBG
+    ED --> HANDOFF
+    GIT_PANEL --> ED
+```
+
 ## Screenshot
 
+
 ![PythonBox dark-theme Python IDE mit Editor, Minimap, Output-Panel und lokalem Debugging](README/screenshots/main.png)
 
 ## Funktionen / Features

llms.txt

@@ -46,4 +46,4 @@ PythonBox is not Jetify Devbox, Microsoft Dev Box, Box Python SDK, Pybricks, or
 
 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.
 
-## Last-checked: 2026-07-24
+## Last-checked: 2026-07-26