Was macht RWS — Raw Sources, Wiki & Schema?
Allgemeine Anweisung. Wenn dieses Skill aktiv ist, lesen Sie diese Datei vollständig, bevor Sie irgendeine Aktion ausführen, und konsultieren Sie den Agenten-Router, wann immer Sie eine Entscheidung treffen müssen.
1. Das Modell in 30 Sekunden
| Ebene | Ordner (im Benutzerprojekt) | Besitzer | Goldene Regel |
|---|---|---|---|
| Raw Sources | raw/ | Benutzer | Unveränderlich. Der Agent liest und zitiert, bearbeitet nie. |
| Wiki | wiki/ | Agent | Der Agent schreibt, verknüpft und hält alles konsistent. |
| Schema | schema/ | Benutzer + Agent | Konventionen und Workflows. Entwickelt sich mit Zustimmung des Benutzers weiter. |
Ausführliche Details: core/architecture.md.
2. Verbindliches Protokoll (jede Sitzung)
- Erkennen Sie den Projektzustand:
- Es existieren keine Ordner
raw/,wiki/,schema/→/setup-green-space(neues Projekt) oder/setup-brown-space(bestehende Codebase) vorschlagen. - Sie existieren →
schema/schema.md, dannwiki/index.md, dann die letzten 5 Einträge vonwiki/log.mdlesen.
- Es existieren keine Ordner
- Leiten Sie die Benutzerabsicht mit dem agent-router.md weiter.
- Beantworten Sie Fragen zuerst aus der Wiki (index → Seiten → raw zur Bestätigung). Zitieren Sie Seiten mit
[[Wikilinks]]und Quellen mitraw/<datei>#<abschnitt>. - Jede Änderung an der Wiki aktualisiert
wiki/index.mdund fügt einen Eintrag inwiki/log.mdhinzu. - Jede Änderung am Schema erfordert die explizite Zustimmung des Benutzers.
- Gute Antworten werden zu Seiten: relevante Analysen, Vergleiche und Synthesen werden für
/wiki:addangeboten.
3. Befehle
Grammatik: /<scope>:<action> — Scopes raw-source | wiki | schema | ticket, Aktionen add | remove | increment | new | tdd | code | review.
| Befehl | Workflow |
|---|---|
/rws:summary | core/agent-router.md — welches Skill in welcher Situation zu verwenden ist |
/setup-brown-space | skills/setup-brown-space |
/setup-green-space | skills/setup-green-space |
/grill (/grill-me) | skills/grill |
/grill-design | skills/grill-design |
/ticket:new · :add | new · add |
/ticket:tdd · :code · :review | tdd · code · review |
/implement | skills/implement — Implementierungs-Orchestrator / Roadmap |
/raw-source:add · :remove · :increment | add · remove · increment |
/wiki:add · :remove · :increment | add · remove · increment |
/schema:add · :remove · :increment | add · remove · increment |
/rws:lint | node <skill>/bin/lint-rws.js <projekt-root> + core/lifecycle.md |
4. Referenzen
- core/architecture.md — die drei Ebenen und warum sie funktionieren
- core/agent-router.md — Entscheidungsübersicht
- core/conventions.md — Namen, Frontmatter, Wikilinks
- core/index-and-log.md — Format von
index.mdundlog.md - core/lifecycle.md — Ingest, Query, Lint, Compounding
- core/ui-patterns-catalog.md — UI-Muster × Referenz-Apps
- templates/ — Seitenvorlagen
5. Verbote
- ❌ Dateien in
raw/bearbeiten oder löschen (außer Verschieben nachraw/_archive/via/raw-source:removemit Genehmigung). - ❌ Eine Wiki-Seite erstellen, ohne sie in
index.mdundlog.mdzu registrieren. - ❌
schema/ohne explizite Zustimmung ändern. - ❌ Fakten ohne Quelle behaupten: Jede nicht-triviale Aussage in der Wiki verweist auf
raw/oder eine andere Seite.