RWS — Raw Sources, Wiki & Schema

Que fait RWS — Raw Sources, Wiki & Schema ?

Instruction générale. Si cette compétence est active, lisez ce fichier en entier avant toute action et consultez le Routeur de l'Agent chaque fois que vous devez décider quoi faire.

1. Le modèle en 30 secondes

Couche	Dossier (dans le projet de l'utilisateur)	Propriétaire	Règle d'or
Raw Sources	raw/	Utilisateur	Immuable. L'agent lit et cite, ne modifie jamais.
Wiki	wiki/	Agent	L'agent écrit, connecte et maintient tout cohérent.
Schema	schema/	Utilisateur + Agent	Conventions et workflows. Co-évolue avec l'approbation de l'utilisateur.

Détails complets : core/architecture.md.

2. Protocole obligatoire (chaque session)

1. Détecter l'état du projet :
   • raw/, wiki/, schema/ n'existent pas → suggérer /setup-green-space (nouveau projet) ou /setup-brown-space (codebase existant).
   • Ils existent → lire schema/schema.md, puis wiki/index.md, puis les 5 dernières entrées de wiki/log.md.
2. Router l'intention de l'utilisateur avec le agent-router.md.
3. Répondre aux questions à partir de la wiki en premier (index → pages → raw pour confirmer). Citer les pages avec [[wikilinks]] et les sources avec raw/<fichier>#<section>.
4. Toute modification de la wiki met à jour wiki/index.md et ajoute une entrée dans wiki/log.md.
5. Toute modification du schema nécessite l'approbation explicite de l'utilisateur.
6. Les bonnes réponses deviennent des pages : les analyses, comparaisons et synthèses pertinentes sont proposées pour /wiki:add.

3. Commandes

Grammaire : /<scope>:<action> — scopes raw-source | wiki | schema | ticket, actions add | remove | increment | new | tdd | code | review.

Commande	Workflow
/rws:summary	core/agent-router.md — quelle compétence utiliser dans chaque situation
/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 — orchestrateur d'implémentation / feuille de route
/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 <racine-du-projet> + core/lifecycle.md

4. Références

• core/architecture.md — les trois couches et pourquoi elles fonctionnent
• core/agent-router.md — résumé de décision
• core/conventions.md — noms, frontmatter, wikilinks
• core/index-and-log.md — format de index.md et log.md
• core/lifecycle.md — Ingest, Query, Lint, Compounding
• core/ui-patterns-catalog.md — patterns UI × applications de référence
• templates/ — modèles de page

5. Interdictions

• ❌ Éditer ou supprimer des fichiers dans raw/ (sauf déplacement vers raw/_archive/ via /raw-source:remove avec approbation).
• ❌ Créer une page dans la wiki sans l'enregistrer dans index.md et log.md.
• ❌ Modifier schema/ sans approbation explicite.
• ❌ Affirmer des faits sans source : toute affirmation non triviale dans la wiki pointe vers raw/ ou une autre page.