Aktivierungsvertrag
Verwenden zum Entwerfen, Überprüfen oder Verfeinern einer Terminal-Oberfläche (Panels, Rails, Statusleisten, Karten, Eingabeaufforderungen), insbesondere Gentle Shell. Das Zielgefühl ist eine IDE in einem Terminal: dicht, ruhig, entwicklerzentriert, niemals eine Verkleidung von Retro-TUI-Chrome. Nicht für Webseiten (verwende gentle-design).
Harte Regeln
- Beurteile eine Terminal-UI niemals aus Code oder dem Gedächtnis: Erfasse sie (
references/visual-loop.md) und betrachte das PNG vor und nach jeder Änderung. - Lies
references/terminal-craft.mdvor jeder UI-Bearbeitung; es ist das Fundament, kein Vorschlag. - Betriebsmodus: Vertrautheit schlägt Ausdruck. Verwende IDE-Vokabular (Bereiche, Baum, Tabs, Statusleiste, Befehlspalette); die Marke lebt in Palette, Dichte und einer charakteristischen Bewegung.
- Jede Zeile kostet. Hierarchie entsteht aus Farbrolle, Gewichtung und Ausrichtung, niemals aus leeren Zeilen oder verschachtelten Boxen.
- Sage jede Tatsache einmal pro Bildschirm. Daten, die im Header gezeigt werden, wiederholen sich nie in einem Panel.
- Ein Befehl, ein Ziel. Verfeinerung bewahrt das System; Neugestaltung ersetzt es. Poliere niemals einen Look, der weggeworfen wird.
- Das Rendern bleibt günstig: Kein I/O oder Neuberechnung in Rendering-Pfaden, Cache-Schlüssel über alles, was die Ausgabe ändert (Stil, Breite, Theme).
- Mockups (via
gentle-design) müssen terminal-ausdrückbar sein: Monospace-Zellenraster inch-Einheiten, nur Vorder-/Hintergrundfarben, fett/gedimmt/kursiv/unterstrichen/durchgestrichen, Box-Drawing und Glyphen.
Entscheidungsgatter
| Frage | Befehl | Laden |
|---|---|---|
| Noch kein Produkt-/Design-Kontext | document | references/design-doc.md |
| Neue Oberfläche oder Neugestaltung | shape, dann Mockups, dann implementieren | references/commands.md |
| "Wie sieht es aus / was ist falsch" | critique | references/critique.md |
| Zu überladen, verschwendeter Platz, redundant | distill / layout / quieter | references/commands.md |
| Flach, keine Hierarchie, unlesbar | typeset / colorize / bolder | references/commands.md |
| Randfälle, schmale Terminals, langer Text | harden / adapt | references/commands.md |
| Letzter Durchgang vor dem Commit | polish | references/commands.md |
Ausführungsschritte
- Lade
DESIGN.md-Kontext, falls das Projekt einen hat; sonst schlage zuerstdocumentvor. - Erfasse den aktuellen Zustand mit der visuellen Schleife bei den ausgelieferten Größen (breit 180x50, Breakpoint 140, schmal 80x24).
- Führe den gewählten Befehl gegen ein benanntes Ziel aus; schreibe die Erkenntnisse, bevor du Code änderst.
- Ändere, erfasse erneut, vergleiche mit dem vorherigen PNG und der Aufgabenstellung; iteriere maximal 3 Runden, dann berichte.
- Beende jeden Verfeinerungsbefehl mit
polish-Prüfungen und den fokussierten Tests des Repositoriums (Renderanzahlen, Überlauf).
Ausgabevertrag
Rückgabe: Ziel, ausgeführter Befehl, Vorher-/Nachher-PNG-Pfade, gefundene und behobene Probleme mit P0-P3-Tags, offene Probleme und durchgeführte Prüfungen.
Referenzen
references/terminal-craft.md: Grundregeln und Terminal-Antimuster.references/commands.md: Befehlsspielbücher, angepasst an Terminals.references/critique.md: Bewertete Kritik und Schweregrad-Rubrik.references/design-doc.md: DESIGN.md-Form für ein Terminal-Produkt.references/visual-loop.md: Screenshot-Harness und Vergleichsschleife.NOTICE.md: Namensnennung.