Communitygithub.com

RWS — Raw Sources, Wiki & Schema

RWS (Raw Sources, Wiki & Schema) – eine LLM-gepflegte, persistente Wissensbasis-Architektur basierend auf Andrej Karpathys „LLM Wiki“-Muster. Immer dann verwenden, wenn das Projekt die Ordner raw/, wiki/ oder schema/ enthält oder der Benutzer eine Codebase-Audit, Wissensdokumentation, Feature-Planung (Grill), UI/UX-Planung (Grill-Design) oder Befehle im Format /<scope>:<action> (raw-source, wiki, schema × add, remove, increment) anfordert.

Was ist RWS — Raw Sources, Wiki & Schema?

RWS (Raw Sources, Wiki & Schema) ist eine Architektur für eine persistente Wissensbasis, die von einem KI-Agenten (LLM) verwaltet wird. Sie folgt dem „LLM Wiki“-Ansatz von Andrej Karpathy und organisiert Projektdokumentation in drei Ebenen: rohe, unveränderliche Quellen (raw/), eine vom Agenten gepflegte, verknüpfte Wiki (wiki/) und gemeinsam verwaltete Schemata (schema/). Das Skill wird typischerweise in Code-Umgebungen wie Claude Code, Cursor oder Codex eingesetzt. Es stellt sicher, dass der Agent vor jeder Aktion den Projektzustand erkennt, die Wiki als primäre Wissensquelle nutzt und alle Änderungen konsistent protokolliert. Dadurch werden Codebase-Audits, Wissensdokumentation, Feature-Planung (Grill) und UI/UX-Design (Grill-Design) strukturiert und nachvollziehbar. Nützlich ist es besonders für komplexe Softwareprojekte, bei denen ein KI-Assistent über Sitzungen hinweg konsistenten Kontext und eine nachvollziehbare Entscheidungsgeschichte bereitstellen soll.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add victor-lis-bronzo/rws-skill

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

EbeneOrdner (im Benutzerprojekt)BesitzerGoldene Regel
Raw Sourcesraw/BenutzerUnveränderlich. Der Agent liest und zitiert, bearbeitet nie.
Wikiwiki/AgentDer Agent schreibt, verknüpft und hält alles konsistent.
Schemaschema/Benutzer + AgentKonventionen und Workflows. Entwickelt sich mit Zustimmung des Benutzers weiter.

Ausführliche Details: core/architecture.md.

2. Verbindliches Protokoll (jede Sitzung)

  1. 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, dann wiki/index.md, dann die letzten 5 Einträge von wiki/log.md lesen.
  2. Leiten Sie die Benutzerabsicht mit dem agent-router.md weiter.
  3. Beantworten Sie Fragen zuerst aus der Wiki (index → Seiten → raw zur Bestätigung). Zitieren Sie Seiten mit [[Wikilinks]] und Quellen mit raw/<datei>#<abschnitt>.
  4. Jede Änderung an der Wiki aktualisiert wiki/index.md und fügt einen Eintrag in wiki/log.md hinzu.
  5. Jede Änderung am Schema erfordert die explizite Zustimmung des Benutzers.
  6. Gute Antworten werden zu Seiten: relevante Analysen, Vergleiche und Synthesen werden für /wiki:add angeboten.

3. Befehle

Grammatik: /<scope>:<action> — Scopes raw-source | wiki | schema | ticket, Aktionen add | remove | increment | new | tdd | code | review.

BefehlWorkflow
/rws:summarycore/agent-router.md — welches Skill in welcher Situation zu verwenden ist
/setup-brown-spaceskills/setup-brown-space
/setup-green-spaceskills/setup-green-space
/grill (/grill-me)skills/grill
/grill-designskills/grill-design
/ticket:new · :addnew · add
/ticket:tdd · :code · :reviewtdd · code · review
/implementskills/implement — Implementierungs-Orchestrator / Roadmap
/raw-source:add · :remove · :incrementadd · remove · increment
/wiki:add · :remove · :incrementadd · remove · increment
/schema:add · :remove · :incrementadd · remove · increment
/rws:lintnode <skill>/bin/lint-rws.js <projekt-root> + core/lifecycle.md

4. Referenzen

5. Verbote

  • ❌ Dateien in raw/ bearbeiten oder löschen (außer Verschieben nach raw/_archive/ via /raw-source:remove mit Genehmigung).
  • ❌ Eine Wiki-Seite erstellen, ohne sie in index.md und log.md zu registrieren.
  • ❌ schema/ ohne explizite Zustimmung ändern.
  • ❌ Fakten ohne Quelle behaupten: Jede nicht-triviale Aussage in der Wiki verweist auf raw/ oder eine andere Seite.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills