Helpcenter schreiben

Gilt nur für dieses Tool, nicht für Ziel-Repos. Dateien: content/help/<slug>.md. Die Oberfläche liest sie unter /help/<slug>. Inspector-ⓘ bleiben in lib/help/topics.ts — das hier ist die Langform.

Nicht nach .agents/skills/ in fremde Projekte kopieren (install: false).

Datei

Eine Datei, ein Thema. Slug: Kleinbuchstaben, Ziffern, Bindestriche, gleich dem Dateinamen ohne .md.

---
title: Lasttest
summary: Soll-Bestand und Token pro Zelle — einmal für alle Sequenzen.
order: 4
---

Der Lasttest sagt, wie viele Zeilen die Tabelle hat und wie dick eine Zelle in Token ist.

Siehe auch: [Echte Daten](/help/reallife) · [Tokenkosten](/help/token)

Pflicht im Frontmatter:

Feld	Regel
`title`	Wie in der Seitenleiste. Kurz, ohne Satzzeichen am Ende.
`summary`	Ein Satz, warum man den Artikel öffnet.
`order`	Zahl. Reihenfolge in der Liste. Lücken sind egal.

Kein # im Body — der Titel steht schon im Kopf der Seite.

start.md (order: 1) ist der Index. Jeder neue Artikel bekommt dort eine Zeile **[Titel](/help/slug)** — ein Halbsatz. und ein order.

Sprache

Deutsch, du, Präsens. Kurze Sätze. Ein Gedanke pro Satz.

UI-Wörter fett und genau wie auf dem Knopf: Lasttest, Tabelle, Im Schema bearbeiten, Fork, Helpcenter.
Dateien, Slugs, n=, Typen in `Backticks`.
Links nur intern: [Titel des Zielartikels](/help/slug) — derselbe title, kein Kurzname (Sequenzen ist falsch, wenn der Titel Sequenz bauen heißt).
Eine Siehe auch-Zeile direkt unter dem Einstiegsabsatz, Mittelpunkt ·. Nicht noch einmal am Ende.
Screenshots: PNG unter public/help-screenshots/<name>.png, im Markdown ![Was das Bild zeigt.](/help-screenshots/<name>.png). Nicht unter /help/… ablegen — das ist die Artikel-Route. Alt-Text sagt, welches Feld gemeint ist. Jede Stelle ein anderer Ausschnitt (Lasttest-Box, Felder am Pfeil, Origins-Knopf) — nicht denselben Inspector-Kopf viermal. Die App zeigt sie in Inspector-Breite.
Kein Marketing, kein „einfach“, kein „intuitiv“. Keine englischen Floskeln außer UI- und Dateinamen.
Nicht die ganze App auf jeder Seite erklären. Verweisen.

Anrede in Überschriften wie im Rest: Leg die Tabellen an, Zähl die Tabellen (du, ohne -e).

Aufbau des Bodies

Einstieg (1–3 Sätze): Was ist das, wofür, was ist es nicht.
Siehe auch
Schritte oder Abschnitte als ##. Nummerierte Anleitungen: ## 1. … Unterpunkte ### nur in den langen Bau-Guides (schema.md, sequenzen.md).
Optional Häufiger Fehler / Wenn du nicht weiterkommst — konkret, eine Handlung.

Tabellen nur für Zuordnungen (Bucket → Wann, Datei → Rolle). Keine Prosa in Tabellen gießen.

Codeblöcke nur, wenn der Nutzer sie abtippt (SQL, Dateibaum, Mini-Schema).

Was wohin gehört

Datei	Rolle
`start.md`	Landkarte. Keine Anleitung.
`schema.md` / `sequenzen.md`	Je ein Bau-Guide, darf länger sein.
übrige	Ein Feature, eine Seite, kurz.

Neue Features: neue Datei, nicht an start.md oder den Bau-Guide anhängen.

Zahlen aus der echten Datenbank und das Kürzen von Calls: reallife.md. Wo man n eintippt: lasttest.md. Was die Tokenkarte zeigt: token.md. Nicht vermischen.

Nicht tun

n oder Tok/Zelle runterlügen, „damit es grün wird“.
Features erfinden oder den Inspector nachbauen.
wiki-Links — Helpcenter kennt nur /help/….
Englische Dateinamen als Titel (reallife.md heißt Echte Daten).

Checkliste vor dem Speichern

Frontmatter vollständig, Slug = Dateiname
Kein H1, Siehe auch unter dem Einstieg, Linktexte = Ziel-title
du, kurze Sätze, UI-Wörter fett und wahr
start.md listet den Artikel
ⓘ-Popover braucht einen Artikel? Eintrag in HELP_TOPIC_ARTICLE in components/editor/info-popover.tsx