FAQ
よくある質問への手早い回答です。「何かが壊れている」という質問であれば、Troubleshooting の方が適切です。用語の定義を探しているなら Glossary を見てください。
基本
rasen とは、一言で言うと？
意図を成果物に変える自律基盤です。やりたいことを伝えれば、あとは計画し、実装し、レビューし、出荷し、アーカイブするところまで自分で進めます。動かすのはコードではなく、アイデアです。
なぜそれが必要なのですか？
AI アシスタントは、間違っているときでも自信満々だからです。放っておくと、AI は要件の空白を推測で埋めてしまい、それに気づくのはコードができあがったあとになります。Rasen の外側のループは、あなたの意図を早い段階で仕様として記録します——それは基盤自身の作業記憶であって、あなたに返される宿題ではありません——だからズレはまだ直すコストが小さいうちに見つかります。全体像は Core Concepts at a Glance を参照してください。
すべての作業で使わないといけませんか？
いいえ。ズレを早く見つけることが重要になる場面、つまり非自明な作業のほとんどで使ってください。1文字のタイポを直すだけなら、この手順は割に合わないでしょうし、それで問題ありません。
大きな既存コードベースでも使えますか、それとも新規プロジェクト専用ですか？
既存コードベースこそが主戦場です。Rasen はブラウンフィールドを第一に考えて作られており、アプリ全体を最初にすべて文書化する必要はありません。基盤がそれぞれの変更が触れる部分だけスペックを生成し、実際に手を動かした範囲から少しずつスペックが埋まっていきます。専用のガイドもあります。Using Rasen in an Existing Project を参照してください。
特定の AI ツールに縛られますか？
いいえ。Rasen は Claude Code、Cursor、Windsurf、GitHub Copilot、Gemini CLI、Codex をはじめとする25以上のアシスタントで動きます。全リストとツールごとの詳細は Supported Tools にあります。
コマンドを実行する
/rasen:propose はどこに入力すればいいですか？
ターミナルではなく、AI アシスタントのチャットです。これは最もよくある混乱ポイントなので、専用のページを用意してあります。How Commands Work を参照してください。手短に言うと、rasen ... はターミナルで、/rasen:... はチャットで実行します。
「インタラクティブモードを開始する」にはどうすればいいですか？
あらためて開始する専用モードというものはありません。いつも通り AI アシスタントを開いて、そのチャットにスラッシュコマンドを入力するだけです。スラッシュコマンドこそが rasen に「入る」方法なのです（唯一、本当にインタラクティブなターミナル機能は rasen view で、スペックや変更をブラウズするためのダッシュボードです）。詳しい説明は How Commands Work にあります。
スラッシュコマンドを入力したのに、何も起きません。なぜですか？
おそらく AI チャットではなくターミナルに入力してしまったか、コマンドがまだインストールされていません。プロジェクトで rasen update を実行し、アシスタントを再起動してから、チャットで /rasen と入力してオートコンプリートが出るか確認してください。完全なチェックリストは Troubleshooting にあります。
なぜあるツールでは /rasen:propose、別のツールでは /rasen-propose という構文になるのですか？
AI ツールごとに、カスタムコマンドの見せ方が少しずつ違うからです。意図はまったく同じで、変わるのは句読点だけです。チャットでスラッシュを入力すれば、オートコンプリートがそのツールの期待する形式を表示してくれます。ツールごとの対応表は How Commands Work にあります。
スキルとコマンドは何が違うのですか？
どちらも、あなたのアシスタントがワークフローを実行できるように rasen が書き出すファイルです。スキル（.../skills/rasen-*/SKILL.md）はより新しいツール横断の標準で、コマンド（.../commands/rasen-*）はより古い、ツールごとのスラッシュファイルです。どちらを選ぶか意識する必要はありません。スラッシュコマンドを入力するだけで、あなたのツールが使う方を rasen が勝手にインストールしてくれます。
ワークフロー
何を作るか決まっていないとき、どこから始めればいいですか？
/rasen:explore からです。これはリスクゼロの思考パートナーで、あなたのコードベースを読み、選択肢を並べ、変更やコードが1つも存在しないうちに曖昧な課題を具体的なプランへと変えていきます。デフォルトプロファイルに含まれているので、常に使えます。プランが固まったら /rasen:propose に引き継がれます。これは身につけるべき最良の習慣です。せっかちな AI が自信満々に間違ったものを作ってしまうのを止めてくれるからです。Explore First を参照してください。
一番シンプルな流れは何ですか？
/rasen:explore (optional) then /rasen:propose <what you want> then /rasen:apply then /rasen:archive
考えを整理するために explore、プランを起草するために propose、実際に作るために apply、そして片付けるために archive。すでに何を作りたいか正確にわかっているなら、explore は飛ばしてかまいません。
/rasen:propose と /rasen:new は何が違うのですか？
/rasen:propose はデフォルトのワンステップコマンドで、変更を作成し、計画に関わる成果物をすべて一度に起草します。/rasen:new は拡張コマンドセットの一部で、空の変更をスキャフォールドするだけにとどまり、成果物は /rasen:continue で1つずつ（あるいは /rasen:ff で一気に）作ることになります。段階的に制御したいのでなければ propose を使ってください。Commands を参照してください。
core プロファイルと拡張プロファイルとは何ですか？
プロファイルは、どのスラッシュコマンドをインストールするかを決めるものです。Full（デフォルト）はすべてのワークフローをインストールします。Core は propose、explore、apply、sync、archive に絞り込み、custom では任意の組み合わせを自分で選べます。rasen config profile で切り替えたあと、rasen update を実行して反映してください。
/rasen:sync は実行する必要がありますか？
通常は不要です。sync は変更のデルタ仕様をメインのスペックにマージするコマンドで、/rasen:archive が代わりに実行するかどうかを尋ねてくれます。アーカイブより前にスペックをマージしておきたい場合——たとえば長く続いている変更のときなど——にだけ、手動で sync を実行してください。Commands を参照してください。
作業を始めたあとで、提案・スペック・タスクを編集するにはどうすればいいですか？
そのままファイルを編集するだけです。すべての成果物は rasen/changes/<name>/ の下にあるただの Markdown であり、ロックされたフェーズや特別な編集モードは存在しません。手で直接変更してもいいですし、AI に修正を頼んでもかまいません（例：「キューを使うように設計を更新して」）。そのまま続ければ、AI は常にその時点でのファイルの内容から作業します。詳しいガイドは Editing & Iterating on a Change を参照してください。
一部を実装したあとで、計画に戻って変更できますか？
はい、いつでもできます。このワークフローは流動的なので、レビューや編集ができなくなるフェーズというものはありません。成果物を編集して、そのまま続ければいいのです。コードが計画とまだ一致しているかを構造的に確認したい場合は /rasen:verify を実行してください。Editing & Iterating on a Change を参照してください。
コードを手で編集しました。スペックとどう突き合わせればいいですか？
アーカイブする前に、両者を同期した状態に戻してください。アーカイブすると、あなたのスペックが「真実の記録」になるからです。コードの方が正しければ、実際に出荷した内容に合わせてデルタ仕様を更新してください。スペックの方が正しければ、コードがそれに一致するまで実装を続けてください。/rasen:verify を実行すると、食い違いが表面化します。Editing & Iterating on a Change を参照してください。
既存の変更を更新すべきか、新しい変更を始めるべきか、どう判断しますか？
同じ作業を練り直しているだけなら、既存の変更を更新してください。意図が根本的に変わったり、スコープが別の作業へと膨れ上がったりしたなら、新しく始めてください。判断のためのフローチャートと具体例が Workflows にあります。
セッションのコンテキストが尽きたり、実装の途中で要件が変わったりしたらどうすればいいですか？
まさにここで、スペックが真価を発揮します。プランはチャット履歴だけでなくファイルの中に存在しているので、コンテキストをクリアし、新しい AI セッションを始めて、/rasen:apply で続きから再開できます。artifacts を読み込み、最初の未完了タスクから再開してくれます。要件が変わった場合は、成果物を新しい現実に合わせて編集してから続けてください。コンテキストウィンドウをきれいに保つこと自体が、より良い結果につながります。実装前にはクリアしておきましょう。
rasen/ フォルダは git にコミットすべきですか？
はい。あなたのスペック、進行中の変更、アーカイブはすべてプロジェクトの履歴の一部です。他のソースコードと同じようにコミットしてください。特にアーカイブは、なぜシステムがそのように動くのかを示す、消えない記録になります。
スペックと変更
スペックと設計には、それぞれ何を書くのですか？
スペックは観測可能な振る舞いを記述します。システムが何をするか、その入力・出力・エラー条件です。設計はそれをどう作るかを記述します。技術的なアプローチ、アーキテクチャ上の決定、ファイルの変更点です。外部から見える振る舞いを変えずに実装だけを変えられるのであれば、それはスペックではなく設計に属します。詳しくは Concepts を参照してください。
デルタ仕様とは何ですか？
スペック全体を書き直す代わりに、ADDED、MODIFIED、REMOVED の各セクションを使って、変わる部分だけを記述するスペックです。これが、rasen が既存システムへの編集をきれいに扱える理由です。Concepts を参照してください。
アーカイブされた変更はどこへ行きますか？
rasen/changes/archive/YYYY-MM-DD-<name>/ に、成果物一式がすべて保存された状態で移動します。何も削除されません。変更が進行中リストから外れるだけです。
設定とカスタマイズ
自分の技術スタックを AI に伝えるにはどうすればいいですか？
rasen/config.yaml の context: の下に書いてください。そのテキストはすべての計画リクエストに注入されるので、AI は常にあなたのスタックや規約を把握した状態になります。Customization を参照してください。
英語以外の言語でスペックを生成できますか？
はい。設定の context: に言語指示を追加してください。Multi-Language には、いくつかの言語向けにコピー&ペーストできるスニペットが用意されています。
ワークフロー自体を変更できますか？
はい、カスタムスキーマを使えば可能です。スキーマは、どの成果物が存在し、それらが互いにどう依存するかを定義するものです。rasen schema fork spec-driven my-workflow でデフォルトをフォークしてから編集してください。Customization を参照してください。
モデル・プライバシー・アップグレード
どの AI モデルを使うべきですか？
Rasen は、計画と実装の両方で高い推論能力を持つモデルと組み合わせたときに最もよく機能します。アシスタントが有能であるほど、スペックの起草がうまくなり、コードが書かれる前にギャップを見つけてくれます。コンテキストウィンドウをきれいに保つことも重要です。実装前にクリアしておくと、結果が良くなります。
rasen はデータを収集しますか？
匿名の利用統計だけを収集します。コマンド名とバージョンのみです。引数、パス、内容、個人データは一切収集されず、CI では自動的にオフになります。オプトアウトするには export RASEN_TELEMETRY=0 または export DO_NOT_TRACK=1 を設定してください。
アップグレードするにはどうすればいいですか？
2ステップです。まずパッケージをアップグレードし（npm install -g @atelierai/rasen@latest）、その後、生成済みのスキルとコマンドを更新するために各プロジェクトの中で rasen update を実行してください。
rasen をアンインストールするにはどうすればいいですか？
専用のアンインストールコマンドはありません。rasen はグローバルパッケージとプロジェクト内のファイルだけで成り立っているからです。パッケージを削除し（npm uninstall -g @atelierai/rasen）、必要に応じて rasen/ ディレクトリと生成済みのツールファイルを削除してください。何を残しても安全かを含めた手順は Installation: Uninstalling にあります。
ヘルプを得る
質問したりバグを報告したりするにはどこへ行けばいいですか？
- Discord: discord.gg/YctCnvvshC
- GitHub Issues: github.com/DumoeDss/rasen/issues
- ターミナルから：
rasen feedback "your message"を実行すると、あなたに代わって GitHub の issue を開いてくれます。
このドキュメントが間違っている、あるいはわかりにくいです。どうすればいいですか？
教えてください。あるいは自分で直してください。ドキュメントの PR は歓迎ですし、価値があります。issue を開くか、プルリクエストを送ってください。