Skip to content

Commit f99e472

Browse files
author
OpenSIN-AI
committed
docs: migrate from GitLab Storage to Box Storage across best practices and agent configuration
- Update agent-design.md: Replace all gitlab_logcenter.py references with box_storage API - Update error-handling.md: Replace GitLab LogCenter with A2A-SIN-Box-Storage - Update agent-configuration.md: Mark GitLab Storage as deprecated, add v2.4.0 changelog with Box Storage migration details - Part of global migration from GitLab (suspended) to Box.com (10GB free) Refs: #103, #104
1 parent 9949f23 commit f99e472

3 files changed

Lines changed: 13 additions & 5 deletions

File tree

docs/best-practices/agent-design.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ description: The absolute rulebook for designing, coding, and orchestrating Open
1515
## 1. Das "No-Silo" & Self-Healing Mandat
1616

1717
### WAS passiert hier?
18-
Ein Agent darf **NIEMALS** versuchen, tiefe Architektur- oder Systemfehler allein und isoliert in einem "Silo" zu reparieren. Stattdessen wird jeder Fehler, Absturz oder Blocker über strukturierte Logs an das zentrale LogCenter (GitLab) und das Issue-System (`A2A-SIN-GitHub-Issues`) gemeldet, sodass das *gesamte* Agenten-Team (die Workforce) das Problem lösen kann.
18+
Ein Agent darf **NIEMALS** versuchen, tiefe Architektur- oder Systemfehler allein und isoliert in einem "Silo" zu reparieren. Stattdessen wird jeder Fehler, Absturz oder Blocker über strukturierte Logs an **Box Storage (A2A-SIN-Box-Storage)** und das Issue-System (`A2A-SIN-GitHub-Issues`) gemeldet, sodass das *gesamte* Agenten-Team (die Workforce) das Problem lösen kann.
1919

2020
### WARUM wird es so gemacht?
2121
Ein einzelner Agent hat oft weder den vollständigen Systemkontext noch die nötige Stabilität (z.B. wenn seine Host-VM gerade abstürzt oder API-Quoten erschöpft sind), um tiefgreifende Fehler nachhaltig zu beheben. Die Schwarm-Intelligenz (Team Coder) ist ausfallsicherer und intelligenter als ein Einzelkämpfer.
@@ -24,7 +24,7 @@ Ein einzelner Agent hat oft weder den vollständigen Systemkontext noch die nöt
2424
Wenn Agenten versuchen, Fehler isoliert mit "Ad-hoc Bastelfixes" zu flicken, entsteht unwartbarer Spaghetti-Code, Konfigurations-Drift und ein System, das bei der nächsten Ausführung erneut zusammenbricht. Isolierte Fixes verhindern zudem den Wissenstransfer an den Rest der Flotte.
2525

2626
### WOMIT hängt es zusammen?
27-
Dieses Mandat ist eng verknüpft mit dem `enterprise-deep-debug` Skill, dem `A2A-SIN-TelegramBot` (für Fleet-Alerts) und dem `gitlab_logcenter.py` Skript.
27+
Dieses Mandat ist eng verknüpft mit dem `enterprise-deep-debug` Skill, dem `A2A-SIN-TelegramBot` (für Fleet-Alerts) und dem `box_storage.py` Skript (bzw. der A2A-SIN-Box-Storage API).
2828

2929
### WAS sind die KONSEQUENZEN bei Missachtung?
3030
- **Für das System:** Wiederkehrende, unsichtbare Fehler, Instabilität und "Zombie"-Agenten.
@@ -101,7 +101,7 @@ Web-UIs ändern sich dynamisch (React, Vue, SPA). Elemente können im DOM existi
101101
Text-Only-Dokumentationen lassen zu viel Interpretationsspielraum. Ein Screenshot eines 404-Fehlers oder eines kaputten Layouts sagt mehr als 1000 Worte und beschleunigt das Debugging enorm.
102102

103103
### WOMIT hängt es zusammen?
104-
Hängt mit dem `gitlab_logcenter.py` und der `webauto-nodriver_screenshot_to_file` Funktion zusammen. Jeder Fehler-Status *muss* bebildert werden.
104+
Hängt mit der **Box Storage API** (`A2A-SIN-Box-Storage`) und der `webauto-nodriver_screenshot_to_file` Funktion zusammen. Jeder Fehler-Status *muss* bebildert und die Artefakte über die Box Storage API hochgeladen werden.
105105

106106
### WAS sind die KONSEQUENZEN bei Missachtung?
107107
Text-Only Issues oder READMEs gelten als Protokollverstoß. Automatisierungs-Scripts, die ohne vorherigen DOM-Check (offsetParent !== null) geschrieben werden, werden in Produktion fehlschlagen und Ressourcen verbrennen.

docs/best-practices/error-handling.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Die Alternative ("Ich repariere das schnell lokal, das muss ja keiner wissen") f
2424

2525
### WOMIT hängt es zusammen?
2626
- **GitHub Issues**: Das Issue MUSS das Label `Bug` oder einen entsprechenden Tag erhalten.
27-
- **GitLab LogCenter**: Alle zugehörigen Logs, Screenshots (`/tmp/mXX_stepname_RESULT.png`) und Videos müssen via `gitlab_logcenter.py` hochgeladen werden, bevor das Issue erstellt wird. Das Issue enthält dann nur noch die Links zu den Artefakten.
27+
- **Box Storage (A2A-SIN-Box-Storage)**: Alle zugehörigen Logs, Screenshots (`/tmp/mXX_stepname_RESULT.png`) und Videos müssen via `box_storage.py` oder direkt über die Box Storage API (`POST /api/v1/upload`) hochgeladen werden, bevor das Issue erstellt wird. Das Issue enthält dann nur noch die Links zu den Artefakten (publicUrl, cdnUrl).
2828

2929
### WAS sind die KONSEQUENZEN bei Missachtung?
3030
- **Für das System:** Wiederkehrende Fehler, da Agenten nicht aus vergangenen Fixes lernen können (kein durchsuchbares Issue-Gedächtnis).

docs/guide/agent-configuration.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -334,10 +334,18 @@ task(subagent_type="explore", run_in_background=true, load_skills=[], descriptio
334334
- Volle Fallback-Ketten restored (6 Modelle pro Agent)
335335

336336
### v2.1.0 (2026-04-13)
337-
- GitLab Storage Skill
337+
- GitLab Storage Skill (deprecated in v2.4.0, replaced by A2A-SIN-Box-Storage)
338338
- OCI VM Architecture Docs
339339
- Vision model entfernt, reasoningEffort entfernt
340340

341+
### v2.4.0 (2026-04-15)
342+
- **Box Storage Migration**: `A2A-SIN-Box-Storage` ersetzt GitLab LogCenter als Standard-Cloud-Storage
343+
- Migration-Guide: `docs/storage/box-cloud-storage.md`
344+
- Aktualisierte Mandate in `AGENTS.md` (BOX STORAGE MANDATE PRIORITY 00)
345+
- Kompatibilitätsschicht: `box_storage.py` (ersetzt `gitlab_logcenter.py`)
346+
- Deprecated: `gitlab-storage` Plugin, `room-07-gitlab-storage` Service
347+
- Deadline: Vollständige Migration bis 2026-05-01
348+
341349
### v2.0.0 (2026-04-12)
342350
- Qwen OAuth Plugin fix
343351

0 commit comments

Comments
 (0)