Initial import: Rechte/Pflichten/Regelwerk fuer Modul-Entwickler

README.md

@@ -0,0 +1,35 @@
+# HUBrobotix.ai — Modul-Developer-Dokumentation (Pflichtbündel)
+
+Dieser Ordner ist die **einzige Dokumentensammlung, die an Dritt-Entwickler ausgegeben wird** —
+bewusst getrennt von `docs/core/`, das interne Infrastrukturdetails (Servernamen, IPs,
+Incident-Historie) enthält und **nicht** an Externe geht. Jede Datei hier ist eine sanitierte,
+entwicklerorientierte Ableitung aus einem oder mehreren internen Konzeptdokumenten — die Quelle
+ist jeweils am Kopf jeder Datei vermerkt, damit wir bei internen Änderungen wissen, welche
+externe Datei nachgezogen werden muss.
+
+## Pflichtlektüre-Reihenfolge
+
+Ein Entwickler, der ein Modul für HUBrobotix.ai bauen will, muss **alle zehn Dateien** in dieser
+Reihenfolge gelesen haben, bevor er ein Paket einreicht (Prüf-Stufe 1 setzt das implizit voraus).
+**Datei 9 (Agent-System-Prompt)** ist zusätzlich zum Lesen auch wörtlich in den eigenen
+Coding-Agenten zu kopieren, bevor mit der eigentlichen Entwicklung begonnen wird.
+
+| # | Datei | Inhalt | Quelle (intern) |
+|---|---|---|---|
+| 1 | [00-getting-started.md](00-getting-started.md) | Überblick, erste Schritte, Ablauf in einem Bild | neu |
+| 2 | [01-manifest-schema.md](01-manifest-schema.md) | `manifest.json`-Schema, Pflichtfelder | `docs/core/module-requirements.md` |
+| 3 | [02-core-api-reference.md](02-core-api-reference.md) | `mod/data/*` + Querschnittsdienste, Scopes | `docs/core/core-api-implementation-plan.md` §3a/§9 |
+| 4 | [03-security-rules.md](03-security-rules.md) | Verbindliche Sicherheitsregeln für Module | `docs/core/hubrobotix-manifest.md` Gesetz 1–4, `security-checklist.md` |
+| 5 | [04-ui-design-guidelines.md](04-ui-design-guidelines.md) | Farb-/Komponenten-Vorgaben, verbotene Muster | `docs/core/ui-design-system.md` |
+| 6 | [05-mockup-guideline.md](05-mockup-guideline.md) | Pflicht-Klick-Dummy vor Implementierung | `docs/core/module-mockup-guideline.md` |
+| 7 | [06-submission-review-process.md](06-submission-review-process.md) | 5-stufige Prüf-Pipeline + menschliches Audit | `docs/core/module-submission-review-concept.md` |
+| 8 | [07-sandbox-usage.md](07-sandbox-usage.md) | Sandbox-Nutzung, Zugangskanäle | `docs/core/module-developer-sandbox-concept.md` §2–§9 (**nicht** §10 LIVE-Interna) |
+| 9 | [08-revenue-share.md](08-revenue-share.md) | Vergütungsmodell | `docs/billing/concept.md` §1.4 |
+| 10 | [09-agent-system-prompt.md](09-agent-system-prompt.md) | Copy-fertiger System-Prompt für den eigenen Coding-Agenten — konsolidiert 00–08 + n8n-Fallstricke + Git/Session-Isolation | neu (verdichtet aus 00–08 + interne Lehren) |
+
+## Pflege-Regel
+
+Bei jeder inhaltlichen Änderung an einem der internen Quelldokumente prüfen, ob die zugehörige
+Datei hier nachgezogen werden muss — dieser Ordner darf nicht stillschweigend veralten, während
+sich die internen Regeln weiterentwickeln. Kein internes Detail (Server-IPs, Incident-Namen,
+Personennamen, interne Tooling-Pfade wie `/opt/...`) darf in diesen Ordner gelangen.