Ideenverfeinerung

Fähigkeit zur Ideenverfeinerung

Zweck

Feature-Ideen durch strukturierte Befragung klären und verfeinern. Dieser Prozess hilft, Unklarheiten, Randfälle und Designaspekte aufzudecken, bevor das formelle Konzeptdokument geschrieben wird.

Wann verwenden

• Der Benutzer hat eine grobe Feature-Idee, die noch nicht ausgereift ist
• Vor dem Schreiben eines Konzeptdokuments
• Wenn eine Feature-Idee mehr Klarheit benötigt
• Zur Erkundung des Designraums und von Abwägungen

Voraussetzungen

• Der Benutzer hat eine grobe Feature-Idee beschrieben
• Feature-Nummer und -Name wurden festgelegt (oder werden noch festgelegt)

Ablauf

1. Feature-Nummer und -Name festlegen

Falls noch nicht geschehen:

ls -1d ./docs/features/[0-9][0-9][0-9][0-9]-* 2>/dev/null | tail -1

Gemeinsam mit dem Benutzer die nächste Nummer und einen beschreibenden Namen wählen.

2. Planungsverzeichnis erstellen

mkdir -p ./planning/NNNN-Feature-Name

3. Ideenverfeinerungsdokument initialisieren

cat > ./planning/NNNN-Feature-Name/idea-honing.md << 'EOF'
# Ideenverfeinerung: Feature-Name

## Erste Idee

[Grober Beschreibung des Features durch den Benutzer]

## Fragen & Antworten

EOF

4. Erste Fragen generieren

Basierend auf der groben Idee des Benutzers Unklarheiten identifizieren und Fragen generieren zu:

• Anwendungsfällen und Benutzer-Workflows
• Umfang und Abgrenzung
• Integrationspunkten
• Randfällen
• Abwägungen und Einschränkungen
• Erfolgskriterien

Eine Liste der zu erkundenden Fragen erstellen.

5. Fragen EINE NACH DER ANDEREN stellen

KRITISCH: Nur EINE Frage auf einmal stellen.

Bei jeder Frage:

1. Die Frage klar formulieren
2. Auf die Antwort des Benutzers warten
3. Die Antwort bei Bedarf diskutieren und verfeinern
4. Sobald zufrieden, das Q&A in das Dokument schreiben
5. Wenn neue Unklarheiten auftauchen, diese zur Fragenliste hinzufügen
6. Zur nächsten Frage übergehen

6. Dokument nach jedem Q&A aktualisieren

Nach jeder beantworteten Frage an das Dokument anhängen:

cat >> ./planning/NNNN-Feature-Name/idea-honing.md << 'EOF'

### F: [Fragetext]

**A**: [Antworttext]

EOF

7. Prozess weiterentwickeln

Während der Bearbeitung der Fragen:

• Neue Unklarheiten können auftauchen – sie als neue Fragen hinzufügen
• Manche Fragen können irrelevant werden – sie überspringen
• Der Prozess baut organisch auf sich selbst auf

Wenn eine Frage das bestehende Codeverhalten betrifft (z. B. „Wie funktioniert X heute?“):

• Sie als Recherchebedarf vermerken
• Mit anderen Fragen fortfahren
• Diese werden in einer späteren Recherche behandelt

8. Abschließen, wenn Klarheit herrscht

Wenn die Feature-Idee ausreichend klar ist:

• Wichtige Erkenntnisse zusammenfassen
• Mit dem Benutzer bestätigen, dass dieser bereit ist, das Konzept zu schreiben
• Das Ideenverfeinerungsdokument bleibt zur Referenz in planning/

Validierung

Das Ideenverfeinerungsdokument prüfen:

# Prüfen, ob das Dokument existiert
ls ./planning/NNNN-Feature-Name/idea-honing.md

# Inhalt anzeigen
cat ./planning/NNNN-Feature-Name/idea-honing.md

Häufige Probleme

Mehrere Fragen auf einmal stellen: Nur EINE Frage auf einmal stellen. Dies erhält den Fokus und ermöglicht eine tiefere Erkundung.

Antworten nicht aufzeichnen: Das Dokument nach JEDER beantworteten Frage aktualisieren, nicht gebündelt.

Zu früh aufhören: Fortfahren, bis der Benutzer sich bezüglich Umfang und Ansatz des Features sicher fühlt.

Nächste Schritte

Nach der Ideenverfeinerung:

1. Die Fähigkeit propose-feature-concept verwenden, um das formelle Konzept zu schreiben
2. Das Ideenverfeinerungsdokument beim Schreiben des Konzepts referenzieren
3. Das Q&A liefert Material für die Erzählung des Konzepts