Leopoldadmin/leocrm
1
0
Fork 0
Code Issues 363 Pull Requests Actions 1 Packages Projects Releases 1 Wiki Activity

docs(progress): PROGRESS.md + AGENTS.md Section 9 — Progress-Tracking & Forgejo-Issue-Verwaltung

Browse Source
This commit is contained in:
Agent Zero
2026-08-13 11:43:26 +02:00
parent 30454e1a5f
commit 42e97ebce0
2 changed files with 230 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+48 -1
View File
@@ -143,7 +143,8 @@ Full architecture: `architecture.md` | Full task graph: `task_graph.json`
| Datei | Zweck |
|-------|------|
| `README.md` | Projekt-Overview, Setup |
| `PLATFORM_ROADMAP.md` | Roadmap, Meilensteine |
| `PLATFORM_ROADMAP.md` | EINZIGE Planungs-Datei für zukünftige Entwicklung, Umbauten, Roadmap. Alle Phasen, Tasks und Architekturentscheidungen |
| `PROGRESS.md` | Fortschritts-Tracking — pro Task: Status, Forgejo Issue, Verifiziert. Wird vom Agent bei jedem Status-Wechsel aktualisiert |
| `AGENTS.md` | Agent-Definitionen (diese Datei) |
| `docs/test-strategy.md` | Test-Strategie, Konventionen, Einschränkungen |
| `docs/security_kernel.md` | Security-Konzept (ABAC, RLS, Session) |
@@ -185,3 +186,49 @@ Full architecture: `architecture.md` | Full task graph: `task_graph.json`
4. Dedup-Tests: Unterschiedlichen Dateiinhalt pro Upload verwenden
5. Keine zufälligen UUIDs: Echte Entity-IDs aus der DB verwenden
6. Test-Dateien: `tests/test_<modul>.py` | Fixtures: `tests/conftest.py`
---
## 9. Progress-Tracking & Forgejo-Issue-Verwaltung
### Planungs- und Fortschrittsdateien
| Datei | Zweck | Wann aktualisieren |
|-------|------|-------------------|
| `PLATFORM_ROADMAP.md` | EINZIGE Planungs-Datei. Alle Phasen, Tasks, Architekturentscheidungen | Bei Planungsänderungen |
| `PROGRESS.md` | Fortschritts-Tracking. Pro Task: Status, Forgejo Issue, Verifiziert | Bei jedem Task-Status-Wechsel |
### Task-Status-Verwaltung
Jeder Task in der Roadmap hat einen Status der in `PROGRESS.md` verfolgt wird:
- `not_started` — Task noch nicht begonnen
- `in_progress` — Task wird bearbeitet
- `blocked` — Task blockiert (Abhängigkeit fehlt, Entscheidung ausstehend)
- `review` — Task implementiert, wartet auf Review/Tests
- `done` — Task hat Definition of Done (DoD) erfüllt
**Der Agent MUSS `PROGRESS.md` bei jedem Status-Wechsel aktualisieren.** Kein Task-Wechsel ohne PROGRESS.md-Update.
### Forgejo Issues & Milestones
- **Pro Phase (A-J):** Ein Forgejo Milestone (z.B. "Phase A — Stabilität", "Phase B — System-Konsolidierung")
- **Pro Task:** Ein Forgejo Issue mit Label `task` + Milestone der jeweiligen Phase
- **Pro Bug:** Ein Forgejo Issue mit Label `bug` + Priorität (`critical`, `high`, `medium`, `low`)
- **Pro Feature-Request:** Ein Forgejo Issue mit Label `enhancement`
**Der Agent MUSS für jeden Task ein Forgejo Issue erstellen** und die Issue-Nummer in `PROGRESS.md` eintragen.
### Commit-Messages
- Commit-Messages enthalten die Task-ID: `feat(B-LLM): zentraler LLM Client implementiert`
- Bug-Fixes referenzieren das Issue: `fix(#123): Redis-Connection-Leak behoben`
- `fixes #123` oder `closes #123` im Commit schließt das Issue automatisch
### Definition of Done (DoD)
Ein Task gilt erst als **DONE** wenn alle 8 DoD-Kriterien erfüllt sind (siehe `PLATFORM_ROADMAP.md`). Ein Task ohne Test ist NICHT done. Der Agent darf keinen Task als `done` markieren ohne DoD erfüllt zu haben.
### Phase-Gate-Review
Eine Phase gilt erst als **ABGESCHLOSSEN** wenn alle 7 Phase-Gate-Kriterien erfüllt sind (siehe `PLATFORM_ROADMAP.md`). Der Agent darf nicht zur nächsten Phase übergehen ohne Phase-Gate-Review bestanden zu haben.