From bfb2ff428d9484e472ed8c944c383fa2267e47a4 Mon Sep 17 00:00:00 2001 From: seb Date: Sat, 1 Aug 2026 03:46:16 +0200 Subject: [PATCH] rule --- .cursor/rules/sibling-repos.mdc | 42 +++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 .cursor/rules/sibling-repos.mdc diff --git a/.cursor/rules/sibling-repos.mdc b/.cursor/rules/sibling-repos.mdc new file mode 100644 index 0000000..34c9a7b --- /dev/null +++ b/.cursor/rules/sibling-repos.mdc @@ -0,0 +1,42 @@ +--- +description: Sibling-Repos dashback/dashdbschema — nur lesen, keine Cross-Edits; Docs & Git-Logs +alwaysApply: true +--- + +# Sibling-Repos (dashfront) + +Dieses Repo ist **dashfront** (Vite/React-UI). Geschwister: `../dashback` (HTTP-API), `../dashdbschema` (MSSQL-Schema + Store-API). Jedes Repo hat ein eigenes Agent/Human-Paar. **Cross-Interference nur durch den Human** — du änderst keine Dateien außerhalb dieses Repos. + +## Erlaubt (read-only) + +- Git-Logs der Geschwister lesen, wenn API/Schema-Stand unklar ist: + - `git -C ../dashback log --oneline -20` + - `git -C ../dashdbschema log --oneline -20` +- Doku und Code der Geschwister **lesen** (Verträge prüfen, nicht patchen) + +## Verboten + +- Dateien in `../dashback` oder `../dashdbschema` schreiben, committen, installieren, Server starten/stoppen +- API-Shapes raten oder aus Konvention ableiten (siehe auch `no-assumed-api`) +- Backend-/Schema-Fixes „nebenbei“ — der Human koordiniert +- **Keine Fallbacks** — fehlende/unklare API nicht erraten, nicht mit Defaults/Alternativfeldern/-endpoints kaschieren (siehe auch `no-silent-fallbacks`) + +## Unklar oder fehlt → absprechen + +Wenn ein Vertrag unklar oder fehlt: **nicht weiterwursteln**. Human fragen, Vorschläge machen, Lücken benennen. Absprache läuft über den Human zu den anderen Agents. **Lieber zu oft gefragt als zu wenig.** + +## Docs — wo was steht + +| Repo | Pfad | Inhalt | +|------|------|--------| +| **dashback** | `../dashback/docs/api/README.md` | HTTP-Routen, Auth, CORS | +| **dashback** | `../dashback/docs/api/routes/` | eine Markdown-Datei pro Endpoint | +| **dashback** | `../dashback/docs/api/openapi.json` | maschinenlesbare Spec | +| dashdbschema | `../dashdbschema/README.md` | Store-Methoden (für dich selten nötig; Backend mappt darauf) | +| **dieses** | `README.md`, `src/api/index.js` | Client-Spiegel des Backend-Vertrags | + +## Was du vom Human / dashback erwartest + +1. **Vor neuem/geändertem Endpoint:** dokumentierte Route unter `../dashback/docs/api/routes/` (oder `openapi.json`). Fehlt die Doku → **nicht implementieren**, Human fragen. +2. Bei Unklarheit zuerst dashback-Git-Log und API-Docs lesen. +3. `src/api/index.js` nur als Spiegel — nie Quelle der Wahrheit vor dem Backend-Vertrag.