用語集
すべての rasen 用語が 1 つの場所で、平易な言葉で定義されています。1 回ざっと読んで、残りのドキュメントが速く読めます。
用語はトピック別に、グループ内でアルファベット順にグループ化されています。
コア名詞
仕様。 システムの一部がどのように動作するかを説明するドキュメント。仕様は rasen/specs/ に住んでおり、ドメイン別に組織化され、要件とシナリオから作られています。仕様は「このソフトウェアは何をしますか？」に対する合意された答えです。Concepts を参照してください。
唯一事実来源。 全体として rasen/specs/ ディレクトリ。システムの現在、合意された動作を保持します。変更はそれへの編集を提案します。アーカイブが適用します。
変更。 作業の 1 単位で、rasen/changes/<name>/ の下のフォルダとしてパッケージ化されています。変更はその仕事についてすべてを保持します：提案、設計、タスク、それが導入する仕様編集。1 つの変更、1 つの機能または修正。
成果物。 変更内のドキュメント。標準的な成果物は提案、デルタ仕様、設計、タスクです。それらは依存関係順に作成され、互いに供給しています。
デルタ仕様。 変更内の仕様で、全体の仕様を述べ直すのではなく ADDED、MODIFIED、REMOVED セクションを使用して、変わっているものだけを説明しています。これが rasen が既存のシステムを清潔に編集できるようにすることです。Concepts を参照してください。
ドメイン。 auth/、payments/、ui/ のような仕様の論理的なグループ化。あなたのシステムについて考える方法と一致するドメインを選択します。
仕様内
要件。 システムが持つ必要がある単一の動作で、通常、RFC 2119 キーワードで書かれています：「システムは 30 分の非アクティビティ後、セッションを有効期限切れにしなければなりません（MUST）。」要件は 何を 述べ、方法 は述べていません。
シナリオ。 与えられた/いつ/その形式で、実際の要件の具体的でテスト可能な例。シナリオは要件を検証可能にします：あなたは 1 つから自動化されたテストを書くことができます。
RFC 2119 キーワード。 MUST、SHALL、SHOULD、MAY の単語。これらは要件がどのくらい厳しいかについて標準化された意味を持ちます。MUST と SHALL は絶対です。SHOULD は例外の余地を持つ推奨です。MAY はオプションです。名前は、それらを定義した インターネット標準ドキュメントに由来しています。
成果物
提案（proposal.md）。 変更の 理由 と 何：意図、スコープ、高レベルアプローチ。作成する最初の成果物。
設計（design.md）。 方法：技術的アプローチ、アーキテクチャの決定、タッチすることを期待するファイル。シンプルな変更にはオプション。
タスク（tasks.md）。 チェックボックス付き実装チェックリスト。AI は /rasen:apply 中にそれを処理し、進行するにつれてアイテムをチェックオフします。
ライフサイクル
アーカイブ。 変更を終了する行為。デルタ仕様はメイン仕様にマージし、変更フォルダは rasen/changes/archive/YYYY-MM-DD-<name>/ に移動します。アーカイブ後、仕様は新しい現実を説明しています。Concepts を参照してください。
同期。 変更のデルタ仕様をメイン仕様にマージしないでアーカイブすること。通常は自動（アーカイブが行うことを提案）ですが、長時間実行されている変更のために /rasen:sync として独立して利用可能です。Commands を参照してください。
ワークフローとコマンド
OPSX。 現在の標準 rasen ワークフロー。固いフェーズではなく流動的なアクションの周りに構築されています。そのスラッシュコマンドはすべて /rasen: で始まります。OPSX Workflow を参照してください。
スラッシュコマンド。 AI アシスタントのチャットに入力するコマンド（/rasen:propose など）。スラッシュコマンドはワークフローを駆動します。これらはターミナルコマンドではありません。How Commands Work を参照してください。
探索（/rasen:explore）。 考えるパートナーコマンド。コードベースを読み、オプションを比較し、ファジーなアイデアを具体的なプランに明確にし、成果物を作成せず、コードを書きません。問題があるが計画がまだない場合の推奨開始点。Explore First を参照してください。
CLI。 ターミナルで実行する rasen プログラム。プロジェクトをセットアップし、変更をリストおよび検証し、ダッシュボードを開き、アーカイブします。rasen のターミナルハーフ。CLI を参照してください。
スキル。 AI アシスタントが自動検出して従うフォルダの指示（.../skills/rasen-*/SKILL.md）。スキルは、rasen ワークフローをアシスタントに配信するための新興のクロスツール標準です。
コマンドファイル。 ツール単位のスラッシュコマンドファイル（.../commands/rasen-*）。配信が both の場合にスキルと一緒にインストールされるオプションの追加です。あなたはこれらを直接タッチすることはめったにありません。
プロファイル。 プロジェクトにインストールされているスラッシュコマンドのセット。Full（デフォルト）はすべてのワークフローをインストールします。Core は propose、explore、apply、sync、archive に減らします。custom はあなたが選ぶ任意のサブセット。rasen config profile で変更します。
配信。 rasen がスキルと一緒にコマンドファイルもインストールするか（both、デフォルト）、またはスキルのみかどうか（skills）。スキルは常にインストールされます。グローバルに設定され、rasen update で適用されます。
カスタマイズ
スキーマ。 ワークフローが持つ成果物と相互にどのように依存するかの定義。組み込みデフォルトは spec-driven（提案 → 仕様 → 設計 → タスク）。それをフォークするか、独自に書くことができます。Customization を参照してください。
テンプレート。 スキーマ内のマークダウンファイルで、特定の成果物に対して AI が生成するものをシェイプアップします。テンプレートを編集すると、AI の出力がリビルドなしで即座に変わります。
プロジェクト設定（rasen/config.yaml）。 プロジェクト単位の設定：デフォルトスキーマ、すべての計画要求に注入される context:、および成果物単位の rules:。あなたのスタックとコンベンションを rasen に教える最も簡単な方法。Customization を参照してください。
コンテキスト注入。 プロジェクトバックグラウンドを config.yaml の context: フィールドに入れるため、それが AI が生成するすべての成果物に自動的に追加されます。AI が別のファイルを読むことを望むよりも信頼性が高いです。
依存関係グラフ。 アーティファクト requires: 関係によって形成される有向グラフ。これは DAG（有向非循環グラフ：矢印は前向きにのみ指しており、ループ中ではなく）で、rasen はそれを使用して次に何を作成できるかを知っています。
イネーブラー、ゲートではない。 成果物の依存関係が次に 可能な ものを表示する原則で、必須な 次のものではない。任意の時点で任意の成果物にアクセスして編集できます。Core Concepts at a Glance を参照してください。
リポ間調整（ベータ）
これらの用語は、計画が複数のリポにまたがる場合のみ適用されます。彼らはベータです。ほとんどのユーザーはそれらを無視できます。Stores User Guide を参照してください。
ストア。 スタンドアロンレポで、全体的なタスクは計画です。それはあなたが既に知っている同じ rasen/ 形状（仕様と変更）に加えて小さなアイデンティティファイルを持っています。あなたはそれを機械上で 1 回名前で登録し、その後、あらゆる rasen コマンドはどこからでもそれで機能できます。
リファレンス。 コードレポの rasen/config.yaml でのそのレポが描画する存在の宣言。リファレンスは読み取り専用です：レポはそれ自身のルートを保持し、rasen instructions 参照されたストアの仕様の指標を取得します。それぞれ正確なコマンドで。
作業コンテキスト。 rasen context が現在のレポ用に組み立てるもの：Rasen ルートプラス参照するすべてのストア、それぞれ取得方法。「私は何を扱っていますか？」への答え。
ワークセット。 個人的なマシンローカルのフォルダセット（ストアと一緒にあなたが機能するコードレポ）。rasen workset create で明示的に作成。それらのローカルパスについて何も共有計画レポにコミットされません。
関連を参照
- Core Concepts at a Glance：5 つのアイデア、1 ページ
- Concepts：長形式の説明
- How Commands Work：スラッシュコマンド対 CLI