RWS — Raw Sources, Wiki & Schema

O que RWS — Raw Sources, Wiki & Schema faz?

Instrução geral. Se esta skill está ativa, leia este arquivo inteiro antes de qualquer ação e consulte o Router do Agente sempre que precisar decidir o que fazer.

1. O modelo em 30 segundos

Camada	Pasta (no projeto do usuário)	Dono	Regra de ouro
Raw Sources	raw/	Usuário	Imutável. O agente lê e cita, nunca edita.
Wiki	wiki/	Agente	O agente escreve, conecta e mantém tudo consistente.
Schema	schema/	Usuário + Agente	Convenções e workflows. Co-evolui com aprovação do usuário.

Detalhes completos: core/architecture.md.

2. Protocolo obrigatório (toda sessão)

1. Detectar o estado do projeto:
   • Não existe raw/, wiki/, schema/ → sugerir /setup-green-space (projeto novo) ou /setup-brown-space (codebase existente).
   • Existe → ler schema/schema.md, depois wiki/index.md, depois as últimas 5 entradas de wiki/log.md.
2. Rotear a intenção do usuário com o agent-router.md.
3. Responder perguntas a partir da wiki primeiro (index → páginas → raw para confirmar). Citar páginas com [[wikilinks]] e fontes com raw/<arquivo>#<seção>.
4. Toda mudança na wiki atualiza wiki/index.md e adiciona uma entrada em wiki/log.md.
5. Toda mudança no schema exige aprovação explícita do usuário.
6. Boas respostas viram páginas: análises, comparações e sínteses relevantes são oferecidas para /wiki:add.

3. Comandos

Gramática: /<escopo>:<ação> — escopos raw-source | wiki | schema | ticket, ações add | remove | increment | new | tdd | code | review.

Comando	Workflow
/rws:summary	core/agent-router.md — qual skill usar em cada situação
/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 — orquestrador de implementação / 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 <raiz-do-projeto> + core/lifecycle.md

4. Referências

• core/architecture.md — as três camadas e por que funcionam
• core/agent-router.md — sumário de decisão
• core/conventions.md — nomes, frontmatter, wikilinks
• core/index-and-log.md — formato de index.md e log.md
• core/lifecycle.md — Ingest, Query, Lint, Compounding
• core/ui-patterns-catalog.md — patterns de UI × apps de referência
• templates/ — modelos de página

5. Proibições

• ❌ Editar ou apagar arquivos em raw/ (exceto mover para raw/_archive/ via /raw-source:remove com aprovação).
• ❌ Criar página na wiki sem registrar em index.md e log.md.
• ❌ Alterar schema/ sem aprovação explícita.
• ❌ Afirmar fatos sem fonte: toda afirmação não trivial da wiki aponta para raw/ ou outra página.