@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.
- package/agent-files/claude/skills/erster-entwurf/SKILL.md +54 -0
- package/agent-files/claude/skills/veroeffentlichen/SKILL.md +7 -1
- package/agent-files/manifest.json +10 -2
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/docs/ablauf.md +28 -4
- package/docs/agents-block.md +13 -12
- package/docs/komponenten.md +1 -1
- package/docs/llms.txt +4 -4
- package/package.json +1 -1
|
@@ -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": "
|
|
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.
|
|
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.
|
|
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
|
|
68
|
+
## 4. Bauen und lokal zeigen
|
|
53
69
|
|
|
54
70
|
```bash
|
|
55
71
|
npm run dev
|
|
56
72
|
```
|
|
57
73
|
|
|
58
|
-
startet die Seite
|
|
59
|
-
|
|
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
|
package/docs/agents-block.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
## DealSystem-Website: Anleitung für KI-Agenten
|
|
2
2
|
|
|
3
|
-
Statische SvelteKit-Seite mit `@dealsystem/site` 0.2.
|
|
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`.
|
|
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. **
|
|
23
|
-
2. **
|
|
24
|
-
3. **
|
|
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 "
|
|
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` –
|
|
64
|
-
- `extern-einbinden` – Video, Karte,
|
|
65
|
-
- `angebote-einbauen` – Angebote
|
|
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
|
|
94
|
-
- `konfiguration.md` – Formulare
|
|
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,
|
|
99
|
+
- `seo.md` – Titel, Vorschaubild, Favicon, noindex
|
|
99
100
|
- `regeln.md` – Prüfregeln mit Korrektur
|
|
100
101
|
- `befehle.md` – Befehle mit Optionen
|
package/docs/komponenten.md
CHANGED
|
@@ -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.
|
|
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.
|
|
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
|
|
13
|
-
- [konfiguration.md](konfiguration.md): Formulare
|
|
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,
|
|
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
|