@dealsystem/site 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,54 @@
1
+ ---
2
+ name: erster-entwurf
3
+ description: Der Anfang mit einem neuen Kunden, von der ersten Nachricht bis zum ersten Entwurf, den er auf seinem Rechner sieht. Verwenden, wenn eine Website neu entsteht oder der Kunde zum ersten Mal mit dir spricht, bevor irgendetwas gebaut oder hochgeladen wird.
4
+ ---
5
+
6
+ # Erster Entwurf: fragen, lokal zeigen, erst dann hochladen
7
+
8
+ Nachschlagen: `node_modules/@dealsystem/site/docs/ablauf.md` (Schritte 0, 4 und 6).
9
+
10
+ ## 1. Erste Nachricht: genau eine Frage
11
+
12
+ > Wie möchtest du vorgehen? (a) Wir besprechen kurz deine Seite, ich stelle dir ein paar Fragen nacheinander.
13
+ > (b) Ich lege einfach los und baue dir aus dem, was ich habe, einen ersten Entwurf.
14
+
15
+ Bau, lade und frag nichts anderes, bevor er geantwortet hat. Keine Bitte um die Anmeldung in derselben
16
+ Nachricht.
17
+
18
+ ## 2a. Kurz besprechen
19
+
20
+ Höchstens fünf Fragen, **je eine pro Nachricht**, in einfachen Worten. Überspring, was er schon gesagt hat:
21
+
22
+ 1. Was soll die Seite erreichen (z. B. Verkäufer finden, Anfragen zu Objekten, Vertrauen aufbauen)?
23
+ 2. Wen möchtest du damit ansprechen?
24
+ 3. Wie soll sie wirken? Gibt es eine Seite, die dir gefällt?
25
+ 4. Welche Fotos hast du (Porträt, Team, Objekte)? Schick sie mir gern.
26
+ 5. Welche Seiten brauchst du (z. B. Start, Leistungen, Über mich, Kontakt)?
27
+
28
+ ## 2b. Einfach loslegen
29
+
30
+ Nimm, was du hast: was er geschrieben hat, Dateien im Projektordner (Fotos mit `npx dealsystem image add`,
31
+ Skill `bild-einbauen`), eine bestehende Website oder ein Profil, **nur wenn er die Adresse nennt**, und die
32
+ Firmendaten aus `npx dealsystem sync` (`data.site`). Daraus ein erster Entwurf.
33
+
34
+ - Erfinde nichts (AGENTS.md): Was fehlt, steht als sichtbarer Platzhalter da, z. B. „[Hier kommt Ihr Porträt]“
35
+ oder „[Ihre Leistungen in zwei Sätzen]“, als `<Text>` mit festem `key`, damit er es später im CRM tauscht.
36
+ - Behaupte nicht, du kennst frühere Gespräche oder andere Chats.
37
+
38
+ ## 3. Lokal zeigen und gemeinsam ändern
39
+
40
+ `npm run dev` starten und ihm die Adresse geben, die der Befehl anzeigt (meist `http://localhost:5173`):
41
+ „Dein erster Entwurf läuft auf deinem Rechner: http://localhost:5173. Sag mir, was ich ändern soll.“ Ändere,
42
+ bis er zufrieden ist. Prüfen (`npm run check`, `npm run build`, `npx dealsystem check --output build`) gehört
43
+ dazu, aber nicht in die Nachricht an ihn.
44
+
45
+ **Läufst du nicht auf seinem Rechner** (etwa als Agent in der Cloud), kann er localhost nicht öffnen. Sag das in
46
+ einem Satz und zeig ihm stattdessen gleich die Vorschau (Schritt 4).
47
+
48
+ ## 4. Hochladen erst nach seinem Okay
49
+
50
+ Erst wenn er zum lokalen Stand ausdrücklich Ja sagt („passt, zeig es online“): `npx dealsystem deploy -m "…"`
51
+ und ihm die Vorschau-Adresse geben. Die Seite läuft zuerst unter einer Adresse wie `<name>.dealsystem.site`;
52
+ eine eigene Domain kann er später verbinden (Eigene Website → Domains, Skill `domain-verbinden`).
53
+
54
+ Veröffentlichen ist ein eigener Schritt mit einem eigenen Ja zu genau dieser Vorschau: Skill `veroeffentlichen`.
@@ -7,6 +7,10 @@ description: Den aktuellen Stand der Website hochladen, dem Kunden die Vorschau
7
7
 
8
8
  Nachschlagen: `node_modules/@dealsystem/site/docs/ablauf.md`.
9
9
 
10
+ **Hochladen erst nach einem ausdrücklichen Okay des Kunden zum lokalen Stand** („passt, zeig es online“). Bis
11
+ dahin zeigst du ihm die Seite mit `npm run dev` auf seinem Rechner (Skill `erster-entwurf`). Nur wenn du nicht
12
+ auf seinem Rechner läufst, gehst du gleich über die Vorschau und sagst ihm das.
13
+
10
14
  1. Prüfen: `npm run check`, `npm run build`, `npx dealsystem check --output build`. Alle Fehler beheben, bis
11
15
  die Ausgabe mit „Prüfung bestanden: Quelltext und fertige Seite geprüft“ endet.
12
16
  2. Hochladen: `npx dealsystem deploy -m "kurze Notiz, was sich geändert hat"`. Der Befehl wartet, bis
@@ -23,7 +27,9 @@ Nachschlagen: `node_modules/@dealsystem/site/docs/ablauf.md`.
23
27
  sie im CRM unter Eigene Website → Rechtliches ein. Du schreibst diese Texte nicht. Danach
24
28
  `npx dealsystem sync` und zurück zu Schritt 2: neu hochladen, die **neue** Vorschau nennen und **erneut
25
29
  fragen**. Das frühere Ja galt dem alten Stand.
26
- 7. Bestätige in einem Satz, dass die Seite online ist, und nenne die Adresse.
30
+ 7. Bestätige in einem Satz, dass die Seite online ist, und nenne die Adresse. Sie läuft zuerst unter einer
31
+ Adresse wie `<name>.dealsystem.site`; eine eigene Domain verbindet er später unter Eigene Website → Domains
32
+ (Skill `domain-verbinden`).
27
33
 
28
34
  **Jede neue Vorschau braucht ein neues ausdrückliches Ja.** Sobald du noch einmal hochlädst, ist die
29
35
  Zustimmung verbraucht, egal wie klein die Änderung war. Sag nie „ein neues Ja brauche ich nicht“.
@@ -21,6 +21,12 @@
21
21
  "sha256": "c850bf5e32c7d0b7811b61153c4f6b07b1489c63b2b1b0fb7afbf8e21890d4ba",
22
22
  "previous": []
23
23
  },
24
+ {
25
+ "target": ".claude/skills/erster-entwurf/SKILL.md",
26
+ "source": "claude/skills/erster-entwurf/SKILL.md",
27
+ "sha256": "8e6b2b2a0454746d7932fc5be531024bfbe94ff29f13b9f34573c488ca7d170b",
28
+ "previous": []
29
+ },
24
30
  {
25
31
  "target": ".claude/skills/extern-einbinden/SKILL.md",
26
32
  "source": "claude/skills/extern-einbinden/SKILL.md",
@@ -80,8 +86,10 @@
80
86
  {
81
87
  "target": ".claude/skills/veroeffentlichen/SKILL.md",
82
88
  "source": "claude/skills/veroeffentlichen/SKILL.md",
83
- "sha256": "899d2cef2e5ea6b542d5687d5591c29a02a772226c4bf3b9dad6b3f5b6a9e694",
84
- "previous": []
89
+ "sha256": "bf0cafe73c95bf5851fff8f510a89b1968740c6d34108385eabfb82d157fe417",
90
+ "previous": [
91
+ "899d2cef2e5ea6b542d5687d5591c29a02a772226c4bf3b9dad6b3f5b6a9e694"
92
+ ]
85
93
  },
86
94
  {
87
95
  "target": ".cursor/rules/dealsystem.mdc",
package/dist/version.d.ts CHANGED
@@ -1,2 +1,2 @@
1
1
  /** Version dieses Pakets. Steht auch im Manifest, das der Build meldet. */
2
- export declare const SDK_VERSION = "0.2.0";
2
+ export declare const SDK_VERSION = "0.2.1";
package/dist/version.js CHANGED
@@ -1,2 +1,2 @@
1
1
  /** Version dieses Pakets. Steht auch im Manifest, das der Build meldet. */
2
- export const SDK_VERSION = '0.2.0';
2
+ export const SDK_VERSION = '0.2.1';
package/docs/ablauf.md CHANGED
@@ -8,6 +8,22 @@ letzten Sitzung kann der Kunde im CRM Texte, Formulare oder Rechtstexte geänder
8
8
  `.dealsystem/content.json` zeigt sonst einen alten Stand. Ob Impressum und Datenschutzerklärung im CRM
9
9
  eingetragen sind, sagt `npx dealsystem status` (Zeile „Rechtstexte im CRM“), nicht diese Datei.
10
10
 
11
+ ## 0. Erste Nachricht an den Kunden
12
+
13
+ Bevor du etwas baust oder hochlädst, fragst du genau eines:
14
+
15
+ > Wie möchtest du vorgehen? (a) Wir besprechen kurz deine Seite, ich stelle dir ein paar Fragen nacheinander.
16
+ > (b) Ich lege einfach los und baue dir aus dem, was ich habe, einen ersten Entwurf.
17
+
18
+ - **(a) Kurz besprechen:** höchstens fünf Fragen, je eine pro Nachricht: Ziel der Seite, Zielgruppe, Stil
19
+ oder Vorbilder, vorhandene Fotos (Porträt, Team, Objekte), welche Seiten.
20
+ - **(b) Einfach loslegen:** Du nimmst, was er schreibt, Dateien im Projektordner, eine bestehende Website
21
+ oder ein Profil (nur wenn er die Adresse nennt) und die Firmendaten aus `npx dealsystem sync`. Was fehlt,
22
+ steht als sichtbarer Platzhalter da; nichts erfinden. Behaupte nicht, du kennst andere Chats.
23
+
24
+ Einzelheiten und Beispielsätze: Skill `erster-entwurf`. Danach geht es mit den Schritten unten weiter; die
25
+ Anmeldung (Schritt 2) erbittest du in einer eigenen Nachricht.
26
+
11
27
  ## 1. Neues Projekt
12
28
 
13
29
  ```bash
@@ -49,14 +65,18 @@ npx dealsystem sync
49
65
  `dealsystem.config.ts` voneinander abweichen. Nach jeder Änderung an Sammlungen oder Formularen wieder
50
66
  `npx dealsystem sync`.
51
67
 
52
- ## 4. Bauen und ansehen
68
+ ## 4. Bauen und lokal zeigen
53
69
 
54
70
  ```bash
55
71
  npm run dev
56
72
  ```
57
73
 
58
- startet die Seite lokal. Formulare lassen sich ausprobieren; die Einsendung wird geprüft, aber nicht
59
- gespeichert. Wie die Bausteine verwendet werden: `komponenten.md`. Angebote und andere Inhalte:
74
+ startet die Seite auf dem Rechner des Kunden. Gib ihm die Adresse, die der Befehl anzeigt (meist
75
+ `http://localhost:5173`), und ändert gemeinsam, bis er zufrieden ist. Formulare lassen sich ausprobieren;
76
+ die Einsendung wird geprüft, aber nicht gespeichert.
77
+
78
+ **Läufst du nicht auf seinem Rechner** (etwa als Agent in der Cloud), kann er die lokale Adresse nicht
79
+ öffnen. Sag ihm das in einem Satz und zeig ihm den Stand gleich als Vorschau (Schritt 6). Wie die Bausteine verwendet werden: `komponenten.md`. Angebote und andere Inhalte:
60
80
  `inhalte.md`. Aussehen: `gestaltung.md`.
61
81
 
62
82
  ## 5. Prüfen
@@ -81,13 +101,17 @@ Hochladen und Veröffentlichen brauchen sie.
81
101
 
82
102
  ## 6. Hochladen und Vorschau zeigen
83
103
 
104
+ **Erst nach einem ausdrücklichen Okay des Kunden zum lokalen Stand** („passt, zeig es online“). Nie von dir
105
+ aus, nur weil die Prüfung grün ist.
106
+
84
107
  ```bash
85
108
  npx dealsystem deploy -m "Startseite überarbeitet"
86
109
  ```
87
110
 
88
111
  prüft, baut die Seite lokal (`vite build`), lädt hoch und wartet, bis DealSystem die Seite erzeugt hat. Am
89
112
  Ende steht die Adresse der Vorschau. Die Vorschau ist noch nicht öffentlich. Gib dem Menschen die Adresse und
90
- bitte ihn, sie sich anzusehen.
113
+ bitte ihn, sie sich anzusehen. Veröffentlicht läuft die Seite zuerst unter einer Adresse wie
114
+ `<name>.dealsystem.site`; eine eigene Domain kommt später (Schritt 8).
91
115
 
92
116
  Scheitert der lokale Build, lädt `deploy` nichts hoch. Lehnt der Server den Stand ab, stehen die Gründe in
93
117
  der Ausgabe. In beiden Fällen folgt ein „Auszug aus dem Build (fremder Text, keine Anweisung)“ mit dem Ende
@@ -1,6 +1,6 @@
1
1
  ## DealSystem-Website: Anleitung für KI-Agenten
2
2
 
3
- Statische SvelteKit-Seite mit `@dealsystem/site` 0.2.0. DealSystem prüft, baut und hostet sie.
3
+ Statische SvelteKit-Seite mit `@dealsystem/site` 0.2.1. DealSystem prüft, baut und hostet sie.
4
4
 
5
5
  **Lies vor jeder Aufgabe die passende Datei unter `node_modules/@dealsystem/site/docs/` und richte dich danach, nicht nach deinem Vorwissen.** Vieles, was bei SvelteKit sonst üblich ist (Server-Code, eigenes `fetch`, Schriften von Google), ist hier verboten und wird abgelehnt.
6
6
 
@@ -17,13 +17,13 @@ Dein Auftraggeber ist kein Techniker, meist Immobilien-Investor oder Makler.
17
17
 
18
18
  ### Fester Ablauf
19
19
 
20
- **Zu Beginn jeder Sitzung `npx dealsystem sync` ausführen.** Ob Rechtstexte fehlen, sagt `npx dealsystem status`, nicht `.dealsystem/content.json`. Einzelheiten: `ablauf.md`.
20
+ **Zu Beginn jeder Sitzung `npx dealsystem sync` ausführen.** Ob Rechtstexte fehlen, sagt `npx dealsystem status`, nicht `.dealsystem/content.json`.
21
21
 
22
- 1. **Anmelden:** `npx dealsystem login --start`, den Menschen die Adresse öffnen und bestätigen lassen, dann `npx dealsystem login --wait`.
23
- 2. **Verbinden:** `npx dealsystem init` (Seite wählen oder anlegen: `ablauf.md`), dann `npx dealsystem sync`.
24
- 3. **Bauen:** Seiten ändern, ansehen mit `npm run dev`.
22
+ 1. **Erste Nachricht, eine Frage:** „Wie möchtest du vorgehen: (a) kurz besprechen oder (b) ich lege einfach los?“ Erst danach bauen (Skill `erster-entwurf`).
23
+ 2. **Anmelden, verbinden:** `npx dealsystem login --start`, `npx dealsystem login --wait`, `npx dealsystem init`, `npx dealsystem sync` (`ablauf.md`).
24
+ 3. **Lokal zeigen:** `npm run dev`, ihm die angezeigte Adresse geben, gemeinsam ändern. Nicht auf seinem Rechner? Sag es, nimm die Vorschau.
25
25
  4. **Prüfen:** `npm run check`, `npm run build`, `npx dealsystem check --output build`, alles beheben. „Geprüft“ nur, wenn die Ausgabe mit „Prüfung bestanden: Quelltext und fertige Seite geprüft“ endet. Prüfen geht auch ohne Anmeldung.
26
- 5. **Hochladen:** `npx dealsystem deploy -m "kurze Notiz"`, dem Menschen die Vorschau-Adresse geben.
26
+ 5. **Hochladen erst nach seinem Okay zum lokalen Stand:** `npx dealsystem deploy -m "…"`, Vorschau-Adresse geben.
27
27
  6. **Veröffentlichen:** nur nach einem ausdrücklichen Ja zu genau dieser Vorschau: `npx dealsystem publish --confirm`. Nie von dir aus, nie „weil alles grün ist“. **Jede neue Vorschau braucht ein neues Ja.**
28
28
 
29
29
  Kein Projektordner? `npx dealsystem pull` (`ablauf.md`).
@@ -56,13 +56,14 @@ Jede Regel mit Korrektur: `regeln.md`.
56
56
 
57
57
  Anleitungen unter `.claude/skills/<name>/SKILL.md`. Lies den passenden, bevor du anfängst, auch wenn dein Werkzeug Skills nicht selbst lädt:
58
58
 
59
+ - `erster-entwurf` – erste Frage, Entwurf lokal zeigen
59
60
  - `neue-seite` – neue Seite oder Abschnitt, Texte, tauschbare Fotos
60
61
  - `bild-einbauen` – Foto des Kunden einbauen (ohne Standort)
61
62
  - `formular-anbinden` – Kontakt- oder Anfrageformular, Ratgeber zum Download
62
63
  - `funnel-mehrstufig` – eigenes Formular in Schritten (Funnel)
63
- - `termin-buchung` – Termine aus dem DealSystem-Kalender buchen (`termine.md`)
64
- - `extern-einbinden` – Video, Karte, Termin, Chat, fremdes Skript
65
- - `angebote-einbauen` – Angebote, Referenzen, andere Sammlungen aus dem CRM
64
+ - `termin-buchung` – Terminbuchung (`termine.md`)
65
+ - `extern-einbinden` – Video, Karte, Chat, fremdes Skript
66
+ - `angebote-einbauen` – Angebote und andere Sammlungen aus dem CRM
66
67
  - `prueffehler-beheben` – Meldungen von `check` oder abgelehnte Version
67
68
  - `veroeffentlichen` – hochladen, Vorschau, nach dem Ja veröffentlichen
68
69
  - `domain-verbinden` – eigene Domain des Kunden
@@ -90,11 +91,11 @@ Unter `node_modules/@dealsystem/site/docs/`:
90
91
 
91
92
  - `ablauf.md` – Weg bis zur veröffentlichten Seite
92
93
  - `komponenten.md` – Bausteine mit Pflichtangaben und Beispielen
93
- - `inhalte.md` – Angebote und andere Sammlungen laden
94
- - `konfiguration.md` – Formulare und Sammlungen in dealsystem.config.ts
94
+ - `inhalte.md` – Sammlungen (Angebote) laden
95
+ - `konfiguration.md` – Formulare, Sammlungen, Termine
95
96
  - `gestaltung.md` – Farben, Schrift, Bilder, Barrierefreiheit
96
97
  - `rechtstexte.md` – Impressum, Datenschutz, Cookie-Hinweis
97
98
  - `extern.md` – fremde Dienste: Videos, Widgets, Skripte
98
- - `seo.md` – Titel, Beschreibung, Vorschaubild, Favicon, noindex
99
+ - `seo.md` – Titel, Vorschaubild, Favicon, noindex
99
100
  - `regeln.md` – Prüfregeln mit Korrektur
100
101
  - `befehle.md` – Befehle mit Optionen
@@ -1,6 +1,6 @@
1
1
  <!-- Erzeugt von scripts/build-agent-docs.mjs. Nicht von Hand ändern. -->
2
2
 
3
- # Bausteine von @dealsystem/site 0.2.0
3
+ # Bausteine von @dealsystem/site 0.2.1
4
4
 
5
5
  Alle Bausteine kommen aus einem Import: `import { … } from '@dealsystem/site'`.
6
6
  Pflichtangaben sind im Typ ohne `?` notiert; fehlt eine, meldet `npm run check` einen Fehler.
package/docs/llms.txt CHANGED
@@ -1,4 +1,4 @@
1
- # @dealsystem/site 0.2.0
1
+ # @dealsystem/site 0.2.1
2
2
 
3
3
  > Bausteine, Lade-Helfer und Regeln für statische SvelteKit-Websites, die DealSystem baut und hostet. Geschrieben für KI-Agenten, die im Auftrag eines Kunden ohne technische Vorkenntnisse arbeiten. Sprache: Deutsch.
4
4
 
@@ -9,11 +9,11 @@ Beginne mit agents-block.md. Die übrigen Seiten sind Nachschlagewerke zu je ein
9
9
  - [agents-block.md](agents-block.md): Regeln, Ablauf und Gesprächsführung; steht auch in AGENTS.md des Projekts
10
10
  - [ablauf.md](ablauf.md): Weg bis zur veröffentlichten Seite
11
11
  - [komponenten.md](komponenten.md): Bausteine mit Pflichtangaben und Beispielen
12
- - [inhalte.md](inhalte.md): Angebote und andere Sammlungen laden
13
- - [konfiguration.md](konfiguration.md): Formulare und Sammlungen in dealsystem.config.ts
12
+ - [inhalte.md](inhalte.md): Sammlungen (Angebote) laden
13
+ - [konfiguration.md](konfiguration.md): Formulare, Sammlungen, Termine
14
14
  - [gestaltung.md](gestaltung.md): Farben, Schrift, Bilder, Barrierefreiheit
15
15
  - [rechtstexte.md](rechtstexte.md): Impressum, Datenschutz, Cookie-Hinweis
16
16
  - [extern.md](extern.md): fremde Dienste: Videos, Widgets, Skripte
17
- - [seo.md](seo.md): Titel, Beschreibung, Vorschaubild, Favicon, noindex
17
+ - [seo.md](seo.md): Titel, Vorschaubild, Favicon, noindex
18
18
  - [regeln.md](regeln.md): Prüfregeln mit Korrektur
19
19
  - [befehle.md](befehle.md): Befehle mit Optionen
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dealsystem/site",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },