You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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
Copy file name to clipboardExpand all lines: docs/best-practices/agent-design.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ description: The absolute rulebook for designing, coding, and orchestrating Open
15
15
## 1. Das "No-Silo" & Self-Healing Mandat
16
16
17
17
### 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.
19
19
20
20
### WARUM wird es so gemacht?
21
21
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
24
24
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.
25
25
26
26
### 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).
28
28
29
29
### WAS sind die KONSEQUENZEN bei Missachtung?
30
30
-**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
101
101
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.
102
102
103
103
### 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.
105
105
106
106
### WAS sind die KONSEQUENZEN bei Missachtung?
107
107
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.
Copy file name to clipboardExpand all lines: docs/best-practices/error-handling.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ Die Alternative ("Ich repariere das schnell lokal, das muss ja keiner wissen") f
24
24
25
25
### WOMIT hängt es zusammen?
26
26
-**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).
28
28
29
29
### WAS sind die KONSEQUENZEN bei Missachtung?
30
30
-**Für das System:** Wiederkehrende Fehler, da Agenten nicht aus vergangenen Fixes lernen können (kein durchsuchbares Issue-Gedächtnis).
0 commit comments