インスペクタ編集モード(セッション スコープ)
ルールセッション スコープのステートフルなインスペクタ編集モードを確立し、React コンポーネントとそれに対応する分離された開発インスペクタを、セッション間の汚染なしに共同で保守できるようにします。
このルールにアクセスするにはログインしてください
Google デベロッパー プロフィールでログインすると、Build It! シリーズで使用されているルール全体を表示してコピーできます。
デベロッパー プロフィールが必要です
デベロッパー プロフィールは無効です。この機能を有効にするよう、Workspace 管理者に連絡してください。
デベロッパー プロフィールを作成する
無料の Google デベロッパー プロフィールを作成して、Build It! のすべてのスキル、ルール、プロンプト、アーティファクトを利用できるようにしましょう。
Builder Central に参加して利用する
ワンクリックで無料の Builder メンバーシップ バッジを取得して、Build It! のすべてのスキル、ルール、プロンプト、アーティファクトをアンロックしましょう。
セッション スコープのインスペクタ編集モードの仕組み
コンポーネント インスペクタを開いた状態で UI コンポーネントを反復処理する場合、コンポーネントの編集によって、一致するインスペクタ ビューが同じターンで更新されるようにする必要があります。今後のセッションでインスペクタの編集を永続的に強制する必要はありません。このルールでは、会話スコープのマーカー ファイルを使用してこの問題を解決します。
- 新しいセッションごとにデフォルトでオフ: 新しい会話は通常モードで開始されるため、日常的な編集では、リクエストしたファイルのみが対象となります。
- インスペクタ編集モードに入る: 「インスペクタ編集モードに入って」(または「インスペクタ モードをオンにして」)と言います。エージェントは、
<appDataDir>/brain/<conversation-id>/inspector-mode.activeにセッション スコープのマーカー ファイルを作成し、src/dev/registry.tsを読み取り、このセッションの対象となる登録済みコンポーネントをすべて一覧表示します。 - 自動共同メンテナンス: 有効にすると、登録済みコンポーネントに対してリクエストした変更は、まずコンポーネントを更新し、コンポーネント インスペクタ アップデータ ワークフローを使用して、一致する
src/dev/inspectors/[ComponentName]Inspector.tsxをすぐに同期します。その後、npx tsc --noEmitを実行し、確認チップをレスポンスにスタンプします。 - いつでもクリーンに終了: 「Exit inspector editing mode」と入力すると、マーカー ファイルが削除され、通常の単一ターゲット編集モードに戻ります。あるセッションでこのモードをオンにしても、並行セッションや将来のセッションには影響しません。
Google Antigravity にインストールする方法
このルールを、エピソード 9 の 2 つのコンポーネント インスペクタ スキルとともに、Google Antigravity ワークスペースに配置します。
- プロジェクト ワークスペースに
.agents/rules/フォルダを作成します(または、Google Antigravity の [Customizations] > [Rules] を開いてワークスペース ルールを追加します)。 - 以下の Markdown ルール全体を
.agents/rules/内にinspector-editing-mode.mdとして保存します。 - コンパニオン スキル Component Inspector Generator と Component Inspector Updater をインストールして、エージェントがこのルールで参照されるスキャフォールディング ワークフローと同期ワークフローの両方を使用できるようにします。
インスペクタ編集モードのルール定義
この完全なルール定義を inspector-editing-mode.md としてワークスペースにコピーします。
inspector-editing-mode.md (.agents/rules/inspector-editing-mode.md)
# Inspector Editing Mode (Session-Scoped)
This rule establishes a stateful, session-scoped **Inspector Editing Mode** for co-maintaining React components and their corresponding isolated development inspectors (`src/dev/inspectors/[ComponentName]Inspector.tsx`).
---
## 1. Scope & Isolation Model
* **Session-Scoped**: The on/off state of this mode is strictly scoped to the current conversation session (`<conversation-id>`).
* **Default State**: Every new conversation session begins with Inspector Editing Mode **OFF** by default.
* **State Marker**:
- Activation is tracked at `<appDataDir>/brain/<conversation-id>/inspector-mode.active`.
- If this file exists for the active session's conversation ID, Inspector Editing Mode is **ON**.
- If this file does NOT exist, Inspector Editing Mode is **OFF**.
* **Zero Cross-Session Contamination**: Turning this mode on in one conversation has no effect on any other parallel or future conversation sessions.
---
## 2. Trigger Commands & State Transitions
### A. Entering Inspector Mode
* **Trigger Phrases**:
- *"Enter inspector editing mode"*
- *"Start inspector editing mode"*
- *"Turn on inspector mode"*
- *"Inspector mode on"*
* **Agent Action**:
1. Create the marker file at `<appDataDir>/brain/<conversation-id>/inspector-mode.active`.
2. Read `src/dev/registry.ts` to identify all currently registered components.
3. Respond confirming:
- Inspector Editing Mode is now **ACTIVE** for this session.
- Any subsequent changes to registered components will automatically update both the component and its dev inspector.
- List the currently registered components covered by this mode.
### B. Exiting Inspector Mode
* **Trigger Phrases**:
- *"Exit inspector editing mode"*
- *"Stop inspector editing mode"*
- *"Turn off inspector mode"*
- *"Inspector mode off"*
* **Agent Action**:
1. Remove the marker file at `<appDataDir>/brain/<conversation-id>/inspector-mode.active` if present.
2. Respond confirming that Inspector Editing Mode is now **DEACTIVATED** for this session and normal single-target editing has resumed.
### C. Status Query
* **Trigger Phrases**:
- *"Is inspector mode active?"*
- *"Inspector mode status"*
- *"What mode am I in?"*
* **Agent Action**:
- Check for the existence of `<appDataDir>/brain/<conversation-id>/inspector-mode.active`.
- Report whether the current session is in **Inspector Mode** or **Normal Mode**.
---
## 3. Co-Maintenance Behavior While Mode is ACTIVE
Whenever the user requests changes, fixes, or refactors to ANY component registered in `src/dev/registry.ts`:
1. **Step 1: Update the Core Component**
- Apply the requested code changes, props modifications, or behavioral logic in `src/components/.../[ComponentName].tsx` (or `src/views/.../[ComponentName].tsx`).
- Update any relevant unit tests in `scripts/` or `__tests__/`.
2. **Step 2: Automatically Synchronize the Dev Inspector**
- Locate the matching inspector at `src/dev/inspectors/[ComponentName]Inspector.tsx`.
- Apply the `component-inspector-updater` workflow:
- **Props & State**: Reconcile any new, altered, or deleted props into the *Editable State* or *Props State* categories.
- **Computed State**: Update derived `useMemo` metrics if underlying rules or formulas changed.
- **Test Verification Cards**: Synchronize the plain-English test fixtures at the bottom of the inspector with the new behavior, updating click handlers so `[Load Test Fixture]` accurately reflects the new state.
- **Preserve Custom Presets**: Keep all existing scenario presets (e.g. week overhauls, superset pairs, edge cases) intact, adapting their shapes to new prop signatures.
- **Advance Timestamp Chip**: Advance `const GENERATED_AT = 'YYYY-MM-DD HH:MM [TIMEZONE]';` to the current local timestamp.
- **No Auto-Scroll**: Ensure all internal scrolling is scoped strictly to element containers (`containerRef.current.scrollTop = containerRef.current.scrollHeight`) with zero page-level scrolling.
3. **Step 3: Verify Types**
- Run `npx tsc --noEmit` to ensure type alignment between the component and its inspector.
- **DO NOT** run raw `npm run build` while a local dev server is active to prevent wiping out `.next/` chunk manifests.
4. **Step 4: Badge Confirmation in Response**
- Include an explicit status chip in your response header or summary:
`[Inspector Mode: Synced <ComponentName> & Dev Inspector]`
---
## 4. Behavior While Mode is INACTIVE (Default)
* When the mode is OFF, the agent performs only the exact requested file modifications.
* Do NOT edit `src/dev/inspectors/` unless the user explicitly requests an inspector update or instructs the agent to create a brand new inspector route.