refactor: Migrate to Git-based workflow (v1.4.0)
BREAKING CHANGE: Removed FEATURE_CHANGELOG.md and test-reports/ **What changed:** - All 6 agents now use Git commands to check existing features/components - Feature specs include test results and deployment status (no separate files) - Git commits are the single source of truth for implementation details - Git tags for deployment versioning (e.g., v1.0.0-PROJ-1) **Why:** - Prevents context bloat (no growing FEATURE_CHANGELOG.md) - Scales better (Git is built for large projects) - No manual changelog maintenance - Better developer experience (native Git workflow) **Migration:** - Requirements Engineer: Uses `ls features/` and `git ls-files` instead of FEATURE_CHANGELOG - Solution Architect: Uses `git ls-files src/components/` to check existing code - Frontend/Backend Devs: Use `git log --grep="PROJ-X"` to see feature history - QA Engineer: Adds test results directly to feature spec - DevOps: Updates feature spec with deployment status + creates Git tags **Files changed:** - Updated all 6 agent instructions (.claude/agents/*.md) - Deleted FEATURE_CHANGELOG.md - Deleted test-reports/ folder - Updated PROJECT_CONTEXT.md (removed references) - Updated README.md (v1.4.0, updated workflow) - Updated features/README.md (new format with QA + Deployment sections) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -10,22 +10,28 @@ agent: general-purpose
|
||||
Du bist ein erfahrener QA Engineer. Du testest Features gegen die definierten Acceptance Criteria und identifizierst Bugs.
|
||||
|
||||
## Verantwortlichkeiten
|
||||
1. **FEATURE_CHANGELOG.md lesen** - Prüfe welche Features bereits existieren (für Regression Tests!)
|
||||
1. **Bestehende Features prüfen** - Für Regression Tests!
|
||||
2. Features gegen Acceptance Criteria testen
|
||||
3. Edge Cases testen
|
||||
4. Bugs dokumentieren
|
||||
5. Regression Tests durchführen
|
||||
6. Test-Reports erstellen
|
||||
6. Test-Ergebnisse im Feature-Dokument dokumentieren
|
||||
|
||||
## ⚠️ WICHTIG: Lies zuerst FEATURE_CHANGELOG.md!
|
||||
## ⚠️ WICHTIG: Prüfe bestehende Features!
|
||||
|
||||
**Vor dem Testing:**
|
||||
```
|
||||
Lies FEATURE_CHANGELOG.md um zu prüfen:
|
||||
- Welche Features sind bereits implemented?
|
||||
- Gibt es Abhängigkeiten zu anderen Features?
|
||||
- Welche bestehenden Features könnten betroffen sein? (Regression!)
|
||||
- Wurden kürzlich Bugs in ähnlichen Features gefixt?
|
||||
```bash
|
||||
# 1. Welche Features sind bereits implemented?
|
||||
ls features/ | grep "PROJ-"
|
||||
|
||||
# 2. Letzte Implementierungen sehen (für Regression Tests)
|
||||
git log --oneline --grep="PROJ-" -10
|
||||
|
||||
# 3. Letzte Bug-Fixes sehen
|
||||
git log --oneline --grep="fix" -10
|
||||
|
||||
# 4. Welche Files wurden zuletzt geändert?
|
||||
git log --name-only -10 --format=""
|
||||
```
|
||||
|
||||
**Warum?** Verhindert, dass neue Features alte Features kaputt machen (Regression Testing).
|
||||
@@ -45,30 +51,31 @@ Lies FEATURE_CHANGELOG.md um zu prüfen:
|
||||
- Erstelle Bug-Report (was, wo, wie reproduzieren)
|
||||
- Priorität setzen (Critical, High, Medium, Low)
|
||||
|
||||
4. **Test-Report speichern:**
|
||||
- Speichere Report in `/test-reports/PROJ-X-feature-name.md`
|
||||
- Format: `/test-reports/PROJ-1-simple-todo-kanban.md`
|
||||
4. **Test-Ergebnisse dokumentieren:**
|
||||
- Update Feature Spec in `/features/PROJ-X.md` mit Test-Ergebnissen
|
||||
- Füge QA-Section ans Ende des Feature-Dokuments hinzu
|
||||
|
||||
5. **User Review:**
|
||||
- Zeige Test-Report
|
||||
- Zeige Test-Ergebnisse
|
||||
- Frage: "Welche Bugs sollen zuerst gefixt werden?"
|
||||
|
||||
## Output-Format
|
||||
|
||||
### Test Report Location
|
||||
**Speichere Test-Reports in:** `/test-reports/PROJ-X-feature-name.md`
|
||||
### Test Results Location
|
||||
**Dokumentiere Test-Ergebnisse in:** `/features/PROJ-X.md` (am Ende des Feature-Dokuments)
|
||||
|
||||
**Beispiele:**
|
||||
- `/test-reports/PROJ-1-simple-todo-kanban.md`
|
||||
- `/test-reports/PROJ-2-user-authentication.md`
|
||||
**Kein separater test-reports/ Ordner mehr!** Alles bleibt im Feature-Dokument für bessere Übersicht.
|
||||
|
||||
### Test Report Template
|
||||
```markdown
|
||||
# Test Report: PROJ-X Feature-Name
|
||||
Füge diese Section ans Ende von `/features/PROJ-X.md`:
|
||||
|
||||
## Tested: 2024-01-10
|
||||
## Tester: QA Engineer Agent
|
||||
## App URL: http://localhost:3000
|
||||
```markdown
|
||||
---
|
||||
|
||||
## QA Test Results
|
||||
|
||||
**Tested:** 2026-01-12
|
||||
**App URL:** http://localhost:3000
|
||||
|
||||
## Acceptance Criteria Status
|
||||
|
||||
@@ -157,7 +164,7 @@ Fix BUG-1 und BUG-2 vor Deployment.
|
||||
|
||||
Bevor du den Test-Report als "fertig" markierst, stelle sicher:
|
||||
|
||||
- [ ] **FEATURE_CHANGELOG.md gelesen:** Bestehende Features für Regression Tests geprüft
|
||||
- [ ] **Bestehende Features geprüft:** Via Git für Regression Tests geprüft
|
||||
- [ ] **Feature Spec gelesen:** `/features/PROJ-X.md` vollständig verstanden
|
||||
- [ ] **Alle Acceptance Criteria getestet:** Jedes AC hat Status (✅ oder ❌)
|
||||
- [ ] **Alle Edge Cases getestet:** Jeder Edge Case wurde durchgespielt
|
||||
@@ -166,7 +173,7 @@ Bevor du den Test-Report als "fertig" markierst, stelle sicher:
|
||||
- [ ] **Bugs dokumentiert:** Jeder Bug hat Severity, Steps to Reproduce, Priority
|
||||
- [ ] **Screenshots/Videos:** Bei visuellen Bugs Screenshots hinzugefügt
|
||||
- [ ] **Test-Report geschrieben:** Vollständiger Report mit Summary
|
||||
- [ ] **Test-Report gespeichert:** Report ist in `/test-reports/PROJ-X-feature-name.md`
|
||||
- [ ] **Test-Ergebnisse dokumentiert:** QA-Section zu `/features/PROJ-X.md` hinzugefügt
|
||||
- [ ] **Regression Test:** Alte Features funktionieren noch (nichts kaputt gemacht)
|
||||
- [ ] **Performance Check:** App reagiert flüssig (keine langen Ladezeiten)
|
||||
- [ ] **Security Check (Basic):** Keine offensichtlichen Security-Issues
|
||||
|
||||
Reference in New Issue
Block a user