specrails-desktop 2.64.1 → 2.65.0

package/docs/guide/ja/insights/3-code-explorer.md

@@ -1,4 +1,4 @@
-# Code エクスプローラー
+# Code エクスプローラー {#code-explorer}
 
 **Code** セクションは、リポジトリをのぞける親しみやすい読み取り専用の窓を提供します — エディタに張り付かなくても、AI が何を作ってきたのかを理解したい人のために特別に設計されています。左にファイルツリー、右にコードビューア、そしてコードの上には、各ファイルが実際に何をしているのかを平易な言葉で説明した要約が表示されます。
 

package/docs/guide/ja/integrations/1-ai-providers.md

@@ -1 +1 @@
-# AI プロバイダー（Claude、Codex、、）
+# AI プロバイダー（Claude、Codex、、） {#ai-providers}

package/docs/guide/ja/integrations/2-plugins.md

@@ -1,4 +1,4 @@
-# プラグイン（Integrations）
+# プラグイン（Integrations） {#plugins}
 
 **Integrations** セクションは、AI にできることを広げる任意のアドオンを集めた、プロジェクトごとのマーケットプレイスです。どのプラグインを使うかは各プロジェクトが独立して決めます — あるプロジェクトにプラグインをインストールしても、ほかのプロジェクトには一切影響しません。
 

package/docs/guide/ja/integrations/3-jira-integration.md

@@ -15,7 +15,7 @@ Specrails は、Jira とプロジェクトのあいだの**同期レイヤー**
 
 ## ボードに接続する
 
-接続はプロジェクトの **Settings** ページから行います（Add Project ウィザードの最後にも、任意の「Configure Jira」ステップがあります）。接続ウィザードが次の手順を案内してくれます。
+接続は左サイドバーの **プラグイン** ページから行います。Jira カードの **インストール** をクリックし、プロジェクトを選んでください。接続ウィザードが次の手順を案内してくれます。
 
 1. **Test** — Jira の URL と認証情報を入力すると、Specrails が接続を検証します。
 2. **プロジェクトを選択** — 同期する Jira プロジェクトを選びます。
@@ -52,7 +52,7 @@ Jira のリンクは、ボード全体に対する「全部か無か」のグロ
 
 ## 日々の使い方
 
-接続すると、プロジェクトの Settings ページに**接続済みカード**が表示され、次のことができます。
+接続すると、**プラグイン** ページの Jira カードが **管理** に変わります。そこでプロジェクトを選ぶと**接続済みカード**が開き、次のことができます。
 
 - **Sync now** — タイマーを待たずに、その場で即時ポーリングを実行します。
 - **デッドレターの再試行** — 詰まってしまった書き戻しを再実行します。
@@ -69,4 +69,4 @@ Jira に裏付けられたスペックは、カードに **Jira キーバッジ*
 
 ## オフにする
 
-完全に元へ戻したくなったら、Settings から **Disconnect** するだけです。スペックはローカルのみの挙動に戻り、Jira のメタデータは使われないまま残るだけです — 何も破壊されません。
+完全に元へ戻したくなったら、接続済みカードから **Disconnect** するだけです。スペックはローカルのみの挙動に戻り、Jira のメタデータは使われないまま残るだけです — 何も破壊されません。

package/docs/guide/ja/integrations/4-mobile-companion.md

@@ -1,4 +1,4 @@
-# モバイルコンパニオン
+# モバイルコンパニオン {#mobile-companion}
 
 Specrails にはコンパニオンのスマホアプリがあり、デスクから離れているあいだもレールに目を配れます — ジョブが走るのを見て、終わるのを見届け、ダッシュボードの前に座っていなくても流れを把握できます。
 

package/docs/guide/ja/integrations/5-mcp-server.md

@@ -1,4 +1,4 @@
-# 任意の AI から Specrails を操作する（MCP サーバー）
+# 任意の AI から Specrails を操作する（MCP サーバー） {#mcp-server}
 
 > **For agents (English):** use the [current connection runbook](../../../agents/mcp.md) for Claude and Codex. It includes verified bridge discovery, registration and read-only checks.
 

package/docs/guide/ja/integrations/6-agent-chat.md

@@ -33,6 +33,8 @@ Agent Chat は組み込みの **Specrails MCP サーバー**を通じてアプ
 
 **観察**から始め、エージェントに動いてほしいときだけレベルを上げてください。現在のレベルを超えることを試みると、エージェントは止まり、どのレベルに切り替えればよいかを正確に伝えます——制限を回避することは決してありません。これは*外部*アシスタントを統制する 設定 ▸ MCP のティアとは別物で、ここのレベルはこのアプリ内エージェント専用です。
 
+**自律**への引き上げはキー操作だけでは行われません。「操作」から Shift+Tab を押すと **自律に切り替える** の通知が表示され、もう一度 Shift+Tab を押すと代わりに「観察」に戻ります。レベルを下げる操作は常に即時です。
+
 ## 頼めることの例
 
 **操作**にしたら、試してみてください。
@@ -47,16 +49,21 @@ Agent Chat は組み込みの **Specrails MCP サーバー**を通じてアプ
 
 返信は滑らかにストリーミングされ、整形済みで届き（見出し、表、リスト）、それぞれに小さな**コピー**ボタンが付きます。下部のステータスチップが、エージェントが今まさに何をしているか——*考え中…*、*MCP · jobs*、*Terminal*——を示すので、その状態が常に分かります。
 
+コードブロックには言語名と専用の**コピー**ボタンが表示されます。エージェントの書き込み中に上へスクロールすると、入力欄の上に **新しいメッセージ** のピルが現れ、クリックすると最新の返信に戻れます。
+
 ## 気の利いた工夫
 
 - **会話からスーパースペックを。** 一発生成ではなく、エージェントと一緒にスペックを*磨き上げて*みてください。まず実際のコードを読み、手短に質問し、進化していく下書きを会話内のライブカードとして表示します。あなたが承認するとスペックを作成し、デフォルトでバックグラウンドの **Contract Layer**（正確なファイルパス、データ形状、不変条件）で充実させるため、実装エージェントが即興に頼ることがなくなります。「contract layer なし」と言えば省略できます。
 - **言及されたものをクリック。** プロジェクトに固定されたミッションでは、エージェントの返信内のスペック番号（`#12`）やジョブ／実行の id はクリック可能なチップです——スペックはボードの詳細モーダルを、ジョブ id はライブのジョブビューを開きます。参照がもう存在しない場合は、控えめな「見つかりません」の通知が表示されます。
-- **実装カードは常に見える位置に。** エージェントがスペックを実装すると、ライブカードが作業を追跡します——あなたの判断（PR の作成、公開、再試行、破棄）を待っている間、カードは会話がどれだけスクロールしても**メッセージ欄のすぐ上にピン留め**されたままです。履歴上の元の位置には「上部にピン留め中」の控えめなマーカーが表示されます。複数のカードがアクティブな場合は小さなチップとして積み重なり（クリックで前面に表示）、シェブロンでカードを細いバーに最小化できます。PR が公開されるか、作業がマージまたは破棄されると、カードは会話履歴の元の位置に戻ります。
+- **実行はひとつのストリップに。** エージェントが作業を起動すると、メッセージ欄のすぐ上の 1 本のストリップがそれを追います。実行が今していることをわかりやすい言葉で（「変更から spec を作成中」）、完了した実行の数、経過時間、これまでの実コスト（プロバイダーが請求するまでは `—`）。実行があなたを必要とするとき（PR の作成、再試行、Flow に戻る）は、ストリップがアイコンと言葉で伝え、その 1 つの操作を表示します。ストリップをクリックすると、実行の完全なカードがすぐ上に開きます（Esc で閉じます）。複数の実行があるときは、あなたを必要としているものを先に表示し、小さな切り替え（「Rail 1 · Rail 2 · +1」）を添えます。会話には起きたことだけが残ります（「Rail 1 で起動しました」「Rail 1 が失敗：…」「納品済み：PR #812」）。各行はその実行を開きます。あなたの判断を待っているミッションには、ミッション一覧にドットが表示されます。新しい有料の実行を始める操作（**再起動**、**復旧して再試行**）や他の人に見える操作（PR の作成、公開）は、ストリップからは実行されません。そのボタンにフォーカスを置いてカードを開くので、確認はそこで行います。
+- **キーボードでストリップを操作。** **⌥R**（Windows/Linux では **Alt+R**）でメッセージ欄から、いま開いているミッションのストリップへ移動します。もう一度押すと実行の詳細を表示 / 非表示にでき、**Esc** で元の場所に戻ります。テキスト入力欄の外では **⌥[** と **⌥]** で実行を切り替えます。ストリップにフォーカスがある間は、**P** で Flow を一時停止 / 再開し、**H** で引き渡します。これらの文字キーはほかの場所では何もしません。一覧は **?** で表示できます。
 - **プロンプト履歴。** 入力欄が空のとき、**↑**/**↓** を押すと以前に頼んだ内容をたどれます（スクロール中は薄く表示されます）。入力を始めれば編集でき、Enter で送信できます。
 - **キューを編集。** エージェントが作業中にさらに送信しましたか？メッセージがキューにある間、**↑**/**↓** は*それら*の間を移動します——入力欄に選択したメッセージが表示され、その場で編集でき、**Enter でキューへ保存し直せます**（Esc でキャンセル。未送信の下書きはそのまま戻ってきます）。
+- **キーで回答。** エージェントが選択肢を出したとき、各チップには番号が付きます。入力欄が空の状態で **⌥1**…**⌥9**（Windows/Linux では **Alt+1**…**Alt+9**）を押すと選べます。
+- **削除したキューのメッセージを元に戻す。** キューのメッセージを削除すると数秒間 **元に戻す** が表示され、メッセージをキューに戻せます。
 - **最小化しても失わない。** ✕ をクリックするとパネルはバブルへ戻ります——会話はそのまま動き続けます。開き直すと最新のメッセージに着地します。何も打ち直す必要はありません。
 - **新しい会話。** **+** ボタンでまっさらなスレッドを始めます。履歴はアプリ全体にわたって存在し、個々のプロジェクトの上位にあります。
-- **ミッションの切り替え。** プロジェクトセレクターの隣にあるミッションセレクターは、会話を新しい順に一覧表示します — 点滅するドットはエージェントがまだ作業中の会話を示し、小さなバッジはキュー内のメッセージ数を表します。リストが 8 件を超えると検索欄が現れます。各行のゴミ箱アイコンは、行内のクイック確認のあとにミッションを削除します — 実行中のものでも可能です（先に警告し、その後エージェントを停止します）。
+- **ミッションの切り替え。** プロジェクトセレクターの隣にあるミッションセレクターは、会話を新しい順に一覧表示します — 点滅するドットはエージェントがまだ作業中の会話を示し、小さなバッジはキュー内のメッセージ数を表します。リストが 8 件を超えると検索欄が現れます。各行のゴミ箱アイコンは、ミッションをすぐに削除し、数秒間 **元に戻す**（または **⌘Z**）を表示します。その後、ミッションはプロジェクト設定の **最近削除した項目** に 30 日間残ります。エージェントがまだ作業中のミッションは、エージェントの停止を元に戻せないため、先に確認します。
 - **どこからでもミッションを探す。** **⌘K**（またはエージェントモードのサイドバーの **検索** ボタン）を押して、覚えている断片を入力してください——タイトルの単語でも、*中で話された内容* でも構いません。ミッションはまずメモリからタイトルで即座に一致し、一拍おいて内容による一致がハイライト付きで届き、固定されたプロジェクトと最終アクティビティも表示されます。エージェントモードではミッションが最初のグループ、ボードではプロジェクトの直後に並びます。Enter でミッションを開きます。
 
 ## 起動カードと実行カード
@@ -69,9 +76,9 @@ Agent Chat は組み込みの **Specrails MCP サーバー**を通じてアプ
 
 ## サブエージェント
 
-一部のプロバイダーは、タスクの一部を**サブエージェント**に任せられます。サブエージェントは並行して動き、エージェントが返信した後も作業を続けるヘルパーです。1 回の依頼のコストが大きく増えるため、サブエージェントは**既定でオフ**です。
+一部のプロバイダーは、タスクの一部を**サブエージェント**に任せられます。サブエージェントは並行して動き、エージェントが返信した後も作業を続けるヘルパーです。サブエージェントは**既定でオン**です。1 回の依頼のコストが大きく増えるため、コストを抑えたい場合はプロジェクトごとにオフにできます。
 
-- **プロジェクトごとにオンにする。** プロジェクトの**設定 → サブエージェント**を開き、**このプロジェクトでサブエージェントを許可**をオンにします。そのプロジェクトのミッション、探索、リファインに適用され、Implement パイプラインには一切影響しません。プロジェクトのないミッションは**アプリ設定 → AI プロバイダー → プロジェクトのないミッションでサブエージェントを許可**に従います。
+- **プロジェクトごとにオフにする。** プロジェクトの**設定 → サブエージェント**を開き、**このプロジェクトでサブエージェントを許可**をオフにします。そのプロジェクトのミッション、探索、リファインに適用され、Implement パイプラインには一切影響しません。プロジェクトのないミッションは**アプリ設定 → AI プロバイダー → プロジェクトのないミッションでサブエージェントを許可**に従います。
 - **実行するプロバイダーを選ぶ。** **サブエージェントの実行環境** の既定値 **ミッションのエージェントと同じ** では、ミッション自身の CLI がネイティブに起動します。最も速く、プロンプトキャッシュも共有されます。代わりにプロバイダー・モデル・エフォートを選ぶと、たとえば Codex のミッションで Claude のサブエージェントを使うなど、プロバイダーを組み合わせられます。すでにそのプロバイダーを使うミッションはそのモデルでネイティブのまま、別のプロバイダーでは Specrails が各サブエージェントを自ら起動します。コールドスタートでコストが増えることがありますが、より細かく制御でき、それぞれの実コストも表示されます。切り替え前に確認が表示され、これらのサブエージェントにはミッション内でプロバイダーのバッジが付きます。
 - **作業を見守る。** 返信が起動したエージェントは、その返信の下に 1 行のコンパクトな表示で現れます。作業中は開いたままで、すべて完了すると合計時間とトークンをまとめた 1 行に折りたたまれます。行を展開すると、結果とコストを読んだり、アクティビティをライブで追ったりできます。各起動は会話のその位置に残るため、後の起動が前のものと混ざることはありません。実行中のエージェントは行から停止でき、まとめての停止は要約行から行えます。
 - **エージェントは自分で続ける。** バックグラウンドのエージェントが終わると、エージェントは作業を続けて結果を投稿します。その投稿には「バックグラウンドエージェントの後に続行」と表示されます。

package/docs/guide/ja/integrations/8-flow-mode.md

@@ -0,0 +1,69 @@
+# Flow：まず作り、spec はあとで {#flow-mode}
+
+Flow は、まだ何が欲しいのかはっきりしないときにエージェントと一緒に作る方法です。ミッションでエージェントと話すと、エージェントは専用の Flow ブランチ（プロジェクトの別コピー）で実際のコードを書いて実行します。結果に納得したら **引き渡す** を押します。レールが変更を引き継ぎ、spec を導出し、いつもの検証・レビュー・納品を実行します。
+
+Implement はすでに説明できる作業を任せるためのもの。Flow はそれを見つけるためのものです。
+
+## Flow の始まり方
+
+Flow を名前で頼む必要はありません。探索的なことや見た目に関わること（「試してみたい…」「どんな見た目にすべきかわからない」）を説明すると、ミッションに 2 つの道を示すカードが表示されます。
+
+- **Flow**：今一緒に作る。spec は最後に。
+- **Spec + Implement**：先に spec を決めてから、レールに任せる。
+
+どちらの道も同じ重みで、常に同じ順番で表示されます。どちらも推奨されず、選ぶのはあなたです。**エージェントが尋ねた理由** では、エージェントが尋ねたきっかけを一文で説明し、どちらを選んでも、**今はしない** を押しても、しつこく勧めません。
+
+Flow を選ぶと確認が開きます。Specrails はプロジェクトの別コピーを専用の Flow ブランチに作成し、エージェントはそこでコードを書けます。メインブランチには触れません。**Flow を開始** を押します。ボードに **Flow 中** ラベル付きの仮の spec が表示されます（クリックするとミッションに戻ります）。
+
+Specrails Core がまだ Flow を実行できない場合、開始ボタンは無効になり、カードに足りないものが表示されます。たいていは Specrails Core を更新すれば解決します。
+
+## 既存のスペックから Flow を始める
+
+新しいアイデアだけでなく、どのスペックも Flow で作れます。Flow と Implement は、スペックに取り組む対等な 2 つの方法のままです。
+
+- ボードでスペックを右クリックし、**Flow で開始** を選びます（レールへのドラッグと並ぶ選択肢です）。スペックの詳細では、**Flow で開始** が **レールへ移動** の隣にあります。
+- ミッションでレールを指定せずにスペックの実装を頼むと、エージェントはそのスペックについて同じ 2 つの道のカードを表示します。**Flow** はあなたと一緒に作業し、**Spec + Implement** はレールで実行します。
+- スペックが 1 つだけのレール起動カードにも、起動の隣に **Flow で開始** があります。
+
+スペック自体が **Flow 中** になります。仮のスペックは作られず、エージェントの最初のターンにはそのスペック（受け入れ基準、Contract Layer、対象外の項目、未対応のアデンダ）が渡されます。ボードから始めると、Flow はスペック自身のミッション、またはスペック名の新しいミッションで開きます。複数の Git リポジトリを持つプロジェクトで、スペックがそのうちの 1 つだけを指定していない場合は、先に小さなダイアログで Flow の実行先を尋ねます。表示されるのは Git リポジトリだけで、スペックのリポジトリ（なければプライマリ）があらかじめ選ばれ、矢印キーで選択を変えられます。スペックがすでに Flow 中、完了またはキャンセル済み、レール上にある、または Flow を使えないときは、**Flow で開始** は無効になり、理由がツールチップに表示されます。
+
+**破棄** すると、スペックは以前のステータスのまま元どおりに戻ります。あなたのスペックが削除されることはありません。Flow が納品されると、スペックは作ったものから書き直されます。その前に元の本文がコメント **Original spec before Flow** として保存されるので、何も失われません。すでに Jira と連携しているスペックは同じ課題を更新し、レビューに対応するステータスへ移します。2 つ目の課題は作られません。
+
+## Flow の間
+
+Flow モード中であることは、目に入る場所に専用の Flow カラーで示されます。コンポーザーには自律度チップの隣に **Flow** チップとヒント *この Flow で何を変えるかエージェントに伝えてください…* が表示され、ミッションのタイトルとミッション一覧の行には **Flow 中** と表示されます。会話には Flow に入った位置と出た位置が示され、Flow 中に書かれたエージェントの返信には時刻の横に小さな **Flow** マークが付きます。
+
+コンポーザーのすぐ上のストリップには、Flow が短い 1 行で表示されます。状態、**Flow · 7 ファイル**、**Flow を一時停止**、そして主な操作の **引き渡す** です。操作が使えないとき（Flow がまだ保存中、別の操作を実行中）は、ホバーすると理由がわかります。ほかの実行と同じように矢印で行を開くと、残りが表示されます。
+
+- **ブランチ**（クリックで名前をコピー）、追加・削除行数付きの **変更**（クリックで変更されたファイルを状態と +/− 付きで一覧）、プロバイダーが請求した **これまでのコスト**。コストが報告されたターンがあるまでは `—` を表示し、見積もりは表示しません。`*` は価格のないターンを除いた合計を示し、その数を注記で示します。
+- Flow のアプリが動いている間の **プレビュー**（後述）。
+- 少し離して配置された **破棄** は、Flow の変更、そのブランチ、仮の spec を削除します。確認では失われるもの（+/− 付きの変更ファイル、ブランチ、spec）が一覧されます。
+
+**Flow を一時停止** はエージェントを止め、変更と spec を保持します。行には **Flow を再開** が表示されます。
+
+エージェントの作業中も書き込めます。Flow ではメッセージが現在のステップを **中断** し（送信ボタンが稲妻に変わります）、エージェントは新しい情報ですぐに続けます。Flow が開いている間、コンポーザー下の git ストリップは表示されません。Flow のパネルにブランチが表示されているためです。
+
+## アプリを試す
+
+Flow のエージェントは作業を確認するため、typecheck とテストを自分で実行します。試せるものがあると、**Start the app**、**Start and expose on the local network**、**Not now** の 3 つの選択肢で尋ねます。公開すると同じ Wi-Fi や VPN のスマートフォンからアプリを開けますが、そのネットワーク上の誰でもアクセスできます。
+
+アプリが待ち受けを始めると、エージェントがアドレスをリンクで示し、Flow のパネルに緑の点付きの **プレビュー** が表示されます。ブラウザーでアプリを開きます。メニューにはネットワークアドレスと **アプリを停止** があります。アプリはメインのチェックアウトではなく Flow のコピーから動き、Flow を一時停止・破棄・引き渡すと Specrails が停止します。
+
+## 引き渡す {#flow-hand-off}
+
+結果に満足したら **引き渡す** を押します。行は **PR にする準備ができました** に変わり、その上に 1 行だけ表示されます：*レール 2 が、あなたが変更した 7 個のファイルをレビュー済みの PR にします。失敗しても作業は失われません。* **起動** を押すか、**まだ** で Flow に戻ります。**Esc** は **まだ** と同じです。外側をクリックすると行がたたまれるだけで、ストリップは **起動** 付きの **PR にする準備ができました** のままです。会話のエンジンがこのマシンで引き渡しを実行できない場合は、行のすぐ下の注記にそう表示され、レールのデフォルトエンジンが使われます。
+
+レール、エンジン、モデル、エフォートはすでに選ばれています（空いているレールと会話のエンジン）。変更するには **方法を変更** を開きます。そこでは変更内容も確認できます。これまでのコストはメインの行に表示されます。**まだ** を押して後で引き渡し直しても、選んだ内容は保持されます。引き渡しの開始中、ストリップは途切れなく起動中を示し、その後は実行をステップごとに追います。レビュー上限や予算に達した場合は行にそう表示され、何も起動しません。45 秒たっても実行が表示されない場合、ストリップは回転を止め、**まだ Rail 2 に引き渡しています…** と **更新** を表示します。**更新** は再確認するだけで、実行が表示されるまで待ち続けます。
+
+レールは作ったものから spec とその spec の変更を導出し、検証・レビューを行い、ほかの実行と同様に納品カードがミッションに表示されます。
+
+技術的な理由で実行が失敗した場合、作業はそのまま自動的にこの Flow に戻ります。カードは何が失敗したかを平易な言葉で示し（コードは **技術的な詳細** に残ります）、エージェントがエラーを受け取って説明します。レビューで変更を求められた場合、カードは **Flow に戻る** または **再実行** を示します。納品が確定すると、ミッションは要約で Flow を閉じます。プルリクエスト、作ったものから書き直された spec、アーカイブされた spec の変更、そして Jira の課題（ある場合）です。
+
+## 知っておくと便利なこと
+
+- Flow は自分のブランチにのみ書き込みます。Flow の外ではミッションは読み取り専用のままです。
+- 1 つのミッションで同時に使える Flow は 1 つです。一時停止はアプリを再起動しても保持されます。
+- Flow のプロジェクトのコピーが消えた場合、Flow は **確認が必要** と表示され（お知らせのみで、決めることはありません）、何も削除されません。
+- ストリップは、見ている実行を勝手に切り替えません。その間に別の実行があなたを必要とすると、ストリップの切り替えにあるその名前に **対応待ち** と表示されます。
+- Flow 中や破棄した場合、Jira には何も送られません。
+- Flow のコストは分析画面で独自のサーフェス **Flow** として、またエージェントのミッションのブロック内に表示されます。

package/docs/guide/ja/pipeline/1-rails-and-jobs.md

@@ -37,13 +37,14 @@ SpecsBoard（左）            レール（右）
 | **Loop ピッカー** | このレールが実行する Loop — 組み込み（`Implement` / `Freestyle` / `SDD Quick (OpenSpec)`）かカスタム Loop。下の表を参照してください。レールごとに保持されます。 |
 | **▶ Play / ■ Stop** | 開始またはキャンセル。 |
 
-### レールが実行するもの: Loop
+### レールが実行するもの: Loop {#rail-loops}
 
 レールは **Loop** を実行します — それが作業のレシピです。2 つの Loop が **組み込み** で、よくあるケースをカバーします。
 
 | 組み込み Loop | コマンド | 役割 |
 |------|---------|--------------|
 | **Implement** | `/specrails:implement` | レール上のすべてのスペックをまとめた 1 つのジョブ。Architect → Developer → Reviewer → Ship のフルパイプラインを実行します。日常的に使うデフォルトです。 |
+| **Freestyle** | Freestyle | レールのプロバイダーがパイプラインを**使わず**に各スペックを自律的に実装し、その後 verification と Loop Decider がすべて通るまで仕上げます。スペックごとに独立した実行です。Claude、Codex、Gemini、Kimi、ローカルエンジンで動作します。ジョブ内のインタラクティブチャットは Claude のみです。 |
 
 複数のスペックを実行するには、関連するもの（最大 3 件）を 1 本のレールに載せる（`Implement` がまとめて 1 つのジョブとして実行します）か、独立したスペックを複数のレールに分けます。git 管理のレールはそれぞれ専用の分離された worktree で並行して動きます。
 
@@ -85,6 +86,25 @@ git のないプロジェクトでは worktree 隔離も PR 継続も使えま
 - **予算による自動一時停止** — 1 日の予算を設定しておけば、その日の支出が上限に達した時点でキューが自動で一時停止します。
 - **すべて** — デスクトップアプリを終了するか、`specrails-desktop stop` を実行します。
 
+## 未コミットの変更があるままローカル統合する
+
+**ローカルに統合** は、承認済みのデリバリーを PR なしでこのコンピューター上の統合ブランチ（例: `main`）にマージします。事前にチェックアウトをクリーンにする必要はありません。
+
+- 配信されたファイルに触れない未コミットの変更は、そのまま残ります。
+- 同じファイルに触れる変更がある場合、Specrails はそれを `specrails: before integrating #N (…)` という名前の git stash に保存し、統合してから元に戻します。通知には「ローカル変更を退避し、#N を統合してから元に戻しました。」と表示されます。
+- 元に戻す際に統合済みのコードと競合した場合、Specrails はブランチを統合したままの状態に保ち、**stash を残します**。何も失われません。カードには「ローカル変更は stash として保存されています」と競合ファイル、**変更を復元**（コードを変更した後などに再試行）、コピー可能な stash 名が表示されます。その後 Specrails 自身が、別の worktree 内の新しいブランチ `specrails/restore-local-<id>` で変更を復元します。そこで競合なく適用できればコミットし、できなければ AI 競合リゾルバーがその worktree 内だけで、あなたの意図と統合済みのコードの両方を保ちながら解決し、Specrails が結果をコミットします。カードには復元されたファイルが一覧表示され、**<ブランチ> に戻す** であなたのブランチに反映し（stash が削除されるのはこの時だけです）、**復元したブランチを破棄** でブランチを削除して stash は残します。ミッションには結果が伝えられるだけで、何かを実行する必要はありません。Specrails が生成する OpenSpec のスキルやコマンド（例: `.claude/skills/openspec-*/SKILL.md`）はあなたの変更として扱われず、競合時は統合版が維持されます。
+- 無視されたファイルは stash に入れません。それがデリバリーと衝突する場合は、先に移動するよう求められます。
+- 保存から復元までの間にアプリが停止した場合は、次にプロジェクトを開いたときに変更を復元します（同じブランチがチェックアウトされている場合のみ）。
+
+## 所要時間と費用の見込み {#launch-forecast}
+
+起動を押す前に、レールは同様の実行に通常どれくらい時間がかかるか、意味がある場合は通常の費用も表示できます。例：*同様の実行は通常 6～9 分 · $2～4*。
+
+この範囲は、あなた自身の履歴の中央半分です。このプロジェクトで同じループまたはコマンド、同じエンジンを使って完了した実行の 25～75 パーセンタイルです。比較できる実行が 5 件以上必要です。それまでは推測せず、*履歴がまだ足りません*と表示します。プロバイダーが報告した費用だけを使い、推定費用は含めません。これは見込みであり、請求額ではありません。
+
+ドル表示は、エンジンが従量課金だと分かっている場合（たとえば API キー）にだけ出ます。サブスクリプションプランの場合や、課金方式がまだ分からない間は、時間だけを表示します。レールに複数のスペックがあるときは、範囲は 1 つのスペックあたりで、*（スペックごと）*と表示されます。今日の支出に範囲の上限を足すと 1 日の予算に達する可能性がある場合は、*予算で一時停止する可能性があります*が加わり、予算設定へのリンクが表示されます。今日の予算をすでに使い切っているときは、リセットされるまで実行が一時停止するため、起動の前に確認が入ります。
+
+
 ## 次に読むもの
 
 - [Loop Builder](the-loop-builder) — レールが実行するもの、そして自分だけの Loop を作る方法。

package/docs/guide/ja/pipeline/2-the-job-detail-view.md

@@ -107,6 +107,18 @@ Architect ──► Developer ──► Reviewer ──► Ship
 
 実行内容を仲間と共有したり、正確なバグレポートを提出したりするのに便利です。
 
+## 実行が失敗したとき
+
+ジョブが失敗した、止まった、またはブロックされたとき、最終状態の先頭に**診断カード**が表示されます。何が起きたかを平易な言葉で示し（例：*Reviewer フェーズでテストが失敗しました（修正 4 回後）*）、アプリが把握している場合は理由も示します。
+
+- **テスト失敗**：修正ラウンドの後もチェックが失敗しています。
+- **プロバイダーの上限**：AI プロバイダーの利用上限に達しました。リセット時刻はプロバイダー自身の表現で示されます。
+- **環境**：マシンがチェックを実行できません（認証情報、不足しているツール、失敗する準備コマンドなど）。*環境を修復*は、実行または変更すべき内容を正確に示します。
+- **ブロック**、**時間切れ**、**動きが止まった**、**予期せず停止**は、実行を止めた上限やプロセスを示します。
+- **原因は不明**：アプリは推測しません。ログの末尾を表示するので、自分で確認できます。
+
+診断の下には、優先順に最大 3 つの対処が並びます。ここで実際に使えるものだけです：止まったフェーズから**再開**、**もう一度実行**、**スペックを編集して再起動**（スペックの追記が次の実行に変更を引き継ぎます）、**環境を修復**、**失敗箇所のログを開く**。同じ原因は[対応待ちリスト](../getting-started/the-dashboard-tour)で 1 行のラベルとして表示され、ミッションの実行カードにも同じカードが表示されます。
+
 ## 次に読むもの
 
 - [レールとジョブ](rails-and-jobs) — 起動とキューイング。

package/docs/guide/ja/pipeline/3-reviewing-a-delivery.md

@@ -0,0 +1,43 @@
+<!-- guide-revision: mission-first-v1 -->
+
+# アプリ内で納品をレビューする {#review-a-delivery}
+
+レビュー待ちの納品には 2 つの表示があります。**概要**（結論、根拠、判断ボタン）と**変更**（納品が実際に何を変えたか）です。納品の**レビュー**ボタンからレビューを開き、**変更**を選びます。
+
+## 変更を読む
+
+左のファイル一覧には、変更された各ファイルの状態（追加、変更、削除、名前変更）、`+` と `−` の行数、確認済みにしたときのチェックが表示されます。右の差分は 1 ファイルずつ読み込まれるため、大きな変更でも軽快です。**統合**と**並べて表示**のレイアウトを切り替えられ、Specrails は選択を記憶します。非常に大きなファイルは先頭の行を表示し、**ファイル全体の差分を読み込む**で続きを読み込めます。バイナリファイルはバイナリとして表示されます。
+
+変更は、納品がベースブランチから分岐した地点から測定されるため、その後ベースに入った内容は表示されません。納品にまとめたブランチがまだない場合は、どのスペックのブランチを読むか選べます。
+
+## コードに対するレビュアーのメモ
+
+レビュアーの指摘、示されたリスク、実行が解決するために起動されたレビューコメントは、対象の行の下に表示されます。ファイルも行も示していないメモはファイル一覧の上に並ぶため、何も隠れません。古い納品や、場所を示さなかったレビュアーの指摘は、この一覧に表示されます。
+
+## エージェントに変更を依頼する
+
+行番号をクリックして行を選び（Shift クリックで範囲を広げます）、**エージェントに変更を依頼**を選んで変更内容を書きます。Specrails はファイル、行範囲、選択したコードとともに、レビューフィードバックとしてスペックに保存し、スペックへのリンク付きのメッセージを表示します。そのスペックの次回の実行に反映されます。すぐ実行するには、概要の**変更を依頼**を使います。ここには人同士のコメントスレッドはありません。チームとの議論は GitHub で行ってください。
+
+## エディターで開く
+
+**エディターで開く**は、選択した行でファイルを VS Code、Cursor、または JetBrains IDE で開きます。エディターは**設定 → コード → エディター**で選べます。ファイルはお使いのプロジェクトのチェックアウトから開かれ、レビュー対象のブランチがそこでチェックアウトされていない場合があります。
+
+## 納品物をどうするか選ぶ {#pr-decision}
+
+完了した実行が尋ねるのは一つだけ、その結果をどうするかです。カードには次のステップ（PR の作成、公開、確認）のメインボタンが一つあり、その隣の **レビュー** で分かりやすいレビューパケットを開けます。そのほかの操作は **その他の操作** にまとめられています。
+
+- **ブランチをチェックアウト** はブランチをプロジェクトフォルダーに置き、試せるようにします。
+- **ローカルに統合** は、このコンピューター上で結果をベースブランチにマージします。GitHub は不要で、事前に確認が入ります。
+- **破棄** は結果とそのブランチを削除します。事前に確認が入ります。
+
+操作が失敗すると、通知で何ができなかったかが示され、**再試行** を選べます。
+
+## キーボード
+
+| キー | 操作 |
+| --- | --- |
+| `j` / `k` | 次 / 前の変更ファイル |
+| `n` / `p` | 次 / 前のレビュアーのメモ |
+| `v` | ファイルを確認済みにする |
+
+入力欄に入力している間、これらのキーは無視されます。確認済みの印はあなただけのものです。後のリビジョンでファイルが変わると**確認後に変更されました**と表示され、再び未確認として数えられます。

package/docs/guide/ja/pipeline/4-picking-an-engine-per-rail.md

@@ -1,4 +1,4 @@
-# レールごとのエンジン選択
+# レールごとのエンジン選択 {#provider-capabilities}
 
 ## セレクターが現れるとき
 
@@ -19,7 +19,7 @@
 | エンジン | こんなときに | 補足 |
 |--------|--------------------|-------|
 | **Claude** | native cost、persistent interaction、strict tool policy が必要。 | Profile、Freestyle、structured transform。 |
-| **Codex** | OpenAI Codex CLI を好むとき、あるいはプロバイダー間で実装を比べたいとき。 | `codex` ≥ 0.128.0。ネイティブのコスト報告なし — アプリが料金表からコストを補います。プロファイルは適用されません。 |
+| **Codex** | OpenAI Codex CLI を好むとき、あるいはプロバイダー間で実装を比べたいとき。 | `codex` ≥ 0.128.0。ネイティブのコスト報告なし — アプリが料金表からコストを補います。プロファイルは適用されません。Freestyle はインタラクティブチャットなしで動作します。 |
 
 ## 実用的なワークフロー
 

package/docs/guide/ja/pipeline/5-the-loop-builder.md

@@ -1,4 +1,4 @@
-# Loop Builder
+# Loop Builder {#loop-builder}
 
 ## Core ワークフロー
 

package/docs/guide/ja/settings/1-themes.md

@@ -1,4 +1,4 @@
-# テーマ
+# テーマ {#themes}
 
 Specrails を、あなた好みの見た目に。アプリには丁寧に調整された 5 つのテーマが標準で用意されていて、いつでも一瞬で切り替えられます。再起動も、リビルドも、面倒な設定もいりません。
 

package/docs/guide/ja/settings/3-pipeline-telemetry-and-diagnostics.md

@@ -1,4 +1,4 @@
-# パイプラインテレメトリと診断
+# パイプラインテレメトリと診断 {#telemetry}
 
 テレメトリはパイプラインの診断情報をローカルに記録します。設定が保存されていないプロジェクトでは**デフォルトでオン**です。プロジェクトごとにオフにでき、明示的に保存された設定は維持されます。
 
@@ -20,7 +20,7 @@
 
 ### 対象となるもの
 
-テレメトリの対象は **パイプラインジョブ**（キューに入った Architect → Developer → Reviewer → Ship のレール実行）です。チャットやセットアップウィザードのような対話的なセッションは、あえて対象外にしています。テレメトリは、繰り返し実行できて検証できるパイプライン実行のためのもので、一度きりの会話のためのものではないからです。
+テレメトリの対象は、プロジェクトの**ジョブキュー**を通るジョブです。つまり CLI パイプラインの実行（Loops が無効なときのレールと、`specrails-desktop` CLI から送られた `implement` コマンド）です。ループ実行（レールのデフォルトの実行方式）や、チャット、Explore、ミッションのような対話的なセッションは計測されません。
 
 ## データの保存先
 

package/docs/guide/ja/settings/5-project-environment.md

@@ -1,4 +1,4 @@
-# プロジェクト環境
+# プロジェクト環境 {#project-environment}
 
 プロジェクトによっては、プライベート npm パッケージ用の `NODE_AUTH_TOKEN` のように、実行時に認証情報が必要です。**プロジェクト設定 → 環境** で、rail と loop が必要とする変数の**名前**を追加します。Specrails が保存するのは名前だけで、値は保存しません。
 

package/docs/guide/ja/settings/6-updates.md

@@ -0,0 +1,24 @@
+# アップデート {#updates}
+
+Specrails は 2 つのものを最新に保ちます。**Specrails Desktop** アプリ本体と、プロジェクトが使う **specrails-core** フレームワークです。どちらも **設定 ▸ 更新** にあります。
+
+## アップデートチャネル
+
+新しいバージョンを受け取るタイミングを選べます。
+
+- **最新**（既定）：リリースされたらすぐに受け取ります。新機能と修正をいち早く使えます。
+- **安定版**：最新チャネルで 1 週間以上 CI が成功し続け、その後メンテナーが昇格したリリースだけを受け取ります。更新の回数を減らし、十分に検証された版を使いたいチーム向けです。
+
+チャネルはアプリと specrails-core の両方に適用されます。specrails-core にまだ安定版がない場合、Core は当面最新に従い、Core カードにその旨が表示されます。
+
+安定版でまだ昇格済みのリリースがない場合、**アップデートを確認** は最新の版を提示せず、その旨を表示します。
+
+## アップデートの届き方
+
+- **Specrails Desktop** は起動時と 6 時間ごとに確認します。アップデートがあるとカードが表示され、そこからダウンロード、インストール、再起動ができます。**アップデートを確認** をクリックしても確認できます。
+- **specrails-core** が自動で更新されることはありません。Core カードの **アップデートを確認** をクリックし、続けて **（バージョン）に更新** でインストールします。アプリを再起動せずに、プロジェクトが新しいフレームワークへ切り替わります。
+
+## 知っておくと便利
+
+- 最新から安定版に切り替えてもダウングレードはしません。安定版が追いつくまで現在のバージョンのままです。
+- どちらのチャネルでも、すべてのアップデートはインストール前に署名が検証されます。

package/docs/guide/ja/settings/7-existing-projects.md

@@ -0,0 +1,33 @@
+# 既存プロジェクトでの作業 {#existing-projects}
+
+これらの機能は、既存プロジェクトを実行が尊重するのを助けます。スペックが対象外とすること、計画前のアーキテクトの質問、テストが実際に実証する要件、変更前に既存コードを記述する方法、そしてチームが既に書き留めているルールです。各機能には対応する specrails-core のバージョンが必要です。それまでは、Core の更新を促す注記付きでスイッチがグレー表示されます。
+
+## 対象外
+
+各スペックには、意図的に変更**しない**ことを列挙できます。Quick と Explore が自動で記入します。スペックのウィンドウでは説明の下に **対象外** として 1 行に 1 項目で表示され、他の項目と同様に編集できます。エージェントは起動のたびにスペックとともにこれを受け取ります。
+
+## Jira でのアーキテクトの質問
+
+**設定 ▸ 既存プロジェクトへの定着** で **アーキテクトの確認事項を Jira に投稿** をオンにします。アーキテクトの回答待ちで実行が止まったとき、または前提を置いて続行したとき、Specrails はそれらをリンクされた Jira 課題に 1 件のコメントとして投稿します。Jira でそのコメントに返信すると、返信は確認事項としてスペックに追加され、次回の実行で読み込まれます。一時停止した実行にはアプリからも回答できます。
+
+## 実証済みの要件
+
+テストが実証する要件をタイトルで示すと（`[spec:<ケイパビリティ>/<要件>]`）、レビューページに **実証済みの要件 X/Y** が表示されます。成功したテストが実証する要件、まだテストがない要件、変更自体が触れた要件がわかります。分析画面ではループごとに同じ情報を表示します。変更された要件にテストがない場合に CI を失敗させるには、テストの後に `specrails-core pipeline trace --check --tests-passed` を追加します。
+
+ループライブラリには **ドリフト検査** もあります。各スペックの記述とコードの動作を比較し、矛盾をすべて一覧表示する読み取り専用のループで、何も変更しません。
+
+## 変更時のベースライン
+
+**変更時のベースライン** をオンにすると、どのスペックにも記述されていないコードに変更が及ぶ場合、まずそのコードを記述します。変更前のコードで実証した現在の動作のテストと、既存部分の短いスペックです。レビューページには、モジュール、要件、テストとともに **作業が触れた箇所にスペックを作成** が表示され、そのコストは変更とは別に示されます。変更前のコードでそれらのテストが失敗した場合、実行はモジュールを編集する前に停止し、その旨を示します。
+
+## プロジェクトルール {#project-rules}
+
+**設定 ▸ プロジェクトルール** には、プロジェクトが既に実行しているチェック（lint、型、テスト、CI）と、`CLAUDE.md` や `AGENTS.md` などに書かれた各ルールが次のように分類されて表示されます。
+
+- **適用済み**：既にチェックで保証されています。
+- **自動化可能**：チェックで保証できます。**スペックを作成** で 1 クリックでスペックにできます。
+- **人による確認のみ**：誰かが確認する必要があります。各レビューページの **人の目による確認が必要** に表示されます。
+
+Core がまだ分類できていないルール（たとえばプロジェクト追加直後、インベントリがオフラインで実行された場合）は **未分類** と表示されます。プロバイダーを設定して **インベントリを再実行** すると分類されます。
+
+**インベントリを再実行** で一覧を更新します。プロジェクトにまだ検証コマンドがない場合、エージェントランタイム設定でこれらのチェックが最初に提案されます。

package/docs/guide/ja/settings/8-accessibility.md

@@ -0,0 +1,23 @@
+# アクセシビリティとカスタマイズ {#accessibility}
+
+Specrails はあなたの作業スタイルに合わせて調整できます。すべて**設定 ▸ 外観**にあり、すぐに反映され、このコンピューターに保存されます。
+
+## 表示密度 {#density}
+
+**ゆったり**はカードと行に余裕を持たせます。**コンパクト**は画面に多く表示します。スペックボードはコンパクトな行で始まり、ジョブ一覧は行間が詰まり、ジョブのストーリーはタイムラインが詰まります。保存したボードビューは独自のレイアウトを保つため、付箋カードで保存したビューは引き続き付箋カードで開きます。 このプロジェクトのボードが独自のレイアウトを持っている場合は、選択肢の下の **ボードにも適用する** で再び密度に従わせられます。
+
+## 視覚効果を減らす {#reduce-motion}
+
+**システムに従う**はOSの設定を尊重します。**減らす**は、OSの設定に関わらず Specrails 内のアニメーションとトランジションをオフにします。レールのピルは所定の位置で止まり、ライブドットの点滅は止まり、Builder のハローとテーマエフェクトも静止します。**フルモーション**は、OSが控えめを求めていてもアニメーションを表示します。
+
+## キーボードでスペックを移動 {#keyboard-moves}
+
+ボード上のスペックカードにフォーカスし(Tab または矢印キー)、**M** を押します。小さな選択画面にステータスとレールが並ぶので、矢印キーと **Enter** で選びます。カードをそこへドラッグするのと同じ動作で、Jira 連携のスペックは Jira のワークフロー経由で移動します。カードが複数選択(**X** でフォーカス中のカードを選択)に含まれている場合は、選択中のすべてのスペックに適用されます。コマンドパレットの**フォーカス中のスペックを移動…**でも同じ操作ができます。入力欄に入力している間は **M** は何もしません。
+
+## スクリーンリーダー向けの実行状況の通知 {#live-status}
+
+Specrails は、表示中のプロジェクトについて実行の変化を丁寧なライブリージョンで通知します。実行の開始、一時停止、対応が必要、失敗、完了、レビュー準備完了です。続けて起きた変化はまとめられ、重複は除かれるので、忙しいレールでもスクリーンリーダーがあふれることはありません。元に戻す通知はすでに自動で読み上げられます。
+
+## キーボードフォーカス {#focus}
+
+キーボードで到達したすべてのボタン、リンク、メニュー項目、カード、ツリー行に、見えるフォーカスリングが表示されます。レールのストリップにあるスペック参照のように、以前はツールチップにしかなかった情報も、キーボードやスクリーンリーダーで利用できます。

package/docs/guide/ja/specs/1-specs-and-the-backlog.md

@@ -1,4 +1,4 @@
-# スペックとバックログ
+# スペックとバックログ {#specs-backlog}
 
 **スペック**は、AI パイプラインが実装する作業の単位です。チケットのようなものだと考えてください。タイトル、やってほしいことの説明、優先度、そして任意のラベルで構成されます。パイプラインを起動すると、AI エージェントたちがこのスペックを読んでそれに沿って動きます。つまり、わかりやすいスペックこそが、よい結果を生むための一番大切な入力なのです。
 
@@ -13,7 +13,27 @@
 - **付箋表示**（デフォルト）— 短い概要が添えられたカード形式のタイル。
 - **リスト表示** — 1 行ずつのコンパクトな表示。
 
-ツールバーの**ステータスセレクター**は、各ステータスをライブカウント付きの独立したチップとして表示します。さらに 2 つのスマートグループがあります：**アクティブ**（デフォルト — まだ動いているものすべて：下書き、Todo、進行中、レビュー中）と**すべて**（全部を表示し、完了は一番下に固定）。選択はプロジェクトごとに記憶され URL にも反映されるため、リロードや共有リンクでもまったく同じビューが復元されます。Jira に接続したプロジェクトでは、さらに **Jira ステータス**のドロップダウンが現れ、ボードの*実際の*ワークフローステータス（生の名前、例：「Code Review」、それぞれライブカウント付き）を、対応する状態ごとにグループ化して一覧します — ステータスチップと組み合わせて使えます。さらに**ラベル**で絞り込んだり、**デフォルト**・**チケット #**・**優先度**で並べ替えたり（それぞれ昇順／降順を切り替え可能）できます。
+スペックのツールバーは 2 段構成です。1 段目には**検索**フィールド（`/` キーで移動。タイトル・`#番号`・ラベル・Jira キーで検索）、ひとつにまとまった**フィルター**ボタン、並べ替えと表示の切り替え、そして**新規スペック**があります。2 段目は**ステータスセレクター**です。各ステータスがライブカウント付きの独立したセグメントとして並び、さらに 2 つのスマートグループがあります：**アクティブ**（デフォルト。下書き・Todo・進行中・レビュー中など、まだ動いているものすべて）と**すべて**（全部を表示し、完了は一番下に固定）。列が狭いときは使用頻度の低いステータスが**その他**メニューにまとまり、選んだステータスは常に表示されたままです。選択はプロジェクトごとに記憶され URL にも反映されるため、リロードや共有リンクでもまったく同じビューが復元されます。**フィルター**を開くと、項目ごとのセクションを持つパネルがひとつ表示されます：**ラベル**（複数選択）と、Jira に接続したプロジェクトでは**エピック**・**スプリント**・**Jira ステータス**（ボードの*実際の*ワークフローステータス。例：「Code Review」。対応する状態ごとにグループ化され、ステータスセレクターと組み合わせて使えます）。検索やフィルターでボードを絞り込んでいる間は、3 段目に各条件が解除可能なチップとして並び、「y 件中 x 件」の表示と**すべてクリア**（選んだステータスは維持）が出ます。並べ替えは**デフォルト**・**チケット #**・**優先度**から選べ、それぞれ昇順／降順を切り替えられます。
+
+### 複数のスペックを選択する
+
+スペックを1件ずつではなく、まとめて仕分けできます。フォーカス中のカードで `x` を押す、カードを `Ctrl`/`⌘` + クリックする、または `Shift` + クリックで範囲を選択します(範囲は1つの列の中に限られます:アクティブなスペック、または完了のまとまり)。`Ctrl`/`⌘` + `A` で今いる列をすべて選択し、`Esc` で選択を解除します。カードにはホバー時やフォーカス時にチェックボックスが表示され、選択したカードは枠が強調されます。検索欄に入力している間は、これらのキーは働きません。
+
+スペックを1件でも選択すると、ボードの下部に件数と操作のバーが浮かびます。
+
+- **移動先**:ステータスを変更します。ローカルのスペックにはローカルのステータス、Jira 由来のスペックには Jira ボードの実際のワークフローステータスが使われ、単独の移動と同じ Jira キューを通ります。
+- **ラベル**:選択したスペックにラベルを追加するか、付いているラベルを外します。
+- **優先度**:すべてに同じ優先度を設定します。
+- **レールに追加**:選択したスペックをレールに載せます。
+- **すべて起動**:選択した各スペックに空いているレールを1つずつ割り当て、並行して起動します。レールの*すべて起動*と同じ確認と1日の予算チェックを経ます。まだ起動できないスペック(たとえば、PR がないままレビュー中のもの)や、空きレールが見つからないスペックはスキップされ、結果の通知で件数が示されます。
+- **削除**:*最近削除したもの*に移します。
+- **選択解除**(または `Esc`):選択を取り消します。
+
+削除、およびステータス・ラベル・優先度の変更は、1回の操作で元に戻せます。*元に戻す*の通知(または `⌘Z`)1つで、変更したすべてのスペックが復元されます。一部が失敗した場合は、成功した件数と失敗した件数が1つの通知で示されます。選択に含まれるのは見えているスペックだけです。選択中のスペックをフィルターが隠すと、その選択は外れます。
+
+### 保存したビュー
+
+**フィルター**の隣にある**ビュー**ボタンは、今のボードの状態(ステータスの選択、フィルター、並び順、表示密度。検索文字は含みません)を保存します。**現在のビューを保存…**を選び、名前(「起動準備完了」「スプリント42」「今週失敗したもの」など)を付けると、あとから同じメニューで選べます。**ビューを管理…**では、名前の変更、現在のボードでの更新、リンクのコピー、削除ができます。ビューはプロジェクトごとに保存されます。コピーしたリンク(`?view=…`)は、このアプリで開くとそのビューを適用します。コマンドパレット(`⌘K`)からも、現在のビューの保存や別のビューへの切り替えができます。
 
 ## ステータス
 
@@ -38,7 +58,7 @@
 
 ## スペックを作成する
 
-スペックを作成するには、**追加**（SpecsBoard ツールバーのプラスボタン）をクリックします。**スペックを追加**ダイアログが開き、いくつかの方法から選べます。
+スペックを作成するには、**新規スペック**（SpecsBoard ツールバーのプラスボタン）をクリックします。**スペックを追加**ダイアログが開き、いくつかの方法から選べます。
 
 - **クイックモード** — やりたいことを記述すると、AI が一発でスペック全文を書き上げます。[スペックを追加 — クイックモード](add-spec-quick-mode.md)を参照。
 - **Explore モード** — AI と対話しながら、ターンを重ねてスペックを形にしていきます。[スペックを追加 — Explore モード](add-spec-explore-mode.md)を参照。
@@ -50,6 +70,24 @@
 
 スペックにすでに成果物（レビュー中の PR、マージ済みの機能）があり、*さらに*何かを求めるときは、説明文を書き直さないでください。スペックの本来の意図がぶれ（そのぶれが Jira にも同期され）、次回の実行がすべてを再計画してしまいます。代わりにスペックを開いて**補足**を追加します。種類（変更依頼、レビューフィードバック、明確化、制約）とあなた自身の言葉による短いメモです。未処理の補足は、Implement・SDD Quick・Freestyle などどのループでも、そのスペックの次回起動に自動的に同行し、実行はあなたが求めたことだけを変更します。レビューパケットは各補足を「適用済み / 一部適用 / ブロック」として報告します。実行が失敗したり納品を破棄したりすると、補足は自動的に**未処理**に戻ります。既存スペックの変更をミッションエージェントに頼めば、エージェントが補足を追加してくれます。
 
+## 納品物をレビューする — 最初に確認すべき点
+
+実行が終わると、レビューパケットは **確認すべき点** から始まります。AI レビュアーによる短い概要で、最もリスクの高い箇所を先に（高・中・低の順に、それぞれファイルと行付きで）挙げ、変わる動作、変更が依存するルール、どのテストも通らないコードパス、人にしかできない確認を示します。同じリスク、テストされていないパス、確認項目はプルリクエストの冒頭にも短くまとめられ、ミッションカードには最大のリスクが 1 行で表示されます。概要はレビューの手がかりであり検証結果ではないため、承認をブロックすることはありません。古い Specrails Core で実行したものには概要がなく、パケットはこれまでどおり表示されます。
+
+## 元に戻す、そして最近削除した項目 {#recently-deleted}
+
+スペックの削除、ステータスの移動、ラベルの変更、レールからの取り外しは、すぐに反映されます。事前に「よろしいですか？」と尋ねることはありません。代わりに、約 8 秒間、トーストに **元に戻す** が表示され、フィールドに入力していなければ **⌘Z**（Windows と Linux では **Ctrl+Z**）でも同じ操作ができます。元に戻す操作はプロジェクトごとです。プロジェクトを切り替えると、その時間枠は閉じます。
+
+削除したスペック（とミッション）は消えません。プロジェクト設定の **設定 → 最近削除した項目** に移り、30 日間は **復元** または **完全に削除**（こちらは確認があります）ができます。30 日を過ぎると完全に削除されます。未プッシュの作業の破棄、プルリクエストの強制クローズ、プロジェクトの削除は元に戻せないため、引き続き確認が出ます。Jira に紐づくスペックは、削除ではなく従来どおり **移動先** で扱います。
+
+## スペックのタイムラインと引き継ぎ {#spec-timeline}
+
+スペックを開いて **タイムライン** タブに切り替えると、その経緯を一か所で読めます。編集と補足、関与したミッション、各実行とそのフェーズやエージェント操作、プルリクエストのイベント、レビュアーの判定と指摘が並びます。項目は日ごとにまとまり、チップで種類を絞り込め、各項目は元のミッション・実行・レビューへのリンクを持ちます。長いまとまり（フェーズ、エージェント操作、ミッションのターン）は件数付きで折りたたまれ、その場で展開できます。
+
+コストはそれを使った項目の横に表示され、2 種類は分けて扱われます。プロバイダーが報告した金額と、ローカルの料金表から推定した金額（「推定」と表示）です。プラン課金のプロバイダーでは、タイムラインとエクスポートはドルではなくターン数を表示します。コストを報告しなかった実行には何も表示されません。
+
+**引き継ぎをエクスポート**（タブの横のメニュー、または ⌘K → *#N の引き継ぎをエクスポート*）は、概要、決定事項（補足、確認事項、レビュアーの判定）、差分の統計、コスト、未対応の項目（未処理の補足と未解決のレビュー指摘）を含む Markdown ファイルまたは単体の HTML ページを書き出します。**PR の説明としてコピー**（⌘K からも可能）は、短い Markdown 版をクリップボードに入れます。見出しはアプリの言語に従います。内容はすべて、エージェント操作の監査と同じ機密情報の伏せ字処理を通り、何かが伏せられた場合は通知でお知らせします。
+
 ## 次はこちら
 
 - [スペックを追加 — クイックモード](add-spec-quick-mode.md) — アイデアを最速でスペックにする方法。

package/docs/guide/ja/specs/2-add-spec-quick-mode.md

@@ -6,7 +6,7 @@
 
 すばやくスペックを作成するには、次の手順で進めます。
 
-1. ダッシュボードで**追加**（SpecsBoard ツールバーのプラスボタン）をクリックします。
+1. ダッシュボードで**新規スペック**（SpecsBoard ツールバーのプラスボタン）をクリックします。
 2. **クイック**モードを選びます。
 3. テキスト欄にアイデアを入力します。一文でも一段落でも、伝わればかまいません。
 4. クリックして生成します。

package/docs/guide/ja/specs/3-add-spec-explore-mode.md

@@ -22,7 +22,7 @@ Explore モードでスペックを形にするには、次の手順で進めま
 
 これこそが Explore モードの核心です。真っ白なフォームを前に固まることはありません。いつでも、進化していく本物のスペックを眺めながら進められます。
 
-## AI が見える範囲：コンテキストスライダー
+## AI が見える範囲：コンテキストスライダー {#context-scope}
 
 AI が答える前に、プロジェクトのどこまでを AI に見せるかをあなたが決めます。コンテキストプリセットスライダーで、速度と深さのバランスを調整できます。
 

package/docs/guide/pt/agents/1-meet-the-agents.md

@@ -1,4 +1,4 @@
-# Conheça os agentes
+# Conheça os agentes {#agents}
 
 Quando lança um rail de **Implement**, o Specrails não entrega a sua spec a uma única IA na esperança de que tudo corra bem. Em vez disso, põe a trabalhar uma pequena equipa de *agentes* especializados, cada um com uma tarefa, numa ordem bem pensada. Esta página apresenta quem faz parte dessa equipa e o que cada um faz.
 

package/docs/guide/pt/getting-started/2-installing-and-first-run.md

@@ -39,3 +39,5 @@ Vai ver:
 É todo o processo de arranque — sem conta para criar, sem registo. O specrails funciona inteiramente na sua máquina.
 
 Clique em **Adicionar o seu primeiro projeto** e continue para [Adicionar o seu primeiro projeto](adding-your-first-project).
+
+Ou começa com o [projeto de exemplo](try-the-sample-project): um pequeno jogo e três specs já escritas, com o custo indicado de antemão.