ellmos-ai Standardaufnahmeverfahren fuer neue Software-Projekte
Version: 1.0 Stand: 2026-03-12
Uebersicht
Dieses Verfahren definiert, welche Schritte bei neu entdeckten Software-Ordnern durchzufuehren sind, bevor sie in ein Task-Management-System aufgenommen werden.
┌─────────────────────────────────────────────────────────┐
│ STANDARDAUFNAHMEVERFAHREN │
├─────────────────────────────────────────────────────────┤
│ 1. Feature-Analyse erstellen │
│ 2. Code-Qualitaetspruefung (Standard-Tests) │
│ 3. AUFGABEN.txt erstellen │
│ 4. In Task-Management uebernehmen │
└─────────────────────────────────────────────────────────┘
Phase 1: Feature-Analyse
Zweck: Verstaendnis des Tools, seiner Funktionen und des Entwicklungsstandes.
Datei erstellen: Feature_Analyse_<ToolName>.md
Template
# Feature-Analyse: <ToolName>
## Kurzbeschreibung
Ein kurzer Satz der beschreibt was das Tool macht.
---
## Highlights
| Feature | Beschreibung |
|---------|-------------|
| **Feature 1** | Beschreibung |
| **Feature 2** | Beschreibung |
---
## Bewertung der Ausbaustufe
### Aktueller Stand: **<Status> (<X>%)**
Moegliche Status:
- Prototype (0-30%)
- Alpha (30-60%)
- Beta (60-85%)
- Production Ready (85-95%)
- Release (95-100%)
| Kategorie | Bewertung (1-5) | Details |
|-----------|:---------------:|---------|
| **Funktionsumfang** | 3 | |
| **UI/UX** | 3 | |
| **Stabilitaet** | 3 | |
| **Dokumentation** | 3 | |
---
## Empfohlene Erweiterungen
### Prioritaet: Hoch
1. ...
### Prioritaet: Mittel
2. ...
### Prioritaet: Niedrig
3. ...
---
## Technische Details
Framework: <Framework>
Dateigroesse: <X> Zeilen Python
Hauptdatei: <main.py>
---
*Analyse erstellt: <Datum>*
Phase 2: Code-Qualitaetspruefung
Zweck: Technische Qualitaet sicherstellen, bekannte Probleme identifizieren.
Empfohlene Pruefungen
| Test | Werkzeug | Beschreibung |
|---|---|---|
| Encoding | Encoding-Checker (z.B. chardet, file) |
UTF-8 sicherstellen |
| Methoden-Analyse | Linter (z.B. pylint, flake8) |
Grosse Methoden finden |
| Einrueckung | Formatter (z.B. black, autopep8) |
Konsistenz pruefen |
| Imports | Import-Checker (z.B. isort, pylint) |
Unused Imports finden |
Pruefpunkte
- Alle .py Dateien UTF-8 kodiert?
- Keine ungewoehnlich grosse Methoden (>100 Zeilen)?
- Konsistente Einrueckung (Spaces vs Tabs)?
- Unused Imports entfernt?
- Docstrings vorhanden?
Ergebnis dokumentieren
Probleme in AUFGABEN.txt unter "QUALITAETSPRUEFUNG" eintragen.
Phase 3: AUFGABEN.txt erstellen
Zweck: Offene Aufgaben strukturiert erfassen.
Datei erstellen: AUFGABEN.txt im Projektordner
Template
AUFGABEN - <ToolName> V<Version>
==============================
Status: <Status>
Stand: <Datum>
OFFENE AUFGABEN:
[ ] <Aufgabe 1> - Aufwand: <NIEDRIG|MITTEL|HOCH>
[ ] <Aufgabe 2> - Aufwand: <NIEDRIG|MITTEL|HOCH>
---
ERLEDIGT (Archiv):
- <Erledigte Aufgabe> (<Version>, <Datum>)
Status-Werte
| Status | Bedeutung |
|---|---|
| NEU ENTDECKT | Noch nicht analysiert |
| ANALYSE NOETIG | Feature-Analyse laeuft |
| QUALITAETSPRUEFUNG | Code-Tests laufen |
| VALIDIERT & BEREIT | Bereit fuer Features |
| MVP | Minimum Viable Product |
| NUR KOMPILIEREN | Nur noch Kompilierung noetig |
| GESPERRT | Wartet auf User-Test/Entscheidung |
Phase 4: Task-Management-Integration
Nach Abschluss der Phasen 1-3:
- Aufgaben uebertragen: AUFGABEN.txt-Eintraege als Tasks/Issues anlegen
- Pruefen: Alle Aufgaben korrekt kategorisiert?
- Kategorisierung: Projekt in passende Kategorie einordnen (Single-Tool, Suite, Library etc.)
Automatische Onboarding-Tasks
Bei neuen Projekten folgende Standard-Tasks anlegen:
| Task | Aufgabe | Aufwand |
|---|---|---|
| onb_1 | Feature-Analyse erstellen | mittel |
| onb_2 | Code-Qualitaetspruefung | niedrig |
| onb_3 | AUFGABEN.txt erstellen | niedrig |
Tasks haben Abhaengigkeiten: onb_2 haengt von onb_1 ab, onb_3 haengt von onb_2 ab.
Schnell-Checkliste
[ ] 1. Feature_Analyse_<Name>.md erstellt
[ ] 2. Code-Qualitaetspruefung durchgefuehrt (Linter, Encoding, Imports)
[ ] 3. AUFGABEN.txt erstellt mit Status
[ ] 4. Tasks in Task-Management uebernommen
Beispiel: Neues Tool "MyTool"
# 1. Feature-Analyse
# -> Feature_Analyse_MyTool.md erstellen (siehe Template)
# 2. Code-Qualitaet
pylint MyTool/main.py
flake8 MyTool/main.py
file -i MyTool/main.py # Encoding pruefen
# 3. AUFGABEN.txt
# -> Im Tool-Ordner erstellen mit Status "QUALITAETSPRUEFUNG"
# 4. Tasks anlegen
# -> Eintraege aus AUFGABEN.txt als Issues/Tickets erfassen
Erstellt: 2026-01-10 | Portiert: 2026-03-12