Zoom Out

---
name: zoom-out
description: >-
  Get higher-level architectural perspective: maps modules, callers, dependencies using domain
  vocabulary
allowed-tools: Read Grep Glob
compatibility: >
  Works across all codebases. Most useful when CONTEXT.md domain vocabulary is
  available. Pairs with improve-codebase-architecture for deeper analysis and
  codebase-search for targeted navigation.
metadata:
  tags: architecture, navigation, context, modules, codebase-understanding, orientation
  platforms: Claude, ChatGPT, Gemini, Codex
  version: "1.0"
  source: mattpocock/skills
---

# Zoom Out

Get a higher-level architectural perspective on unfamiliar code sections.

## When to use this skill

- Navigating unfamiliar code and needing to understand how it connects to the larger system
- Before making changes to understand the blast radius
- When you need a module map before diving into implementation

## When not to use this skill

- Finding specific symbols or patterns → use `codebase-search`
- Architectural improvement opportunities → use `improve-codebase-architecture`
- Debugging a specific failure → use `debugging`

## What zoom-out produces

A structural map showing:
- All relevant modules in the area of interest
- Caller relationships (what calls what)
- Key dependencies (what depends on what)
- Domain vocabulary from CONTEXT.md applied to module names

## How to use

When you encounter unfamiliar code, ask for a zoom-out before diving in:

> "Zoom out and give me a broader view of how [module/component] fits into the system."

The response will map the relevant modules using the project's domain glossary, not internal implementation names.

## Output format

```
[Module A] → calls → [Module B], [Module C]
[Module B] ← called by → [Module A], [Module D]

Key seams:
- [Interface X] separates [Domain Concept 1] from [Domain Concept 2]
- [Interface Y] is where [Domain Concept 3] behavior can be swapped

Domain terms in use here:
- "Order" = [what it means in this context]
- "Customer" = [what it means in this context]
```

## Note on invocation

This skill sets `disable-model-invocation: true` — it is a directive framework that instructs the agent how to respond, not an independent processing unit. Invoke it as a behavioral directive when exploring code.

## Instructions
1. Identify the task trigger and expected output.
2. Follow the workflow steps in this skill from top to bottom.
3. Validate outputs before moving to the next step.
4. Capture blockers and fallback path if any step fails.

## Examples
- Example: Apply this skill to a small scope first, then scale to full scope after validation passes.

## Best practices
- Keep outputs deterministic and auditable.
- Prefer small reversible changes over broad risky edits.
- Record assumptions explicitly.

## References
- Project standards: `.agent-skills/skill-standardization/SKILL.md`
- Validator script: `.agent-skills/skill-standardization/scripts/validate_skill.sh`