Modo de edición del inspector (centrado en la sesión)
ReglaEstablece un modo de edición del inspector con estado y centrado en la sesión para mantener de forma conjunta los componentes de React y sus correspondientes inspectores de desarrollo aislados sin contaminación entre sesiones.
Accede para ver esta regla
Accede con tu Perfil del desarrollador de Google para ver y copiar la regla completa que se usa en la serie Build It!
Se requiere un perfil de desarrollador
No cumples con los requisitos para tener un perfil del desarrollador. Notifica a tu administrador de Workspace para que habilite esta función.
Crear un Perfil del desarrollador
Crea un Perfil del desarrollador de Google gratuito para desbloquear todas las habilidades, reglas, instrucciones y artefactos de Build It!
Únete a Builder Central para desbloquearlo
Reclama tu insignia de membresía de Builder sin costo con un solo clic para desbloquear todas las habilidades, reglas, instrucciones y artefactos de Build It!
Cómo funciona el modo de edición del inspector centrado en la sesión
Cuando iteres en los componentes de la IU con un inspector de componentes abierto, querrás que las ediciones de los componentes actualicen la vista del inspector correspondiente en el mismo turno, sin forzar de forma permanente las ediciones del inspector en sesiones futuras. Esta regla resuelve ese problema con un archivo de marcador con alcance de conversación:
- Desactivado de forma predeterminada para cada sesión nueva: Las conversaciones nuevas comienzan en el modo normal, por lo que las ediciones de rutina solo afectan a los archivos exactos que solicitas.
- Ingresar al modo de edición del inspector: Di "Ingresar al modo de edición del inspector" (o "Activar el modo de inspector"). El agente crea un archivo de marcador centrado en la sesión en
<appDataDir>/brain/<conversation-id>/inspector-mode.active, leesrc/dev/registry.tsy enumera todos los componentes registrados que se incluyen en esta sesión. - Mantenimiento conjunto automático: Mientras está activo, cualquier cambio que solicites en un componente registrado actualiza primero el componente y sincroniza de inmediato su
src/dev/inspectors/[ComponentName]Inspector.tsxcoincidente con el flujo de trabajo de Component Inspector Updater, ejecutanpx tsc --noEmity marca la respuesta con un chip de confirmación. - Sal de forma limpia en cualquier momento: Di "Salir del modo de edición del inspector" para quitar el archivo de marcador y volver a la edición normal de un solo destino. Activar el modo en una sesión nunca afecta a las sesiones paralelas o futuras.
Cómo instalar en Google Antigravity
Coloca esta regla en tu espacio de trabajo de Google Antigravity junto con las dos habilidades de Inspector de componentes del episodio 9:
- Crea la carpeta
.agents/rules/en el espacio de trabajo de tu proyecto (o abre Google Antigravity Customizations > Rules para agregar una regla de espacio de trabajo). - Guarda la regla de Markdown completa que se muestra a continuación como
inspector-editing-mode.mddentro de.agents/rules/. - Instala las habilidades complementarias Component Inspector Generator y Component Inspector Updater para que tu agente tenga los flujos de trabajo de scaffolding y sincronización a los que hace referencia esta regla.
Definición de reglas del modo de edición del inspector
Copia esta definición de regla completa en tu espacio de trabajo como 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.