---
name: shield
description: Sistema completo de protecao — roda Guardian + Scanner + Health Score juntos. Ativa com /shield ou "ativa protecao completa".
---

# Shield — Sistema de Protecao Completo

## Quando ativar
- Quando o usuario digitar `/shield`
- Quando disser: "ativa protecao completa", "ativa o escudo", "protecao total", "shield on"

## O que fazer ao ativar

### Passo 1: Identificar projeto
Detectar projeto pela pasta atual ou perguntar ao usuario.

### Passo 2: Consultar Registry
Ler `~/.claude/shield/registry.json` e identificar:
- Em qual dominio o projeto se encaixa
- Quais skills/agents/projetos ja existem pra esse dominio
- Stack padrao vs stack do projeto

### Passo 3: Executar os 3 sistemas em sequencia

#### 3a. Guardian — Protecao
1. Verificar se tem snapshot salvo
2. Se nao tem, criar snapshot do estado atual
3. Ativar modo protecao (monitorar edits)
4. Mostrar: quantos arquivos/rotas/componentes protegidos

#### 3b. Scanner — Varredura
1. Rodar varredura completa (backend + frontend + integracao)
2. Classificar problemas por severidade
3. Mostrar: quantos criticals/warnings/infos

#### 3c. Health Score — Nota
1. Calcular score baseado nos dados do Guardian + Scanner
2. Comparar com medicao anterior se existir
3. Mostrar: nota atual + breakdown + tendencia

### Passo 4: Relatorio unificado

```
SHIELD ATIVO — {Projeto}
==========================

GUARDIAN: {N} arquivos protegidos | Snapshot: {data}
SCANNER: {C} criticals | {W} warnings | {I} infos
SCORE: {N}/100 — {STATUS}

  ██████████████████░░  87/100  SAUDAVEL

  Protecao      20/20  ✓
  Backend       16/20  2 issues
  Frontend      14/20  3 issues
  Integracao    20/20  ✓
  Qualidade     17/20  1 issue

Registry — Skills disponiveis neste dominio:
  {lista de skills relevantes pro projeto}

Top prioridades:
  1. {critical mais importante}
  2. {warning mais importante}
  3. {info mais importante}

Modo protecao ATIVO — edits serao verificados contra snapshot.
```

### Passo 5: Modo contínuo
Apos ativacao, o Shield permanece ativo durante toda a conversa:

- **Antes de cada Edit/Write:** Guardian verifica snapshot
- **Antes de criar algo novo:** Registry e consultado
- **Ao final de sessao de trabalho:** Perguntar se quer atualizar snapshot

## Comandos dentro do Shield

| Comando | Acao |
|---------|------|
| `/shield` | Ativa tudo (Guardian + Scanner + Score) |
| `/guardian` | So protecao |
| `/scanner` | So varredura |
| `/health-score` | So nota |
| `/shield snapshot` | Salva estado atual como aprovado |
| `/shield report` | Mostra ultimo relatorio completo |
| `/shield registry` | Mostra mapa do ecossistema |
| `/shield compare` | Compara estado atual vs snapshot |

## Regras quando Shield esta ativo

1. **NUNCA reescrever arquivo inteiro** — apenas Edit cirurgico
2. **NUNCA deletar funcao/rota/componente** sem confirmar com usuario
3. **SEMPRE consultar registry** antes de criar skill/componente/sistema novo
4. **SEMPRE recomendar skill existente** quando o dominio ja tem cobertura
5. **SEMPRE mostrar o que ja existe** antes de propor algo novo
6. Se o score cair durante a sessao, alertar imediatamente
7. Se um critical for introduzido, bloquear e avisar

## Arquivo registry.json
O registry fica em `~/.claude/shield/registry.json` e mapeia:
- 22 dominios de conhecimento
- 161+ skills por dominio
- 14 agents especializados
- 10+ projetos com portas/URLs/stacks
- Stack padrao (Express 5 + React 19 + Tailwind 4 + better-sqlite3)
- Regras criticas (nunca deletar, nunca reescrever, nunca secrets no front)

Para atualizar o registry quando novas skills/projetos forem criados:
```bash
# Ler o arquivo atual
cat ~/.claude/shield/registry.json
# Adicionar novo dominio ou skill ao dominio existente
# Salvar de volta
```
