From 01265c0be3c22d1e9ac69c1ea91243322fc77b89 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 8 Jul 2026 08:46:39 +0000
Subject: [PATCH 1/3] Add Features folder with requirements template and
 Agents.md reference

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D613xzzyazqaG34uMm4AZu
---
 Agents.md                   | 11 ++++++++
 Features/README.md          | 14 +++++++++++
 Features/feature-vorlage.md | 50 +++++++++++++++++++++++++++++++++++++
 3 files changed, 75 insertions(+)
 create mode 100644 Agents.md
 create mode 100644 Features/README.md
 create mode 100644 Features/feature-vorlage.md

diff --git a/Agents.md b/Agents.md
new file mode 100644
index 0000000..64559be
--- /dev/null
+++ b/Agents.md
@@ -0,0 +1,11 @@
+# Agents.md
+
+Zentrale Übersichts- und Steuerungsdatei für die Arbeit an diesem Projekt.
+
+## Features
+
+Anforderungen für neue Features werden im Ordner [`Features/`](./Features/) dokumentiert.
+
+- Jedes Feature erhält eine eigene MD-Datei.
+- Als Ausgangspunkt dient die Vorlage [`Features/feature-vorlage.md`](./Features/feature-vorlage.md).
+- Details zum Vorgehen siehe [`Features/README.md`](./Features/README.md).
diff --git a/Features/README.md b/Features/README.md
new file mode 100644
index 0000000..db53860
--- /dev/null
+++ b/Features/README.md
@@ -0,0 +1,14 @@
+# Features
+
+In diesem Ordner werden die Anforderungen für neue Features dokumentiert.
+
+## Vorgehen
+
+1. Kopiere die Vorlage [`feature-vorlage.md`](./feature-vorlage.md).
+2. Benenne die Kopie sprechend (z. B. `login-mit-sso.md`).
+3. Fülle die Abschnitte der Vorlage aus.
+4. Pro Feature eine eigene MD-Datei anlegen.
+
+## Enthaltene Dateien
+
+- [`feature-vorlage.md`](./feature-vorlage.md) – Vorlage für neue Feature-Anforderungen.
diff --git a/Features/feature-vorlage.md b/Features/feature-vorlage.md
new file mode 100644
index 0000000..63612ac
--- /dev/null
+++ b/Features/feature-vorlage.md
@@ -0,0 +1,50 @@
+# Feature: <Feature-Name>
+
+> Vorlage zur Dokumentation von Feature-Anforderungen.
+> Kopiere diese Datei und benenne sie sinnvoll (z. B. `login-mit-sso.md`),
+> bevor du sie ausfüllst.
+
+## Übersicht
+
+- **Status:** Entwurf | In Umsetzung | Abgeschlossen
+- **Autor:** <Name>
+- **Erstellt am:** <JJJJ-MM-TT>
+- **Letzte Änderung:** <JJJJ-MM-TT>
+
+## Ziel / Problemstellung
+
+<Welches Problem löst das Feature? Welchen Nutzen bringt es?>
+
+## Anforderungen
+
+### Funktionale Anforderungen
+
+- [ ] <Was soll das Feature konkret können?>
+- [ ] <...>
+
+### Nicht-funktionale Anforderungen
+
+- [ ] <Performance, Sicherheit, Barrierefreiheit, Kompatibilität ...>
+- [ ] <...>
+
+## Nutzer / Zielgruppe
+
+<Wer verwendet das Feature? Welche Rollen sind betroffen?>
+
+## Ein- und Ausgaben
+
+- **Eingaben:** <...>
+- **Ausgaben:** <...>
+
+## Akzeptanzkriterien
+
+- [ ] <Bedingung, die erfüllt sein muss, damit das Feature als fertig gilt>
+- [ ] <...>
+
+## Offene Fragen / Annahmen
+
+- <...>
+
+## Referenzen
+
+- <Links zu Tickets, Designs, verwandten Dokumenten>

From 3becf33690d3fcc6e19021bda24f02556c5a2e90 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Thu, 9 Jul 2026 04:23:53 +0000
Subject: [PATCH 2/3] Consolidate Features reference into central AGENTS.md

Merge main brought in the canonical AGENTS.md; move the Features folder
reference there and remove the duplicate lowercase Agents.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D613xzzyazqaG34uMm4AZu
---
 AGENTS.md |  7 +++++++
 Agents.md | 11 -----------
 2 files changed, 7 insertions(+), 11 deletions(-)
 delete mode 100644 Agents.md

diff --git a/AGENTS.md b/AGENTS.md
index a0243a5..43fecab 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -21,6 +21,13 @@ The layout is **topological, not geographic**: node coordinates are schematic
 - **Language:** Java 21 (LTS) · **UI:** JavaFX 21 (FXML + Canvas + CSS)
 - **Build:** Maven · **Tests:** JUnit 5 · **Modules:** JPMS
 
+## Feature requirements
+
+Requirements for new features are documented in the [`Features/`](./Features/)
+folder — one Markdown file per feature. Start from the template
+[`Features/feature-vorlage.md`](./Features/feature-vorlage.md); see
+[`Features/README.md`](./Features/README.md) for the workflow.
+
 ## Architecture (keep these layers separate)
 
 ```
diff --git a/Agents.md b/Agents.md
deleted file mode 100644
index 64559be..0000000
--- a/Agents.md
+++ /dev/null
@@ -1,11 +0,0 @@
-# Agents.md
-
-Zentrale Übersichts- und Steuerungsdatei für die Arbeit an diesem Projekt.
-
-## Features
-
-Anforderungen für neue Features werden im Ordner [`Features/`](./Features/) dokumentiert.
-
-- Jedes Feature erhält eine eigene MD-Datei.
-- Als Ausgangspunkt dient die Vorlage [`Features/feature-vorlage.md`](./Features/feature-vorlage.md).
-- Details zum Vorgehen siehe [`Features/README.md`](./Features/README.md).

From 6868afe0b368b329636e1054893ff97c123a9299 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Thu, 9 Jul 2026 04:35:58 +0000
Subject: [PATCH 3/3] Use imperative mood for step 4 in Features/README.md

Addresses review feedback: keep all workflow steps in the imperative form.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D613xzzyazqaG34uMm4AZu
---
 Features/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Features/README.md b/Features/README.md
index db53860..a7ccb97 100644
--- a/Features/README.md
+++ b/Features/README.md
@@ -7,7 +7,7 @@ In diesem Ordner werden die Anforderungen für neue Features dokumentiert.
 1. Kopiere die Vorlage [`feature-vorlage.md`](./feature-vorlage.md).
 2. Benenne die Kopie sprechend (z. B. `login-mit-sso.md`).
 3. Fülle die Abschnitte der Vorlage aus.
-4. Pro Feature eine eigene MD-Datei anlegen.
+4. Lege pro Feature eine eigene MD-Datei an.
 
 ## Enthaltene Dateien