RWS — Raw Sources, Wiki & Schema は何をしますか？
汎用指示。このスキルが有効な場合、アクションを起こす前にこのファイル全体を読み、何をすべきか判断する必要があるときは常にエージェントルーターを参照してください。
1. 30秒でわかるモデル
| レイヤー | フォルダ（ユーザープロジェクト内） | 所有者 | 黄金律 |
|---|---|---|---|
| Raw Sources | raw/ | ユーザー | 不変。 エージェントは読み取り・引用のみ、編集は一切不可。 |
| Wiki | wiki/ | エージェント | エージェントが書き、接続し、すべての一貫性を維持する。 |
| Schema | schema/ | ユーザー + エージェント | 規約とワークフロー。ユーザーの承認を得て共進化する。 |
詳細は core/architecture.md を参照。
2. 必須プロトコル（毎セッション）
- プロジェクトの状態を検出する:
raw/、wiki/、schema/が存在しない →/setup-green-space（新規プロジェクト）または/setup-brown-space（既存コードベース）を提案する。- 存在する →
schema/schema.md、次にwiki/index.md、最後にwiki/log.mdの最新5エントリを読み込む。
- ユーザーの意図を agent-router.md でルーティングする。
- Wiki から先に質問に答える（index → ページ → raw で確認）。ページは
[[wikilinks]]、ソースはraw/<ファイル>#<セクション>で引用する。 - Wiki への変更はすべて
wiki/index.mdを更新し、wiki/log.mdにエントリを追加する。 - Schema への変更はすべて ユーザーの明示的な承認を必要とする。
- 優れた応答はページになる: 関連性の高い分析、比較、統合は
/wiki:addとして提供する。
3. コマンド
文法: /<スコープ>:<アクション> — スコープは raw-source | wiki | schema | ticket、アクションは add | remove | increment | new | tdd | code | review。
| コマンド | ワークフロー |
|---|---|
/rws:summary | core/agent-router.md — 各状況でどのスキルを使うか |
/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 — 実装 / ロードマップのオーケストレーター |
/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 <プロジェクトルート> + core/lifecycle.md |
4. 参考資料
- core/architecture.md — 3つのレイヤーとその仕組み
- core/agent-router.md — 判断サマリー
- core/conventions.md — 名前、フロントマター、ウィキリンク
- core/index-and-log.md —
index.mdとlog.mdの形式 - core/lifecycle.md — Ingest, Query, Lint, Compounding
- core/ui-patterns-catalog.md — UIパターン × リファレンスアプリ
- templates/ — ページテンプレート
5. 禁止事項
- ❌
raw/内のファイルを編集または削除する（承認を得た/raw-source:removeでraw/_archive/に移動する場合を除く）。 - ❌
index.mdとlog.mdに登録せずに Wiki ページを作成する。 - ❌ 明示的な承認なしに
schema/を変更する。 - ❌ 出典なしで事実を主張する: Wiki の非自明な主張はすべて
raw/または別のページを指す。