# Zoom Out

> |

- **Type:** Skill
- **Install:** `agentstack add skill-felvieira-claude-skills-fv-44-zoom-out`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [felvieira](https://agentstack.voostack.com/s/felvieira)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [felvieira](https://github.com/felvieira)
- **Source:** https://github.com/felvieira/claude-skills-fv/tree/main/skills/44-zoom-out

## Install

```sh
agentstack add skill-felvieira-claude-skills-fv-44-zoom-out
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Zoom Out — Mapa de Bairro Antes do Codigo

> **Inspiracao:** [mattpocock/skills/engineering/zoom-out](https://github.com/mattpocock/skills/tree/main/skills/engineering/zoom-out) (MIT).
> Adaptado: forca uso de `graphify-out/graph.json` antes de Grep/Read brutos (CLAUDE.md global).

## Quando Usar

- ao receber task em modulo que o agente nao conhece bem
- quando o usuario disse "estou perdido nessa parte"
- antes de propor refactor ou architecture change (input pra skill 38)
- antes de explorar com `Grep` ou `Read` direto (mais economico)
- como preludio de `detective-spec` em codigos legados

## Quando NAO Usar

- voce ja conhece o modulo (zoom out vira ruido)
- task pontual em arquivo unico ja identificado
- bug fix com stack trace claro

## Governanca Global

Esta skill segue `GLOBAL.md`, `policies/code-exploration.md` (graph > grep > read),
`policies/token-efficiency.md` (mapa enxuto, nao dump), `policies/handoffs.md`
(o mapa pode ser consumido por outras skills).

## Protocolo

### 1. Tentar graph primeiro

Antes de qualquer Read/Grep, tentar:

```bash
test -f graphify-out/graph.json && echo "graph disponivel" || echo "sem graph"
```

Se graph existir, ler `graphify-out/graph.json` + `graphify-out/GRAPH_REPORT.md` (god nodes, communities). Isso responde 80% das perguntas de mapa.

### 2. Fallback: descoberta estrutural

Sem graph, descobrir estrutura via Glob:

```bash
# Topologia
find  -type f \( -name "*.ts" -o -name "*.tsx" -o -name "*.js" -o -name "*.py" -o -name "*.go" -o -name "*.rs" \) | head -50
```

Identificar:
- **entry points** (index.*, main.*, app.*, cli.*)
- **agrupamentos por pasta** (modulos logicos)
- **arquivos grandes** (provaveis hubs)

### 3. Mapear callers/callees principais

Para cada hub identificado, Grep por importacoes:

```bash
# Quem usa o modulo X?
rg "from ['\"].*" --type ts --type tsx -l
```

### 4. Glossario do projeto

Antes de produzir output, capturar **vocabulario do dominio** lendo (em ordem de preferencia):

1. `memory/constitution.md` (se existir — termos canonicos)
2. `docs/repo-audit/current.md` (audit)
3. `README.md` (sintese)
4. Nomes de pastas/arquivos (fallback)

O mapa **fala a lingua do projeto**, nao termos genericos.

## Output

Tabela markdown ou hierarquia textual:

```markdown
# Mapa de 

## Vocabulario do dominio
- : 

## Arquitetura geral

## Modulos principais

| Modulo | Proposito | Callers principais | Callees principais |
|--------|-----------|-------------------|-------------------|
| ...    | ...       | ...               | ...               |

## God nodes (>X dependentes)
- :  dependentes — provavel ponto de friccao

## Pendencias visiveis
- 
- 
```

## Handoffs

- **input pra skill 38 (architecture-deepener):** mapa identifica god nodes; skill 38 propoe deepening
- **input pra skill 33 (detective-spec):** mapa orienta quais modulos detective deve cavar primeiro
- **input pra skill 09 (orchestrator):** mapa informa onde a feature toca, qual pipeline montar
- **input pra skill 32 (smart-suggestions):** dado o mapa, sugerir proxima acao concreta

## Anti-padroes

- ❌ Dump completo de `find . -name "*.ts"` — isso e fuga, nao mapa
- ❌ Ler 50 arquivos pra entender 1 modulo — usa graph primeiro
- ❌ Mapa generico sem vocabulario do projeto
- ❌ "vou ler tudo e depois mapeio" — produz o mapa **enquanto** explora, nao depois

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [felvieira](https://github.com/felvieira)
- **Source:** [felvieira/claude-skills-fv](https://github.com/felvieira/claude-skills-fv)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-felvieira-claude-skills-fv-44-zoom-out
- Seller: https://agentstack.voostack.com/s/felvieira
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.