例とレシピ

本当の変更、開始から終了まで。各レシピは、入力するコマンドと見返りに何を見るかを示すため、状況をパターンに一致させ、コピーできます。これらは日常的な core コマンド（propose、explore、apply、sync、archive、デフォルト full プロファイルで標準で利用可能）を使用します。拡張セットが役立つ場合は、注記されています。

開始する前の思い出：/rasen:propose のようなスラッシュコマンドは AI アシスタントのチャット に入り、rasen コマンドは ターミナル に入ります。それが新しい場合は、How Commands Work を最初に読んでください。以下のトランスクリプトでは、You: と AI: はチャットで、$ で始まる行はターミナルです。

まだ何を構築しているか確信がありませんか？ これらのレシピのほとんどは、最初に /rasen:explore で考え抜くと鋭くなります。Recipe 3 はそれを動作中に示し、Explore First ガイドは完全なケースを作成します。

レシピ 1：小さな機能、高速パス

使用する時期： あなたが何をしたいかを知っていて、それが含まれた仕事の一部です。これは最も一般的なレシピです。

全体は 3 つのコマンドです。提案、構築、アーカイブ。

あなた： /rasen:propose add-logout-button

AI：  rasen/changes/add-logout-button/ を作成
     ✓ proposal.md — 理由と何
     ✓ specs/      — 新しい要件とそのシナリオ
     ✓ design.md   — 技術的なアプローチ
     ✓ tasks.md    — 実装チェックリスト
     実装の準備完了。/rasen:apply を実行します。

現在、計画を読んでください。提案とデルタ仕様を開きます。これは rasen が構築される瞬間です：それが 400 行のコードではなく、まだ 1 つの段落であるうちに、間違った仮定をキャッチすること。何かがオフなら、任意の成果物を直接編集し、続行します。

あなた： /rasen:apply

AI：  タスクを処理...
     ✓ 1.1 ヘッダーにログアウトボタンを追加
     ✓ 1.2 クリック時にセッションをクリア
     ✓ 1.3 確認ダイアログを追加
     すべてのタスク完了！

あなた： /rasen:archive

AI：  add-logout-button をアーカイブ...
     ✓ rasen/specs/auth/spec.md に仕様をマージ
     ✓ rasen/changes/archive/2026-06-22-add-logout-button/ に移動
     完了。次の変更の準備完了。

それです。ログアウト動作は現在あなたの仕様の一部であり、変更は完全なコンテキストで保存されます。

レシピ 2：バグフィックス

使用する時期： 何か壊れていて、修正を動作への意図的な変更として記録し、謎のコミットではなく、希望します。

バグフィックスは機能とまったく同じように機能します。違いは、提案のフレーミング方法：「バグを修正」するだけでなく、正しい 動作を説明します。

あなた： /rasen:propose fix-login-redirect-loop

AI：  rasen/changes/fix-login-redirect-loop/ を作成
     提案は現在の壊れた動作と意図された動作をキャプチャします。
     デルタ仕様は、リダイレクト要件を変更し、現在は正確で
     テスト可能です。
     実装の準備完了。

修正はフレッシュなシナリオを備えた MODIFIED 要件として着地するため、次の人（または次の AI セッション）は修正したことだけでなく、「正しい」とは何かを見ます。その後、通常のように /rasen:apply と /rasen:archive。

ヒント：修正の場合、良いシナリオはプロz で回帰テストです。「GIVEN はログアウトしたユーザー、WHEN が有効な認証情報を送信、THEN がダッシュボードに着地し、再度リダイレクトされません。」それを書き、実装は明確なターゲットを持ちます。

レシピ 3：コミットする前に探索

使用する時期： 問題がありますが、計画がまだありません。何を構築すべきか、またはどのアプローチが正しいかは確信していません。

/rasen:explore で開始してください。それは構造がなく、作成された成果物がない考える相棒です。それはあなたのコードベースを読み、決定するのを手伝ってくれます。

あなた： /rasen:explore

AI：  何を探索したいですか？

あなた： ページ読み込みは遅く見えますが、時間がどこに行くのかわかりません。

AI：  見てみましょう... 3 つの可能な容疑者を見つけました：
     1. 製品リストの大きな最適化されていない画像
     2. 非同期データ取得がレンダーをブロック
     3. コンテキスト変更によってトリガーされた再レンダリング
     どれを最初に解決すべきですか？

あなた： データ取得一つ。

あなた： /rasen:propose optimize-product-list-fetching

AI：  変更を作成しました。提案は私たちが見つけたばかりで
     知らされています。実装の準備完了。

探索は、あなたがそれに変更を費やす前に、あなたの考え方を明確にします。洞察が結晶化されたら、提案し、AI はコンテキストを前方に運びます。

レシピ 4：同時に 2 つの変更をジャグリング

使用する時期： あなたはミッド機能で緊急な修正がキューをジャンプします。

変更は独立したフォルダであるため、並行作業は競合しません。修正を開始し、配布してから、機能に正しく戻ります。

あなた： 私は add-dark-mode の途中ですが、今ログインバグを修正する必要があります。

あなた： /rasen:propose fix-login-redirect

AI：  rasen/changes/fix-login-redirect/ を作成。実装の準備完了。

あなた： /rasen:apply

AI：  修正を実装。すべてのタスク完了。

あなた： /rasen:archive

AI：  ✓ fix-login-redirect をアーカイブ。

あなた： ダークモードに戻る。

あなた： /rasen:apply add-dark-mode

AI：  add-dark-mode を再開。タスク 2.3 でピックアップ：ヘッダーを更新...

/rasen:apply add-dark-mode で変更に名前を付けることは、複数がアクティブなときに特定の変更で AI を指すことです。タスク追跡は tasks.md で完了するため、AI はあなたが停止した正確な場所を知っています。

複数の変更が一度に行われたら、拡張 /rasen:bulk-archive はそれらを一緒に保存し、実装されているもの確認することで仕様紛争を解決します。Workflows を参照してください。

レシピ 5：行動変化のないリファクタ

使用する時期： コードを再構築していて、外部から見える動作は同一のままである必要があります。

これは興味深いケースです。純粋なリファクタには あなたの仕様に追加するものがありません。動作契約は変わりません。実装だけです。したがって、仕事は設計とタスクに住んでおり、仕様デルタは空または存在しません。

あなた： /rasen:propose refactor-payment-module

AI：  変更を作成。提案は目標（支払いモジュール、行動変化なし）を述べ、設計が新しい構造をキャプチャします。
     動作は同一であるため、仕様変更なし。
     実装の準備完了。

仕様に触れない変更をアーカイブするときに、ターミナルコマンドに仕様ステップをスキップするように指示できます：

$ rasen archive refactor-payment-module --skip-specs

同じフラグはツール、CI、およびドキュメントのみの変更に便利です。原則：仕様は行動を説明するため、行動が変わらなかったら、仕様もそうでなくてはなりません。Concepts を参照してください。

レシピ 6：ステップバイステップの制御（拡張コマンド）

使用する時期： 複雑またはリスキーな変更で、先に進む前に各成果物をレビューしたい場合。

コア /rasen:propose はすべてを一度に起案します。ステップバイステップで行いたい場合、拡張コマンドをオンにします：

$ rasen config profile      # 拡張ワークフローを選択
$ rasen update              # このプロジェクトに適用

これで段階的にスキャフォールドして構築できます：

あなた： /rasen:new add-2fa

AI：  rasen/changes/add-2fa/ を作成。作成の準備完了：提案。

あなた： /rasen:continue

AI：  proposal.md を作成。利用可能：仕様、設計。

あなた： /rasen:continue

AI：  specs/auth/spec.md を作成。利用可能：設計。

ランディング時に各成果物をレビューし、自由に編集してから、満足したら続行します。残りの計画を一度に起案したいとき、/rasen:ff は残りの計画成果物を高速化します。アーカイブの前に、/rasen:verify は実装が実際に仕様と一致することを確認します。Workflows を参照してください。

レシピ 7：全ループを手に学ぶ

使用する時期： rasen をインストールし、おもちゃの例ではなく、独自のコードでワークフローを 感じる したい場合。

拡張コマンドをオンに（レシピ 6 参照）してから：

あなた： /rasen:onboard

AI：  Rasen へようこそ！実際のコードベースを使用して、完全な変更をガイドします。
     一緒に安全な小さな改善を見つけるために、スキャンさせてください...

/rasen:onboard は実在する（小さな）改善を見つけ、それのための変更を作成し、実装し、アーカイブし、すべてのステップを説明します。15 〜 30 分かかり、保持または破棄できる本当の変更をあなたに残します。学ぶための最も穏やかな方法です。Commands を参照してください。

ターミナルからあなたの仕事をチェック

いつでも、ターミナルから、物事の状態を検査できます：

$ rasen list                      # アクティブな変更
$ rasen show add-dark-mode        # 詳細で 1 つの変更
$ rasen validate add-dark-mode    # 構造をチェック
$ rasen view                      # インタラクティブダッシュボード

これらは読んで検査するツール。提案と構築は引き続きチャットのスラッシュコマンドを介して行われます。完全な詳細は CLI reference にあります。

次へ行く場所

• Explore First：確信がない場合に開始するための推奨方法
• Workflows：上記のパターン、各パターンを使用する時期に関するガイダンス
• Commands：詳細にすべてのスラッシュコマンド
• Getting Started：規範的な最初の変更ウォークスルー
• Concepts：ピースが一緒に適合する理由