RWS — Raw Sources, Wiki & Schema

¿Qué hace RWS — Raw Sources, Wiki & Schema?

Instrucción general. Si esta skill está activa, lee este archivo completo antes de cualquier acción y consulta el Router del Agente siempre que necesites decidir qué hacer.

1. El modelo en 30 segundos

Capa	Carpeta (en el proyecto del usuario)	Dueño	Regla de oro
Raw Sources	raw/	Usuario	Inmutable. El agente lee y cita, nunca edita.
Wiki	wiki/	Agente	El agente escribe, conecta y mantiene todo consistente.
Schema	schema/	Usuario + Agente	Convenciones y flujos de trabajo. Co-evoluciona con aprobación del usuario.

Detalles completos: core/architecture.md.

2. Protocolo obligatorio (cada sesión)

1. Detectar el estado del proyecto:
   • No existe raw/, wiki/, schema/ → sugerir /setup-green-space (proyecto nuevo) o /setup-brown-space (base de código existente).
   • Existe → leer schema/schema.md, después wiki/index.md, después las últimas 5 entradas de wiki/log.md.
2. Enrutar la intención del usuario con el agent-router.md.
3. Responder preguntas a partir de la wiki primero (index → páginas → raw para confirmar). Citar páginas con [[wikilinks]] y fuentes con raw/<archivo>#<sección>.
4. Cada cambio en la wiki actualiza wiki/index.md y añade una entrada en wiki/log.md.
5. Cada cambio en el schema exige aprobación explícita del usuario.
6. Las buenas respuestas se convierten en páginas: análisis, comparaciones y síntesis relevantes se ofrecen para /wiki:add.

3. Comandos

Gramática: /<ámbito>:<acción> — ámbitos raw-source | wiki | schema | ticket, acciones add | remove | increment | new | tdd | code | review.

Comando	Flujo de trabajo
/rws:summary	core/agent-router.md — qué skill usar en cada situación
/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 — orquestador de implementación / 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 <raíz-del-proyecto> + core/lifecycle.md

4. Referencias

• core/architecture.md — las tres capas y por qué funcionan
• core/agent-router.md — resumen de decisión
• core/conventions.md — nombres, frontmatter, wikilinks
• core/index-and-log.md — formato de index.md y log.md
• core/lifecycle.md — Ingest, Query, Lint, Compounding
• core/ui-patterns-catalog.md — patrones de UI × aplicaciones de referencia
• templates/ — modelos de página

5. Prohibiciones

• ❌ Editar o borrar archivos en raw/ (excepto mover a raw/_archive/ mediante /raw-source:remove con aprobación).
• ❌ Crear página en la wiki sin registrarla en index.md y log.md.
• ❌ Alterar schema/ sin aprobación explícita.
• ❌ Afirmar hechos sin fuente: toda afirmación no trivial de la wiki apunta a raw/ u otra página.