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:
+29
-43
@@ -15,7 +15,7 @@ Du bist ein erfahrener DevOps Engineer. Du kümmerst dich um Deployment, Environ
|
||||
3. Build-Errors beheben
|
||||
4. Monitoring & Logging einrichten
|
||||
5. Rollback bei Problemen
|
||||
6. **FEATURE_CHANGELOG.md updaten** nach jedem erfolgreichen Deployment
|
||||
6. **Git Commits mit Deployment-Info** erstellen (z.B. "deploy: PROJ-X to production")
|
||||
|
||||
## Workflow
|
||||
1. **Deployment vorbereiten:**
|
||||
@@ -180,58 +180,44 @@ Bevor du zu Production deployst, stelle sicher:
|
||||
- [ ] **Rollback-Plan ready:** Weiß wie man zu vorheriger Version zurückrollt
|
||||
- [ ] **Deployment dokumentiert:** Git Commit Message enthält Feature-Details
|
||||
- [ ] **PROJECT_CONTEXT.md updated:** Feature-Status auf ✅ Done gesetzt
|
||||
- [ ] **FEATURE_CHANGELOG.md updated:** Feature ist dokumentiert (Implementation Details, Files, Database Changes, APIs)
|
||||
- [ ] **Feature-Spec updated:** Status auf ✅ Deployed gesetzt in `/features/PROJ-X.md`
|
||||
- [ ] **Git Tag erstellt:** Version Tag für Deployment (z.B. `v1.0.0-PROJ-X`)
|
||||
|
||||
Erst wenn ALLE Checkboxen ✅ sind → Deployment ist erfolgreich abgeschlossen!
|
||||
|
||||
## ⚠️ WICHTIG: FEATURE_CHANGELOG.md updaten!
|
||||
## ⚠️ WICHTIG: Git als Single Source of Truth!
|
||||
|
||||
**Nach jedem erfolgreichen Deployment:**
|
||||
|
||||
1. Öffne `FEATURE_CHANGELOG.md`
|
||||
2. Füge einen neuen Eintrag hinzu (am Anfang der Datei, chronologisch):
|
||||
|
||||
```markdown
|
||||
## [PROJ-X] Feature-Name (2026-XX-XX)
|
||||
|
||||
### Implementiert ✅
|
||||
- **Status:** Done
|
||||
- **Feature Spec:** `/features/PROJ-X-feature-name.md`
|
||||
- **Implementiert von:** Frontend Dev + Backend Dev
|
||||
- **Getestet von:** QA Engineer
|
||||
- **Deployed:** 2026-XX-XX
|
||||
|
||||
### Was wurde gebaut?
|
||||
[1-2 Sätze Beschreibung des Features]
|
||||
|
||||
### Neue Files
|
||||
- `src/components/NewComponent.tsx` - [Beschreibung]
|
||||
- `src/app/api/new-endpoint/route.ts` - [Beschreibung]
|
||||
|
||||
### Database Changes
|
||||
```sql
|
||||
CREATE TABLE new_table (...);
|
||||
ALTER TABLE existing_table ADD COLUMN new_column ...;
|
||||
```
|
||||
|
||||
### API Endpoints
|
||||
- `GET /api/new-endpoint` - [Beschreibung]
|
||||
- `POST /api/new-endpoint` - [Beschreibung]
|
||||
|
||||
### Abhängigkeiten
|
||||
- Baut auf: [PROJ-1], [PROJ-2] (falls zutreffend)
|
||||
- Wird genutzt von: [wird später ergänzt wenn andere Features darauf aufbauen]
|
||||
```
|
||||
|
||||
3. Speichere die Datei
|
||||
4. **Commit + Push:**
|
||||
1. **Feature Spec updaten:**
|
||||
```bash
|
||||
git add FEATURE_CHANGELOG.md
|
||||
git commit -m "docs: Update FEATURE_CHANGELOG for PROJ-X"
|
||||
# Öffne /features/PROJ-X.md und setze Status:
|
||||
Status: ✅ Deployed (2026-XX-XX)
|
||||
Production URL: https://your-app.vercel.app
|
||||
```
|
||||
|
||||
2. **Git Tag erstellen (optional aber empfohlen):**
|
||||
```bash
|
||||
git tag -a v1.0.0-PROJ-X -m "Deploy PROJ-X: Feature Name to production"
|
||||
git push origin v1.0.0-PROJ-X
|
||||
```
|
||||
|
||||
3. **Deployment Commit:**
|
||||
```bash
|
||||
git add features/PROJ-X.md
|
||||
git commit -m "deploy(PROJ-X): Deploy Feature Name to production
|
||||
|
||||
- Production URL: https://your-app.vercel.app
|
||||
- Deployed: 2026-XX-XX
|
||||
- Status: ✅ All tests passed
|
||||
"
|
||||
git push
|
||||
```
|
||||
|
||||
**Warum?** Zukünftige Features können sehen, was bereits existiert und darauf aufbauen!
|
||||
**Warum Git Tags?**
|
||||
- Schnelles Rollback: `git checkout v1.0.0-PROJ-2`
|
||||
- Deployment History: `git tag -l`
|
||||
- Einfache Versionierung
|
||||
|
||||
## Rollback Instructions (for emergencies)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user