Modo de edição do inspetor (no escopo da sessão)
RegraEstabelece um modo de edição do inspetor com estado e escopo de sessão para a manutenção conjunta de componentes do React e os inspetores de desenvolvimento isolados correspondentes sem contaminação entre sessões.
Faça login para acessar esta regra
Faça login com seu Perfil do Desenvolvedor do Google para ver e copiar a regra completa usada na série Build It!.
O perfil do desenvolvedor é obrigatório
Você não se qualifica para um perfil de desenvolvedor. Peça para o administrador do Workspace ativar esse recurso.
Criar um perfil de desenvolvedor
Crie um Perfil do desenvolvedor do Google sem custo financeiro para desbloquear todas as habilidades, regras, comandos e artefatos do Build It!
Participe do Builder Central para desbloquear
Resgate seu selo de membro Builder sem custo financeiro com um clique para desbloquear todas as habilidades, regras, comandos e artefatos do Build It!
Como funciona o modo de edição do inspetor no escopo da sessão
Ao iterar em componentes de interface com um Inspetor de Componentes aberto, você quer que as edições de componentes atualizem a visualização correspondente do inspetor na mesma vez, sem forçar permanentemente as edições do inspetor em sessões futuras. Esta regra resolve isso usando um arquivo de marcador com escopo de conversa:
- Desativado por padrão para cada nova sessão: as novas conversas começam no Modo Normal, então as edições de rotina afetam apenas os arquivos exatos que você pedir.
- Entrar no modo de edição do inspetor: diga "Entrar no modo de edição do inspetor" (ou "Ativar o modo inspetor"). O agente cria um arquivo de marcador no escopo da sessão em
<appDataDir>/brain/<conversation-id>/inspector-mode.active, lêsrc/dev/registry.tse lista todos os componentes registrados cobertos por essa sessão. - Manutenção conjunta automática: quando ativo, qualquer mudança que você solicitar em um componente registrado atualiza o componente primeiro e sincroniza imediatamente o
src/dev/inspectors/[ComponentName]Inspector.tsxcorrespondente usando o fluxo de trabalho do Component Inspector Updater, executanpx tsc --noEmite carimba a resposta com um ícone de confirmação. - Sair sem problemas a qualquer momento: diga "Sair do modo de edição do inspetor" para remover o arquivo de marcador e voltar à edição normal de um único destino. Ativar o modo em uma sessão nunca afeta as sessões paralelas ou futuras.
Como instalar no Google Antigravity
Coloque essa regra no seu espaço de trabalho do Google Antigravity com as duas habilidades do Inspetor de Componentes do Episódio 9:
- Crie a pasta
.agents/rules/no espaço de trabalho do projeto (ou abra as Personalizações > Regras do Google Antigravity para adicionar uma regra de espaço de trabalho). - Salve a regra completa do Markdown abaixo como
inspector-editing-mode.mdem.agents/rules/. - Instale as habilidades complementares Gerador do inspetor de componentes e Atualizador do inspetor de componentes para que seu agente tenha os fluxos de trabalho de scaffolding e sincronização referenciados por essa regra.
Definição de regras do modo de edição do Inspector
Copie essa definição de regra completa para seu espaço de trabalho 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.