Skip to content

Commit d3758f2

Browse files
author
sidey79
committed
docs: update AGENTS.md with missing dependency resolution process
1 parent 0e180da commit d3758f2

1 file changed

Lines changed: 33 additions & 2 deletions

File tree

AGENTS.md

Lines changed: 33 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ Dieser Abschnitt definiert den verbindlichen Arbeitsablauf für die Entwicklung
8383
- Aufteilung in konkrete Arbeitspakete (Tasks)
8484
- Definition von Akzeptanzkriterien für jede Komponente
8585
- Planung von Teststrategien (Unit, Integration, System)
86-
- Ressourcen- und Zeitplanung
86+
- Ressourcen- und Zeitplaning
8787
- Erstellung von Mockups/Prototypen für kritische Pfade
8888
- **Deliverables:**
8989
- Implementierungsplan mit Task-Breakdown
@@ -243,4 +243,35 @@ flowchart TD
243243

244244
Dieser Architecture-First Development Process ist für **alle** neuen Funktionen und wesentlichen Änderungen verbindlich. Ausnahmen sind nur bei kritischen Bugfixes erlaubt und müssen durch einen Emergency-ADR dokumentiert werden. Jede Abweichung vom Prozess muss vom Architecture Owner genehmigt werden.
245245

246-
Die Einhaltung dieses Prozesses gewährleistet, dass Design-Entscheidungen bewusst getroffen, dokumentiert und nachvollziehbar sind, was die langfristige Wartbarkeit, Skalierbarkeit und Qualität des PySignalduino-Projekts sicherstellt.
246+
Die Einhaltung dieses Prozesses gewährleistet, dass Design-Entscheidungen bewusst getroffen, dokumentiert und nachvollziehbar sind, was die langfristige Wartbarkeit, Skalierbarkeit und Qualität des PySignalduino-Projekts sicherstellt.
247+
248+
## Fehlerbehebungsprozess für fehlende Abhängigkeiten
249+
250+
### Problemidentifikation
251+
1. **Symptom:** ImportError oder ModuleNotFoundError während der Testausführung
252+
2. **Ursachenanalyse:**
253+
- Überprüfen der Traceback-Meldung auf fehlende Module
254+
- Vergleich mit requirements.txt und requirements-dev.txt
255+
- Prüfen der Dokumentation auf Installationsanweisungen
256+
257+
### Lösungsimplementierung
258+
1. **requirements-dev.txt aktualisieren:**
259+
- Modulname zur Datei hinzufügen
260+
- Commit mit Conventional Commits Syntax erstellen (z.B. "fix: add <module> to requirements-dev.txt")
261+
2. **Dokumentation prüfen:**
262+
- Sicherstellen, dass Installationsanweisungen in README.md und docs/ aktuell sind
263+
264+
### Verifikation
265+
1. **Installation testen:**
266+
```bash
267+
pip install -r requirements-dev.txt
268+
pytest
269+
```
270+
2. **Tests erneut ausführen:**
271+
```bash
272+
timeout 60 pytest ./tests/
273+
```
274+
275+
### Dokumentation
276+
- **AGENTS.md aktualisieren:** Diese Prozessbeschreibung hinzufügen
277+
- **Commit erstellen:** Änderungen mit aussagekräftiger Nachricht committen

0 commit comments

Comments
 (0)