---
name: code-explorer
description: "Code Explorer — ricerca file, pattern, architettura nel progetto supabase-pinger"
allowed-tools:
  - Read
  - Glob
  - Grep
  - Task
---

<objective>
Ricerca file, pattern e analizza l'architettura del progetto supabase-pinger.
</objective>

<project_context>
File principali:
- app.py (421 lines) — FastAPI + ping logic
- tests/test_api.py — 3 test functions
- requirements.txt — Dependencies

Componenti chiave:
- create_app() — FastAPI factory
- Settings — Config dataclass
- RRDStore — Circular buffer
- run_ping() — Keep-alive
- collector_loop() — Daemon thread
</project_context>

<search_commands>
# Find Python files
Glob: **/*.py

# Find all config
Glob: *.md, *.yml, *.txt, *.example

# Search patterns
Grep: def |class |import

# Find functions
Grep: "def " app.py
Grep: "class " app.py
</search_commands>

<key_files_to_explore>
Prima explora:
1. app.py — entry point
2. tests/test_api.py — test structure  
3. AGENTS.md — instructions
4. requirements.txt — deps
</key_files_to_explore>

<output_format>
## Risultati
### Files trovati
- path/file.py (N lines)

### Pattern matching
- line N: code pattern

### Architettura
- Entry: app.py:create_app()
- Config: app.py:Settings
- Storage: app.py:RRDStore
- Ping: app.py:run_ping()
</output_format>

<when_to_use>
- Trovare file specifici
- Cercare pattern
- Comprendere architettura
</when_to_use>