KI-Projektvorlage — Hochschule Offenburg

Vorlage für KI-gestützte Teamprojekte im Studium
Grundlage: WeberHaus Hackathon, Mai 2026
Zielgruppe: Wirtschaftsinformatik, E-Business, Marketing, Web-Technologien

Diese Vorlage ist das Grundgerüst für ein KI-gestütztes Teamprojekt. Sie enthält alle Dateien, die ein KI-Agent (Claude Code, Cursor, GitHub Copilot, Anti Gravity, Codex) automatisch einliest, um euer Projekt zu verstehen und konsistent mitzuarbeiten.

Das Prinzip: Die Intelligenz steckt nicht im Einzelprompt — sie steckt in euren Markdown-Dateien.

🔒 Sicherheit zuerst: Bevor ihr loslegt, lest SECURITY.md — Umgang mit API-Keys/Passwörtern (verbindliche Vorgabe, Prüfungsbestandteil). Kurz: Secrets nur in .env (nie committen, .env.example als Muster), nie in KI-Tools einfügen, bei Leak sofort rotieren.

✅ Abgabe zuletzt: Vor Demo/LB3-Abgabe lauft ihr das Abnahme-Audit nach AUDIT.md (verbindliche Vorgabe, Prüfungsbestandteil) — prüft eure PWA auf Zuverlässigkeit, Wartbarkeit, Sicherheit und Performance. Kein „fertig" ohne bestandenes bzw. begründet bewertetes Audit.

Dieses Repository ist ein GitHub-Template. Klickt oben auf „Use this template" → „Create a new repository" und legt eure eigene Kopie an.

# Danach lokal klonen (URL aus eurem neuen Repo übernehmen):
git clone https://github.com/EUER-NAME/ki-projekt-template.git
cd ki-projekt-template

Zugang zu GitHub: HSO-Studierende melden sich über das GitHub Campus-Programm der Hochschule an. Alle anderen (HSLU, extern) legen ein kostenloses Konto auf github.com an. Der Workflow ist für alle identisch.

→ Anleitung je nach Werkzeug: docs/setup.md

1. requirements/REQUIREMENTS.md — Anforderungen eintragen (User Stories + Abnahmekriterien)
2. requirements/BACKLOG.md — Features auflisten, Prioritäten setzen
3. CLAUDE.md — Projektname und Teamregeln anpassen, dann committen
4. ARCHITECTURE.md — Technologieentscheidungen festhalten
5. Beispiel-Feature löschen — requirements/01-example-feature/ durch eigene Features ersetzen

Grundprinzip Bewertbarkeit: Euer Projekt kann nur bewertet werden, wenn der Kern (Code, Workflows, Datenschema, Doku) auf dem Kursserver liegt oder vollständig ins Git-Repo exportierbar ist. Bequeme SaaS-Baukästen/„App-Generatoren" möglichst vermeiden — sie lassen sich oft nicht sauber exportieren, dabei geht die Struktur verloren. Details: ARCHITECTURE.md → ADR-06.

ki-projekt-template/
├── README.md                              ← Diese Datei — Einstieg
├── LICENSE                                ← MIT-Lizenz
├── CLAUDE.md                              ← KI-Kontext: Verhaltensregeln für den Agenten
├── SECURITY.md                            ← Secret-Handhabung (verbindlich, Prüfungsbestandteil)
├── AUDIT.md                               ← PWA-Abnahme-Audit (verbindlich, Prüfungsbestandteil)
├── ARCHITECTURE.md                        ← Systemaufbau und Technologieentscheidungen
├── ROADMAP.md                             ← Phasenplan, Abhängigkeitsgraph, Git-Workflow
├── .gitignore                             ← Vom Versionskontrolle ausgeschlossene Dateien
├── .cursorrules                           ← Spiegelung von CLAUDE.md für Cursor
├── .github/
│   └── copilot-instructions.md           ← Spiegelung von CLAUDE.md für Copilot / Anti Gravity
├── requirements/
│   ├── REQUIREMENTS.md                    ← Vollständige Anforderungen (Lastenheft / SRS)
│   ├── BACKLOG.md                         ← Aktueller Stand aller Features
│   └── 01-example-feature/               ← Beispiel — durch echte Features ersetzen
│       ├── USERSTORY.md                   ← Fachliche Beschreibung (Nutzerperspektive)
│       ├── FEATURE.md                     ← Abnahmekriterien
│       └── IMPLEMENTATION.md             ← Schrittweiser Umsetzungsplan (TDD)
└── docs/
    ├── setup.md                           ← Werkzeug-Einrichtungsanleitung
    ├── quickstart.md                      ← Schnelleinstieg
    ├── diagramme.md                       ← Mermaid-Konventionen (UCD, Klassen-, Sequenzdiagramm …)
    ├── github-classroom.md                ← Anleitung für Lehrende (optional)
    └── lehrkonzept-ki-gestuetzte-entwicklung.md  ← Pädagogisches Quelldokument

GROSSBUCHSTABEN — Kritische Projektdateien, die der KI-Agent und alle Teammitglieder lesen und pflegen müssen: CLAUDE.md, SECURITY.md, AUDIT.md, ARCHITECTURE.md, ROADMAP.md, REQUIREMENTS.md, BACKLOG.md, USERSTORY.md, FEATURE.md, IMPLEMENTATION.md

Kleinbuchstaben — Unterstützende Dateien, Konfiguration, Dokumentation: README.md, .gitignore, .cursorrules, setup.md

CLAUDE.md, .cursorrules und .github/copilot-instructions.md sind Projektdateien — keine persönliche Editor-Konfiguration. Sie müssen committed und gepusht werden, damit alle Teammitglieder denselben KI-Kontext haben — unabhängig davon, welches Werkzeug sie verwenden.

→ Details zum Workflow: ROADMAP.md → Abschnitt „KI-Kontext synchronisieren"

Für größere Kurse lässt sich diese Vorlage über GitHub Classroom verteilen — aus einem Einladungslink entsteht automatisch pro Team ein eigenes Repository. Funktioniert auch für gemischte Kohorten (HSO über GitHub Campus, HSLU und externe Teilnehmende mit eigenem Konto).

→ Anleitung: docs/github-classroom.md

Diese Vorlage basiert auf dem WeberHaus Hackathon (Mai 2026) an der Hochschule Offenburg. Das vollständige Lehrkonzept liegt unter docs/lehrkonzept-ki-gestuetzte-entwicklung.md (sowie im Moodle-Kurs).

Fragen → Betreuungsteam über Moodle.

MIT © 2026 Gilbert Seilheimer / CONTIC