Skill: ivangdavila/portugal (version 1.0.0)

--- name: Portugal slug: portugal version: 1.0.0 homepage: https://clawic.com/skills/portugal description: Discover Portugal like a local with specific restaurants, hidden gems, wine regions, and tips beyond the tourist traps. metadata: {"clawdbot":{"emoji":"🇵🇹","requires":{"bins":[],"config":["~/portugal/"]},"os":["linux","darwin","win32"]}} --- ## Setup If `~/portugal/` doesn't exist or is empty, read `setup.md` and start naturally. ## When to Use User planning a trip to Portugal or wanting local insights: where to eat, what to skip, regional differences, fado, wine, beaches, hidden gems, and practical tips. ## Architecture Memory lives in `~/portugal/`. See `memory-template.md` for structure. ``` ~/portugal/ └── memory.md # Trip context ``` ## Quick Reference | Topic | File | |-------|------| | **Cities** | | | Lisbon complete guide | `lisbon.md` | | Porto complete guide | `porto.md` | | Sintra palaces & gardens | `sintra.md` | | Algarve beaches & towns | `algarve.md` | | **Planning** | | | Sample itineraries | `itineraries.md` | | Where to stay by city | `accommodation.md` | | Useful apps | `apps.md` | | **Food & Drink** | | | Regional dishes, restaurants | `food-guide.md` | | Wine regions & quintas | `wine.md` | | **Experiences** | | | Fado, surfing, festivals | `experiences.md` | | Beach guide by coast | `beaches.md` | | Hiking routes | `hiking.md` | | Nightlife by city | `nightlife.md` | | **Reference** | | | Regions overview | `regions.md` | | Culture, fado, saudade | `culture.md` | | Traveling with children | `with-kids.md` | | **Practical** | | | Getting around | `transport.md` | | Phone & internet | `telecoms.md` | | Emergencies & safety | `emergencies.md` | ## Core Rules ### 1. Specific Over Generic Don't say "try pastéis de nata in Lisbon". Say "Manteigaria in Chiado, Rua do Loreto 2, has the crispiest, warmest pastéis—€1.30 each, eat them standing at the counter within 30 seconds of coming out of the oven." ### 2. Local Perspective What locals actually do, not what guides say: - Pastéis de Belém queue = tourist ritual → Manteigaria or Aloma are better, no wait - Bairro Alto dinner = tourist prices → Santos or Principe Real for locals - Tram 28 = sardine can → walk Alfama or take Tram 12E - Sangria = tourist drink → vinho verde or ginjinha ### 3. Regional Differences | Region | Key difference | |--------|----------------| | Lisboa | Petiscos (small plates). Ginjinha culture. Fado in Alfama. | | Porto | Francesinha mandatory. Port wine caves. More reserved people. | | Alentejo | Slow pace. Porco preto. Wine country. Cork oak landscapes. | | Algarve | Beach resort vibe. Fish/seafood. Cataplana. Tourist-heavy coast. | | Douro | Wine valley. Quintas. Dramatic landscapes. | | Madeira | Subtropical. Poncha. Levada walks. No beaches (rocks). | | Azores | Green, volcanic. Whale watching. Cozido das Furnas. | ### 4. Timing is Everything - Lunch: 12:30-15:00 (Portuguese take long lunches) - Dinner: 20:00+ (kitchens don't really open before 19:30) - August: Lisbon empties, everyone at beaches - Sunday: Many restaurants closed, especially outside Lisbon/Porto - Fado: Starts late, 21:30-22:00 minimum - Shops: Many close 13:00-15:00 (less so in malls) ### 5. Flag Tourist Traps Be explicit about what to avoid: - Restaurants in Praça do Comércio with photos on menus - Any restaurant with "traditional fado" signs and hawkers outside - Overpriced seafood on Rua Augusta - Canned sardines as "authentic souvenir" (locals don't eat them much) - "Free" walking tours with guilt-trip donations - €8 pastéis de Belém at the famous shop vs €1.30 elsewhere ### 6. Match Trip Style | Traveler | Focus on | |----------|----------| | Foodie | food-guide.md, wine.md, porto.md | | Beach | beaches.md, algarve.md | | Culture | lisbon.md, sintra.md, culture.md | | Adventure | hiking.md, experiences.md, azores/madeira in regions.md | | Family | with-kids.md, beaches.md, algarve.md | | Nightlife | nightlife.md, lisbon.md, porto.md | | Wine | wine.md, regions.md (Douro, Alentejo) | ## Common Traps - Queueing 45 min for Pastéis de Belém — same recipe everywhere, try Manteigaria - Taking Tram 28 — pickpocket central, overcrowded, walk instead - Eating at Ribeira waterfront in Porto — tourist prices, go uphill to Cedofeita - Booking last-minute in August — beaches packed, book months ahead - Tipping 15-20% like USA — not expected, round up or 5-10% max - Paying in euros at bad exchange — always pay in local currency - Renting car in Lisbon center — nightmare parking, use only for day trips - Expecting beach weather in Lisbon — Atlantic is cold, even in summer (18-20°C) ## Security & Privacy **Data that stays local:** Trip preferences in ~/portugal/ **This skill does NOT:** Access files outside ~/portugal/ or make network requests. ## Related Skills Install with `clawhub install <slug>` if user confirms: - `travel` — Travel planning - `food` — Food and cooking - `portuguese` — Portuguese language ## Feedback - If useful: `clawhub star portugal` - Stay updated: `clawhub sync`

path: accommodation.md
content: # Where to Stay in Portugal

## Accommodation Types

### Hotels
Standard international options. Portugal has good mid-range and growing boutique scene.

### Pousadas
Historic state-run hotels in castles, monasteries, palaces. Worth it for the experience. Pousadas.pt — premium but atmospheric.

### Quintas
Wine estates with accommodation. Common in Douro, Alentejo. Farm/manor house vibe.

### Hostels
Excellent quality in Portugal. Lisbon and Porto have some of Europe's best-rated hostels.

### Apartments
Often best value for families/groups. Booking.com, Airbnb both active. Legal in Portugal but check registration (AL license).

## Lisbon

### By Neighborhood

**Baixa/Chiado** — Central, walkable, touristy
- Best for: First-timers, short stays
- Price: €€-€€€
- Picks: Hotel do Chiado, Corpo Santo, The Ivens

**Alfama** — Authentic, hilly, fado
- Best for: Atmosphere seekers
- Price: €-€€€
- Picks: Santiago de Alfama, Memmo Alfama, Solar do Castelo

**Bairro Alto/Príncipe Real** — Trendy, nightlife, LGBTQ+
- Best for: Going out, boutique lovers
- Price: €€-€€€
- Picks: The Vintage, Torel Palace, As Janelas Verdes

**Parque das Nações** — Modern, family-friendly, near Oceanarium
- Best for: Families, airport access
- Price: €€
- Picks: Myriad, Tivoli Oriente

### Budget Picks
- **Home Lisbon Hostel** — Multiple awards, social
- **Living Lounge Hostel** — Great location
- **Goodmorning Lisbon** — Boutique hostel feel

### Splurge Picks
- **Bairro Alto Hotel** — Rooftop, chic
- **Pestana Palace** — Palace hotel, gardens
- **Four Seasons Ritz** — Classic luxury

## Porto

### By Area

**Ribeira** — UNESCO, waterfront, tourist central
- Best for: Views, first impression
- Price: €€-€€€
- Note: Touristy, noisy at night

**Baixa/Aliados** — Central, transport hub
- Best for: Convenience
- Price: €€
- Picks: InterContinental Palácio das Cardosas

**Cedofeita/Bonfim** — Local, artsy, quieter
- Best for: Longer stays, authenticity
- Price: €-€€

**Foz do Douro** — Beach, upscale suburb
- Best for: Relaxed pace
- Price: €€-€€€

**Gaia (wine caves side)**
- Best for: Wine focus, views of Porto
- Price: €€-€€€€
- Picks: The Yeatman (splurge), WOW Porto

### Budget Picks
- **Gallery Hostel** — Beautiful building
- **Bluesock Hostels** — Modern, reliable
- **Tattva Design Hostel**

### Splurge Picks
- **The Yeatman** — Wine hotel, 2 stars restaurant, views
- **Torel Avantgarde** — Design, panoramic
- **Pestana Vintage** — Ribeira waterfront

## Algarve

### By Town

**Lagos** — Best all-rounder
- Beaches + old town + nightlife + not too touristy
- Price: €-€€€
- Picks: Cascade Wellness Resort, Boutique Hotel Vivenda Miranda

**Tavira** — Quietest pretty town
- Romantic, relaxed, island beaches
- Price: €€
- Picks: Pousada Convento de Tavira, Vila Galé Albacora

**Albufeira** — Party/resort zone
- Families or nightlife (different areas)
- Price: €-€€€
- Only if: You want that scene

**Sagres** — Edge of the world
- Wild, surfing, minimal
- Price: €-€€
- Picks: Memmo Baleeira, Martinhal Sagres

**Vilamoura** — Upscale marina
- Golf, yachts, international
- Price: €€-€€€€

### Family Resorts
- **Martinhal Sagres** — Family-focused, activities, beach
- **Pine Cliffs** — Cliff-top, golf, kids' club
- **Vidamar Resort** — All-inclusive option

## Douro Valley

**Options:**
1. **Day trip from Porto** — Train to Pinhão + taxi
2. **Overnight at quinta** — Full experience
3. **Wine hotel** — Luxury option

**Recommended:**
- **Quinta Nova** — Wine + hotel, excellent
- **Six Senses** — Ultra-luxury
- **Quinta de Vallado** — Family estate
- **Quinta do Crasto** — Stunning views (limited rooms)

## Madeira

### Funchal
Most stay here. Good walkable center.

- **Reid's Palace** — Classic, Churchill stayed, €€€€
- **The Vine** — Modern, rooftop pool, €€€
- **Castanheiro Boutique** — Central, value, €€

### Outside Funchal
Worth considering for nature/hiking:

- **Quinta do Furão** — North coast, gardens
- **Estalagem da Ponta do Sol** — Cliffside, design
- **Choupana Hills** — Spa, mountain views

## Azores (São Miguel)

### Ponta Delgada
Main city, most services.

- **Azor Hotel** — Modern, central, marina views
- **Hotel Talisman** — Boutique, historic
- **Neat Hotel** — Design, good value

### Outside City
- **Furnas Boutique Hotel** — Near hot springs
- **Santa Bárbara Eco-Beach Resort** — Surf coast

## Alentejo

### Évora
- **Pousada Convento dos Loios** — In monastery, stunning
- **Vitória Stone Hotel** — Modern, central
- **Albergaria do Calvário** — Value pick

### Wine Estates
- **L'AND Vineyards** — Design, wine, €€€€
- **Herdade do Esporão** — Day visit (no hotel) but nearby options
- **São Lourenço do Barrocal** — Farmhouse luxury

## Budget Tips

### Save Money
- Book apartments (especially families)
- Stay slightly outside center
- Hostels in Portugal are excellent
- Shoulder season (Sep-Oct, Apr-May)
- Sunday night often cheapest
- Longer stays = better rates

### Average Prices (per night)
| Type | Low season | High season |
|------|-----------|-------------|
| Hostel dorm | €15-25 | €25-40 |
| Budget hotel | €50-80 | €80-120 |
| Mid-range | €80-150 | €150-250 |
| Boutique | €150-300 | €250-400 |
| Luxury | €300+ | €500+ |

## Booking Tips

### When to Book
- **August:** 2-3 months ahead (especially Algarve, islands)
- **Easter/June festivals:** 1-2 months ahead
- **Shoulder season:** 2-4 weeks usually fine
- **Winter:** Last minute okay (except New Year in Madeira)

### Platforms
- **Booking.com** — Best selection Portugal
- **Hotels.com** — Good for chains
- **Airbnb** — Apartments, unique stays
- **Pousadas.pt** — Historic hotels direct
- **Mr & Mrs Smith** — Boutique hotels


path: algarve.md
content: # Algarve — Beaches, Cliffs & Coast

## Overview

Southern coast of Portugal. 200+ days of sunshine. Dramatic cliffs, golden beaches, warm(ish) water. Mix of overtouristed resorts (Albufeira) and hidden gems (west coast). Golf destination, retiree haven, family-friendly.

**The trade-off:** Better weather and beaches than Lisbon, but less culture and more tourists.

## West vs East vs Central

| Zone | Vibe | Best for | Skip if |
|------|------|----------|---------|
| **West Coast** | Wild, windy, surfer | Adventure, surfing, nature | You want calm beaches |
| **Central** | Tourist heartland | Families, nightlife | You hate crowds |
| **East** | Quiet, authentic | Relaxation, locals | You need action |

## Best Towns

### Lagos ⭐
**Vibe:** Best balance. Historic center + stunning beaches + nightlife + not too touristy
**Best for:** First-time Algarve, couples, young travelers
**Stay:** 3-4 nights minimum

**Beaches:**
- **Praia Dona Ana** — Iconic cliffs, postcard-famous
- **Praia do Camilo** — Tiny, dramatic, 200 steps down
- **Meia Praia** — Long, watersports, families
- **Ponta da Piedade** — Cliffs and grottoes, kayak or boat tour

**Eat:**
- **A Forja** — Cataplana (seafood stew), Rua dos Ferreiros 17, €25-35
- **No Patio** — Hidden garden, petiscos, Rua Lancarote de Freitas 46
- **Tasca Jota** — Tiny, traditional, cash only

**Nightlife:** Rua Cândido dos Reis — bars and clubs. Best in western Algarve.

### Tavira ⭐
**Vibe:** Quietest pretty town. Roman bridge, whitewashed houses, no high-rises
**Best for:** Relaxation, couples, off-the-beaten-path
**Beach:** Take ferry to Ilha de Tavira — stunning sandbar island

**Eat:**
- **Aquasul** — Modern Portuguese, Rua Dr. José Pires Padinha
- **Ponto de Encontro** — Fresh fish, waterfront

### Faro
**Vibe:** Gateway city. Small old town, transport hub
**Best for:** Arrival/departure, day trip
**Stay:** 1 night max (better to base elsewhere)

**Do:**
- Old town (compact, walkable)
- Ria Formosa boat trip (lagoon, islands, birdlife)
- Praia de Faro (beach, accessible)

### Albufeira
**Vibe:** Tourist central. British expats, nightclubs, family resorts
**Best for:** Package holidays, families with kids, clubbing
**Skip if:** You want authentic Portugal

The "Strip" is full of British pubs. Only go if that's your scene.

### Sagres
**Vibe:** Edge of the world. Surfing, dramatic cliffs, end of Europe
**Best for:** Surfers, adventurers, escaping crowds
**Beaches:** Praia do Tonel, Praia do Beliche, Praia da Mareta

This is where Henry the Navigator supposedly planned expeditions. Wild, windswept, minimal infrastructure.

### Olhão
**Vibe:** Fishing town, working-class, authentic
**Best for:** Fish market, day trips to islands
**Skip:** Ugly waterfront, but character behind it

**Do:** Morning fish market (Saturdays best). Ferry to Armona and Culatra islands.

## Best Beaches

### Swimming / Families
| Beach | Near | Notes |
|-------|------|-------|
| Praia da Marinha | Lagoa | Iconic cliffs, snorkeling, crowded |
| Praia Dona Ana | Lagos | Postcard perfect, small |
| Praia de Benagil | Lagoa | Cave access by SUP/kayak |
| Praia da Falésia | Albufeira | Long, red cliffs, space |
| Ilha de Tavira | Tavira | Ferry access, pristine |
| Praia da Ilha Deserta | Faro | Boat access, wild, clothes-optional section |

### Surfing
| Beach | Level | Notes |
|-------|-------|-------|
| Praia do Amado | All | Most consistent, surf schools |
| Praia da Arrifana | Intermediate+ | Point break, locals |
| Praia do Tonel | Intermediate | Sagres, dramatic cliffs |
| Praia da Cordoama | All | Long beach, less crowded |

### Secret / Quiet
- **Praia da Ingrina** — Near Sagres, tiny, locals only
- **Cacela Velha** — East, above lagoon, picturesque village
- **Praia de Odeceixe** — North (technically Alentejo), river meets sea

## Activities

### Benagil Cave
**What:** Sea cave with beach and circular opening (algar)
**How:** SUP, kayak, or boat tour from Benagil beach
**Cost:** Kayak €30-40, boat tour €20-30
**Tip:** Go early morning (before 10:00) for photos without crowds

### Ponta da Piedade
**What:** Dramatic cliff formations, grottoes
**How:** Walk down stairs, or take boat from Lagos marina
**Cost:** Boat tour €15-25 (1 hour)

### Ria Formosa
**What:** Lagoon system, birdlife, sandbar islands
**How:** Boat tours from Faro or Olhão
**Cost:** €20-40 depending on duration
**Best for:** Nature lovers, quieter experience

### Golf
Algarve has 40+ courses. Famous for golf holidays.
- **Monte Rei** — #1 in Portugal, €200+ green fee
- **Quinta do Lago** — Multiple courses, €100-180
- **Vilamoura** — 5 courses, all levels

## Food & Drink

### Regional Dishes
| Dish | What | Where |
|------|------|-------|
| **Cataplana** | Seafood in copper pot | Lagos, Olhão, everywhere |
| **Percebes** | Barnacles | Expensive, near coast |
| **Grilled fish** | Dourada, robalo, whole | Any marisqueira |
| **Chicken piri-piri** | Spicy grilled chicken | Guia is capital |
| **Dom Rodrigo** | Sweet, egg-based | Traditional pastry |

### Best Food Towns
1. **Olhão** — Fish market, working fishermen, authentic
2. **Lagos** — Good mix of traditional and modern
3. **Tavira** — Quieter, quality seafood

### Where NOT to Eat
- Albufeira Strip — British pub food
- Any waterfront with aggressive hawkers
- Restaurant with photos on menu + €15 fish

## Getting Around

### Airport
Faro Airport (FAO) is the gateway. Most fly here.

### Without a Car
Possible but limiting. Lagos, Faro, Tavira connected by train/bus. Beaches need taxi/Uber.

### With a Car
**Recommended.** Best beaches and restaurants need car. Parking easy outside main towns.

**Rent from:** Airport (cheaper) or Lagos. Major companies all present.
**Road:** A22 (toll motorway) connects whole coast. €5-10 end to end.

### Train
**Faro → Lagos:** 1.5 hours, €7-9
**Faro → Tavira:** 40 min, €3-4
No train to Sagres (bus or car only)

## Accommodation

### Where to Stay by Style
| Style | Stay | Why |
|-------|------|-----|
| All-round | Lagos | Balance of everything |
| Quiet relaxation | Tavira | Beautiful, calm |
| Beach resort | Vilamoura | Golf, family facilities |
| Surf | Sagres area | Wild coast |
| Budget party | Albufeira | Cheap, clubs |

### Book Ahead
July-August is peak. Book 2-3 months ahead for good places. September is shoulder season — perfect.

## Algarve Mistakes to Avoid

1. **Staying in Albufeira thinking it's authentic Portugal** — It's Blackpool with sun
2. **Driving the A22 without Via Verde** — Tolls are cameras only, fines later
3. **Benagil Cave at midday** — Go before 10:00 or kayak at sunset
4. **Expecting Atlantic warmth** — Water is 18-22°C. Warmer than Lisbon but not tropical.
5. **Only visiting beaches** — Ria Formosa, Silves castle, inland villages worth a day
6. **Package resort food** — Walk 10 minutes for half the price, double the quality
7. **Arriving without car in Sagres** — Very limited public transport
8. **August without booking** — Everything full, prices peak


path: apps.md
content: # Essential Apps for Portugal

## Transport

### Uber / Bolt
**What:** Ride-hailing
**Works in:** Lisbon, Porto, Algarve, Madeira
**Cost:** Cheaper than taxis, €5-15 most trips
**Tip:** Bolt often slightly cheaper than Uber

### Carris / STCP
**What:** Official public transport apps
**Carris:** Lisbon buses, trams, metro
**STCP:** Porto buses, metro
**Use for:** Route planning, schedules
**Alternative:** Google Maps works well for transit

### CP (Comboios de Portugal)
**What:** Train booking app
**Use for:** Book tickets, check schedules
**Alternative:** cp.pt website
**Tip:** Book Alfa Pendular (fast trains) in advance for better prices

### Rede Expressos
**What:** Bus network
**Use for:** Intercity buses (often cheaper than trains)
**Alternative:** rede-expressos.pt

### Via Verde Visitors
**What:** Toll payment (essential if driving)
**Why:** Portuguese tolls are electronic (no booths)
**Alternative:** Rent Via Verde device with car rental
**Cost:** App requires registration + €6 device mailed to accommodation

## Food & Restaurants

### Zomato
**What:** Restaurant reviews, menus
**Coverage:** Good in Lisbon and Porto
**Tip:** Better for urban areas than TripAdvisor sometimes

### TheFork (LaFourchette)
**What:** Restaurant reservations, discounts
**Use for:** Book popular restaurants, get 20-50% off
**Coverage:** Major cities

### Google Maps
**What:** Best for reviews + discovery
**Tip:** Search "petiscos" or "tasca" for local gems

### Bolt Food / Uber Eats / Glovo
**What:** Food delivery
**Coverage:** Lisbon, Porto, Algarve
**Tip:** Glovo sometimes has local restaurants others don't

## Navigation & Maps

### Google Maps
**What:** Navigation, transit, reviews
**Works:** Everywhere, offline maps available
**Best for:** Most situations

### maps.me
**What:** Offline maps
**Best for:** Hiking, rural areas, islands
**Tip:** Download before going offline

### Wikiloc
**What:** Trail maps, GPS tracks
**Best for:** Hiking routes (Rota Vicentina, Madeira levadas)
**Tip:** Premium worth it for offline + navigation

### Komoot
**What:** Route planning, hiking/cycling
**Alternative to:** Wikiloc for planning

## Money & Payments

### Revolut / Wise / N26
**What:** Multi-currency accounts, cheap conversion
**Why:** Better rates than banks, no foreign transaction fees
**Tip:** Widely accepted, use for larger purchases

### MB Way
**What:** Portuguese mobile payment system
**Works with:** Portuguese bank accounts only
**For tourists:** Not usable, but good to know what locals use

### Apple Pay / Google Pay
**What:** Contactless payments
**Coverage:** Most restaurants, shops, supermarkets accept
**Tip:** Very widely accepted in Portugal

## Language

### Google Translate
**What:** Translation + camera mode
**Use for:** Menus, signs, basic conversations
**Tip:** Download Portuguese for offline use

### Duolingo
**What:** Language learning
**Use for:** Basic Portuguese before/during trip
**Realistic:** Learn greetings and food words

## Accommodation

### Booking.com
**What:** Best hotel coverage in Portugal
**Tip:** Free cancellation options useful

### Airbnb
**What:** Apartments, unique stays
**Note:** Legal in Portugal (look for AL license)

## Activities & Experiences

### GetYourGuide / Viator
**What:** Tours, activities, skip-the-line tickets
**Use for:** Popular attractions (Sintra, Port caves)
**Tip:** Book Sintra tickets here to skip queues

### Fever
**What:** Local events, experiences
**Coverage:** Lisbon mainly
**Use for:** Rooftop events, unique experiences

## Utilities

### Waze
**What:** Navigation with traffic, speed cameras
**Best for:** Driving, especially Algarve
**Tip:** Better than Google Maps for traffic alerts

### WhatsApp
**What:** Messaging
**Why:** Portuguese default messaging app
**Use for:** Contact restaurants, tour operators, hosts

### XE Currency
**What:** Currency conversion
**Use for:** Quick price checks
**Tip:** Most things in Portugal are in euros anyway

## Portugal-Specific

### EMEL Parking (Lisbon)
**What:** Pay for street parking
**Use for:** If you're driving in Lisbon (avoid if possible)

### Visitante EMEL
**What:** Lisbon parking app
**Alternative:** ePark app

### Time Out
**What:** Local events, restaurants
**Coverage:** Lisbon and Porto editions
**Use for:** What's on, new openings

## Travel Planning

### Trainline
**What:** European train booking
**Use for:** Cross-border or multi-country trips
**Alternative:** cp.pt for Portugal-only

### Skyscanner
**What:** Flight search
**Use for:** Inter-island flights (Azores), Madeira connections
**Tip:** TAP often cheapest for domestic

### PackPoint
**What:** Packing list generator
**Use for:** Weather-appropriate packing

## Essential Downloads Before Arriving

1. **Google Maps** — Download Portugal offline maps
2. **Uber + Bolt** — Set up accounts
3. **Booking.com** — Confirmations accessible offline
4. **WhatsApp** — Communication with locals
5. **Translator** — Download Portuguese language
6. **Wikiloc** — If hiking, download trail maps

## Apps to Skip

- **TripAdvisor** — Google Maps reviews usually better in Portugal
- **Yelp** — Not used in Portugal
- **Citymapper** — Doesn't cover Portugal well
- **Local taxi apps** — Just use Uber/Bolt


path: beaches.md
content: # Portuguese Beach Guide

## Know Before You Go

### Water Temperature
**Atlantic = COLD.** Even in August:
- Lisbon coast: 17-20°C
- Algarve: 20-23°C (warmest)
- North: 15-18°C

**Translation:** Refreshing dip, not lounging in water. Wetsuits common for surfing year-round.

### Beach Culture
- **Sunbeds:** €10-20/day at beach bars (not everywhere)
- **Food:** Beach restaurants (better than expected)
- **Nudist:** Some sections, usually marked
- **Lifeguards:** Blue flag beaches staffed in summer
- **Dogs:** Often banned June-September

## Beaches by Region

### Lisbon Area

#### Costa da Caparica
**What:** Long strip of beaches south of Lisbon. Surfers, families, young crowd.
**How:** Bus from Praça Espanha (45 min) or ferry to Cacilhas + bus
**Vibe:** More relaxed than Cascais, local, good waves

Best beaches:
- **Praia de São João** — Young crowd, bars
- **Praia da Morena** — LGBTQ+ friendly
- **Praia do Meco** — Wilder, naturist section

#### Cascais/Estoril
**What:** Train-accessible beach towns
**How:** Train from Cais do Sodré (40 min, €2.25)
**Vibe:** Tourist, family, crowded in summer

**Beaches:**
- Praia de Carcavelos — Biggest, surfing
- Praia da Rainha — Small, central Cascais
- Praia do Tamariz — Estoril, casino backdrop

#### Guincho
**What:** Wild beach, big waves, wind
**How:** Need car from Cascais
**Vibe:** Surfers, kiters, dramatic

#### Arrábida
**What:** Crystal clear water, protected nature park
**How:** Need car from Lisbon (1 hour)
**Vibe:** Best water near Lisbon, Mediterranean feel

**Best beaches:**
- **Praia de Galapinhos** — Voted best beach in Europe (2017), limited access
- **Praia de Figueirinha** — More accessible
- **Praia de Coelhos** — Tiny, hidden

**Pro tip:** Arrive before 10:00 in summer. Park closes when full.

### Porto Area

#### Matosinhos
**What:** Urban beach, seafood restaurants behind
**How:** Metro from Porto (20 min)
**Vibe:** Local, surfing, lunch destination

#### Foz do Douro
**What:** Porto's beach neighborhood
**How:** Tram 1 from center or walk
**Vibe:** Upscale, sunset walks, rocky

#### Espinho
**What:** Proper beach town south of Porto
**How:** Train (30 min)
**Vibe:** Local holiday spot, casino

### Algarve

#### Western Algarve (Best cliffs)
| Beach | Near | Notes |
|-------|------|-------|
| Praia da Marinha | Lagoa | Iconic cliffs, snorkeling, crowded |
| Praia de Benagil | Lagoa | Cave access by water |
| Praia Dona Ana | Lagos | Postcard perfect, small |
| Praia do Camilo | Lagos | 200 steps down, dramatic |
| Praia da Rocha | Portimão | Big, tourist, facilities |

#### Eastern Algarve (Calmer)
| Beach | Near | Notes |
|-------|------|-------|
| Ilha de Tavira | Tavira | Ferry access, pristine |
| Praia de Cabanas | Cabanas | Village vibe |
| Cacela Velha | Near Tavira | Lagoon, peaceful |
| Ilha Deserta | Faro | Boat access, wild |

#### Secret Spots
- **Praia da Ingrina** — Near Sagres, tiny, locals
- **Praia da Arrifana** — Surf, dramatic, north Algarve

### West Coast (Wild Atlantic)

#### Costa Vicentina
**What:** Protected coastline, surfing, wild
**Where:** Alentejo coast down to Sagres
**Vibe:** Undeveloped, dramatic, windswept

**Best beaches:**
- **Praia de Odeceixe** — River meets sea
- **Praia da Amoreira** — Dunes, lagoon
- **Praia da Bordeira** — Huge, wild
- **Praia do Amado** — Surf mecca

### Islands

#### Madeira
**No sandy beaches.** Volcanic island = pebbles and rocks. Natural lava pools instead:
- Porto Moniz — Famous natural pools
- Prainha — One sandy beach (black sand), tiny

#### Azores
Mix of volcanic and some sandy beaches:
- **Praia de Santa Bárbara** (São Miguel) — Surf beach
- **Praia Formosa** (Santa Maria) — Best sand in Azores

## Beaches by Activity

### Surfing
| Beach | Level | Notes |
|-------|-------|-------|
| Ericeira | All levels | WSL reserve, world-class |
| Peniche/Supertubos | Expert | Pipeline of Europe |
| Nazaré | Expert only | Big wave, winter |
| Praia do Amado | All levels | Consistent, schools |
| Carcavelos | Beginner | Near Lisbon, easy |
| Matosinhos | Beginner | Near Porto |

### Families
- Praia da Falésia (Algarve) — Long, facilities
- Cascais beaches — Train access, calm
- Praia de São Jacinto (Aveiro area) — Protected lagoon
- Ilha de Tavira — Calm, shallow

### Hidden/Quiet
- Praia de Galapinhos (Arrábida) — Limited access
- Cacela Velha (Algarve) — Lagoon
- Praia da Adraga (Sintra coast) — Dramatic, local
- Praia dos Coelhos (Arrábida) — Tiny cove

### Nudist
- Praia do Meco (Costa da Caparica) — Section
- Praia das Adegas (Alentejo) — Remote
- Ilha Deserta (Faro) — Section

## Surf Towns

### Ericeira
**What:** World Surfing Reserve (one of few globally)
**Where:** 35 km north of Lisbon
**Vibe:** Surf culture, hostels, relaxed

**Waves:** 7+ breaks including Ribeira d'Ilhas, Coxos (expert)
**Schools:** Everywhere, €30-50/lesson
**Stay:** Hostels €20-30, surf camps €50-100

### Peniche
**What:** Surf peninsula, Supertubos (world tour)
**Where:** 1 hour north of Lisbon
**Vibe:** Working fishing town + surf

**Waves:** Supertubos (expert), Baleal (learners)
**Also:** Boat to Berlengas islands (nature reserve)

### Nazaré
**What:** Big wave surfing capital
**When:** Winter storms = 20-30m waves
**Watch from:** Farol da Nazaré (lighthouse viewpoint)

**For non-surfers:** Traditional fishing culture, funicular, great seafood

## Beach Essentials

### What to Bring
- Windbreak/tent — Atlantic wind is real
- Reef shoes — Some beaches rocky
- Sunscreen — Sun is strong
- Cash — Beach bars often cash-only
- Light cover-up — For lunch at beach restaurants

### Blue Flag Beaches
Quality standard. Portugal has 400+ Blue Flag beaches (one of highest in Europe). Indicates:
- Water quality
- Lifeguards
- Facilities
- Environmental management

## Beach Mistakes

1. **Expecting warm water** — It's the Atlantic. Bring wetsuit or accept cold dips.
2. **No sunscreen because "not tropical"** — UV index high, especially Algarve
3. **Driving to Arrábida after 11:00 in summer** — Park closes when full
4. **Beach restaurant at 14:00** — Packed. Go 12:30 or after 15:00.
5. **Sintra coast without checking conditions** — Rough, dangerous currents
6. **Underestimating Nazaré waves** — Only watch from shore. Never swim in big wave conditions.


path: culture.md
content: # Portuguese Culture

## Saudade — The Untranslatable

The word that defines Portugal. Roughly: longing, nostalgia, melancholy for something absent. Not sadness—more like bittersweet yearning. You'll hear it in fado, see it in poetry, feel it in the national character.

Portuguese aren't depressed—they're romantic about loss and distance. Makes sense for a seafaring nation.

## Fado — The Soul Music

### What It Is
UNESCO Intangible Cultural Heritage. A singer (fadista), Portuguese guitar, classical guitar. Themes: fate, longing, the sea, lost love, Lisbon itself.

### Where to Hear

**Lisbon (authentic):**
| Venue | Style | Notes |
|-------|-------|-------|
| Tasca do Chico | Spontaneous, amateur | Tiny, magical, no reservations |
| Mesa de Frades | Professional, intimate | Former chapel |
| Clube de Fado | High quality | Minimum consumption |
| Maria da Mouraria | Local | In fado's birthplace |

**Coimbra:** Different style—traditionally sung by men (university students), more intellectual.

### Etiquette
- **Silence during songs** — Mandatory, seriously
- **Clap between songs** — Never during
- **No photos during performance**
- **Dress smart casual**
- **Arrive early** — Many places don't reserve

### Famous Fadistas
- **Amália Rodrigues** — The queen, essential listening
- **Mariza** — Contemporary star
- **Ana Moura** — Modern, accessible
- **Camané** — Male voice, traditional

## Portuguese Character

### What to Expect
- **Reserved initially** — Warmer once comfortable
- **Hospitality** — Generous once you're a guest
- **Indirect communication** — Don't expect German directness
- **Pride** — Especially about history, discoveries, food
- **Pessimism with humor** — "It could be worse" mentality
- **Punctuality** — Flexible (don't be surprised by delays)

### Regional Differences
| Region | Stereotype |
|--------|------------|
| Lisbon | Cosmopolitan, laid-back |
| Porto | Proud, hardworking, direct |
| Alentejo | Slow pace, traditional |
| Algarve | Influenced by tourism |
| North | More conservative, religious |

### The Lisbon vs Porto Rivalry
Good-natured but real. Porto thinks Lisbon is pretentious. Lisbon thinks Porto is provincial. Both are wrong. Don't pick sides.

## Religion & Traditions

### Catholic Heritage
Portugal is historically Catholic (81% identify). Influences culture even for non-practicing:
- Saints' days (festivals)
- Church bells
- Religious iconography everywhere

### Fátima
Major pilgrimage site. In 1917, three shepherd children reported visions of the Virgin Mary. Now attracts 4-6 million pilgrims yearly. May 13 and October 13 are peak days.

**Visit if:** Interested in religious sites or Portuguese faith
**Skip if:** Not into religious tourism

### Holy Week (Semana Santa)
- Braga has major processions (impressive)
- Many places more subdued
- Good Friday is solemn

## Social Customs

### Greetings
- **Two kisses** — Right cheek first, between acquainted people
- **Handshake** — Business/formal or first meeting
- **"Bom dia/Boa tarde/Boa noite"** — Say it. Always.

### Dining
- **Long meals** — Lunch can be 2+ hours
- **Couvert** — Bread/olives at start. NOT free. Can refuse.
- **Splitting bills** — Unusual. Often one person pays.
- **Coffee after** — Always. Meal isn't done without it.
- **Tipping** — 5-10% if service good. Not obligatory.

### Time
- **Flexible punctuality** — 15-30 minutes late is normal socially
- **Business meetings** — More punctual expected
- **Lunch** — Serious. 12:30-15:00.
- **Dinner** — Late. 20:00-22:00.

### Dress
- **Smart casual** — Portuguese dress better than many Europeans
- **Beach clothes in city** — Frowned upon
- **Fado houses** — No shorts/flip-flops

## Azulejos — Tile Culture

Blue-and-white tiles everywhere. Originally Arab influence ("al-zulayj"). Now quintessentially Portuguese.

### Where to See
- **São Bento Station (Porto)** — 20,000 tiles, free
- **National Azulejo Museum (Lisbon)** — Comprehensive history
- **Igreja de São Roque (Lisbon)** — Church interior
- **Everywhere** — Random buildings, metro stations, churches

### Take a Workshop
Make your own. Several ateliers in Lisbon offer classes (€40-80).

## Key Historical Context

### The Discoveries
1415-1543: Portuguese explorers sailed the world. First to reach:
- West Africa, India (da Gama), Brazil (Cabral), Japan, etc.
- Created global trade networks
- Source of national pride (and complicated legacy)

### 1755 Earthquake
Destroyed Lisbon. 30,000-60,000 dead. Shaped modern city planning (Baixa grid). National trauma, enlightenment response.

### Estado Novo (1933-1974)
Salazar's dictatorship. 41 years of authoritarian rule. Carnation Revolution (April 25, 1974) ended it peacefully—soldiers put carnations in guns. April 25 is a national holiday.

### European Integration
Joined EU (then EC) in 1986. Transformed economy, infrastructure. Euro since 2002.

## Language Tips

### Portuguese vs Spanish
NOT the same. Portuguese understand Spanish better than reverse. Speaking Spanish to Portuguese can be seen as lazy/disrespectful. Try Portuguese—they appreciate the effort.

### Essential Phrases
| Portuguese | Meaning |
|------------|---------|
| Bom dia | Good morning |
| Boa tarde | Good afternoon |
| Boa noite | Good evening |
| Obrigado/a | Thank you (m/f) |
| Por favor | Please |
| Desculpe | Excuse me/Sorry |
| A conta, por favor | The bill, please |
| Fala inglês? | Do you speak English? |

### English Levels
- **Lisbon/Porto:** High, especially under 40
- **Tourist areas:** Good
- **Rural areas:** Limited
- **Older generations:** Less common

## Holidays & Festivals

### Public Holidays
- January 1 — New Year
- April 25 — Freedom Day (Carnation Revolution)
- May 1 — Labor Day
- June 10 — Portugal Day
- August 15 — Assumption
- October 5 — Republic Day
- December 25 — Christmas

### Major Festivals
| Festival | When | Where | What |
|----------|------|-------|------|
| Santos Populares | June | Lisbon, Porto | Street parties, sardines |
| São João | June 23-24 | Porto | Plastic hammers, balloons |
| Santo António | June 12-13 | Lisbon | Alfama parties |
| Carnaval | Feb/Mar | Torres Vedras, Loulé | Parades |
| Festa dos Tabuleiros | Every 4 years | Tomar | Bread towers |

## Cultural Mistakes to Avoid

1. **Speaking Spanish** — Try Portuguese or ask for English
2. **Rushing meals** — Dining is social, not fast
3. **Ignoring greetings** — Always say bom dia/boa tarde
4. **Comparing to Spain** — They're different countries
5. **Tipping American-style** — Not expected (5-10% max)
6. **Talking during fado** — Seriously, don't
7. **Calling it "Oporto"** — It's Porto (the O is just the article)


path: emergencies.md
content: # Emergencies & Safety in Portugal

## Emergency Numbers

| Service | Number | Notes |
|---------|--------|-------|
| **Universal Emergency** | **112** | Police, Fire, Ambulance |
| SOS Highway | 117 | Breakdown, accidents |
| Tourist Police | 808 200 200 | English available |
| Poison Control | 808 250 143 | 24h |
| PSP (Urban Police) | Local varies | Non-emergency |
| GNR (Rural Police) | Local varies | Non-emergency |

**112 works from any phone, even without SIM**

## Safety Overview

### Portugal is Very Safe
- 6th safest country in the world (2024 Global Peace Index)
- Violent crime rare
- Guns rare
- Terrorism risk very low

### Main Concerns
1. **Pickpocketing** — Tourist areas (Tram 28, Bairro Alto, Alfama)
2. **Car break-ins** — Don't leave valuables visible
3. **Scams** — Standard tourist scams exist
4. **Beach safety** — Atlantic currents, cold water

## Common Scams to Avoid

### Pickpockets
**Where:** Tram 28, Bairro Alto at night, crowded tourist spots
**Prevention:**
- Front pocket or money belt for valuables
- Don't flash expensive phones/cameras
- Watch bags in crowded areas

### Street "Gifts"
**What:** Someone offers "free" bracelet/flower, demands money
**Prevention:** Firmly say "não, obrigado" and keep walking

### Fake Petitions
**What:** Someone asks you to sign petition, then asks for money
**Prevention:** Don't engage

### Restaurant Couvert Surprise
**What:** Bread/olives placed on table, charged €5-10 unexpectedly
**Prevention:** Ask if it costs before eating, or refuse

### Taxi Scams
**What:** Long routes, "broken" meter
**Prevention:** Use Uber/Bolt (price locked), or insist on meter

### Drug Dealers
**What:** Aggressive offers in Bairro Alto, Rossio
**Prevention:** Firmly decline, keep walking. Often selling fake drugs anyway.

## Health

### Healthcare Quality
Good. Public and private hospitals meet European standards.

### EHIC/GHIC Card
If from EU/UK: Bring your European Health Insurance Card. Covers emergency public healthcare.

### Travel Insurance
**Highly recommended** even with EHIC:
- Private hospitals
- Repatriation
- Non-emergency care
- Stolen belongings

### Pharmacies
- **Farmácia** — Green cross sign
- Pharmacists helpful, can recommend for minor issues
- Some medications (antibiotics) require prescription

### Finding Medical Help
- **Minor issues:** Pharmacy first
- **Urgent:** Hospital urgências (A&E)
- **Private clinics:** Faster, English common

### Hospitals (English Likely)
**Lisbon:**
- Hospital de Santa Maria (public, large)
- Hospital CUF Descobertas (private)
- British Hospital (private, English)

**Porto:**
- Hospital de São João (public, large)
- Hospital da CUF Porto (private)

**Algarve:**
- Hospital de Faro (public)
- Hospital Particular do Algarve (private)

### Dental
Dentists available. Usually private. €50-100 for consultation.

### COVID & Vaccinations
- No COVID restrictions (as of 2024)
- No special vaccinations required
- EU Digital COVID Certificate no longer required

## Water Safety

### Tap Water
**Safe everywhere.** No need for bottled water (though locals often drink bottled).

### Beach Safety
**Atlantic Ocean = respect required**

**Flags:**
- 🟢 Green: Safe to swim
- 🟡 Yellow: Caution, some danger
- 🔴 Red: No swimming
- 🏴 Black: Beach closed
- 🏁 Checkered: Lifeguards absent

**Currents:** Rip currents exist. Swim parallel to shore if caught.

**Water temperature:** 17-22°C even in summer. Cold shock possible.

**Lifeguards:** Blue flag beaches staffed June-September

## Natural Hazards

### Heat
**Summer:** Can exceed 40°C inland (Alentejo, interior)
- Hydrate
- Avoid midday sun (12-16h)
- Sunscreen essential

### Wildfires
**August-September risk.** Usually not tourist areas.
- Follow local news
- Don't throw cigarette butts
- If smoke heavy: stay indoors, drive carefully

### Jellyfish
Occasional, usually not dangerous Portuguese man o' war (caravela portuguesa) rare but serious. Seek help if stung.

### Earthquakes
Portugal is seismically active (1755 Lisbon earthquake).
- Modern buildings earthquake-resistant
- Risk very low but exists
- In earthquake: Drop, Cover, Hold On

## Consulates

### Lisbon
- **US:** Av. das Forças Armadas
- **UK:** Rua de São Bernardo 33
- **Canada:** Av. da Liberdade 198-200
- **Australia:** Via UK consulate
- **Ireland:** Rua da Imprensa à Estrela 1-4

### Porto
- **UK:** Av. da Boavista 3072
- **US:** Via Lisbon

### Faro
Limited consular presence. Contact Lisbon.

## Lost/Stolen Items

### Passport Lost
1. Report to police (get report number)
2. Contact embassy/consulate
3. Emergency travel document issued

### Credit Cards Lost
1. Call bank immediately to block
2. Report to police
3. Keep report for insurance

### Phone Lost
1. Try Find My iPhone/Android
2. Block SIM (call provider)
3. Report to police for insurance
4. Change passwords (email, banking)

### Police Report
For insurance claims, you need a "Participação" (police report).
- Can file at any PSP station
- Tourist police may have English speakers
- Can take several hours

## LGBTQ+ Safety

**Portugal is very LGBTQ+-friendly:**
- Same-sex marriage legal since 2010
- Strong anti-discrimination laws
- Lisbon has large LGBTQ+ scene (Príncipe Real)
- Pride events in major cities

**No significant safety concerns** for LGBTQ+ travelers.

## Solo Female Travel

**Portugal is safe for solo female travelers:**
- Normal urban awareness applies
- Nightlife areas (Bairro Alto) can be pushy but not dangerous
- Public transport safe
- Beaches safe

**Standard precautions:** Tell someone your plans, avoid walking alone very late in isolated areas.

## Drug Policy

**Portugal decriminalized personal drug use in 2001.**
- Still illegal to possess/buy
- Not prosecuted as criminal if small personal amounts
- Dealers prosecuted
- Tourist advice: Don't buy from street dealers (often scams anyway)

## Travel Advisories

Check before travel:
- **US:** travel.state.gov
- **UK:** gov.uk/foreign-travel-advice
- **Canada:** travel.gc.ca
- **Australia:** smartraveller.gov.au

Currently: Portugal has no significant advisories.


path: memory-template.md
content: # Portugal Trip Memory

## Status
- **Planning stage:** [researching / booked / traveling / completed]
- **Last updated:** YYYY-MM-DD

## Trip Details
- **Dates:** 
- **Duration:** 
- **Regions:** [Lisbon / Porto / Algarve / Douro / Sintra / Azores / Madeira / Alentejo]
- **Travelers:** [solo / couple / family / group]
- **Kids:** [yes (ages) / no]

## Preferences
- **Travel style:** [foodie / beach / culture / adventure / relaxed / nightlife]
- **Budget:** [budget / mid-range / luxury]
- **Dietary:** [none / vegetarian / vegan / gluten-free / seafood-only / other]
- **Mobility:** [full / limited / wheelchair]

## Interests
- [ ] Food & wine
- [ ] Beaches
- [ ] Fado music
- [ ] History & architecture
- [ ] Surfing
- [ ] Hiking
- [ ] Nightlife
- [ ] Wine tours
- [ ] Day trips

## Places Visited/Planned

### Lisbon
- **Neighborhoods:**
- **Restaurants tried:**
- **Notes:**

### Porto
- **Areas:**
- **Port caves visited:**
- **Notes:**

### Other Regions
- **Places:**
- **Notes:**

## Bookings Made
| What | Where | Date | Confirmation |
|------|-------|------|--------------|
| | | | |

## Lessons Learned
- 

## For Next Trip
- 


path: setup.md
content: # Setup — Portugal Travel Guide

## First-Time Setup

When user mentions Portugal travel for the first time:

### 1. Create Memory Structure
```bash
mkdir -p ~/portugal
```

### 2. Initialize Memory File
Create `~/portugal/memory.md` using the template from `memory-template.md`.

### 3. Gather Trip Context
Ask naturally (not as a form):
- When are you traveling? (month matters for weather, crowds, festivals)
- How long is your trip?
- Which cities/regions interest you?
- What's your travel style? (foodie, beach, culture, adventure)
- Any dietary restrictions?
- Traveling with kids?

### 4. Save to Memory
Update `~/portugal/memory.md` with their answers.

## Returning Users

If `~/portugal/memory.md` exists:
1. Read it silently
2. Note any previous trips or preferences
3. Ask what's new or if plans changed
4. Update memory with new info

## Quick Start Responses

**"I'm going to Lisbon"**
→ Ask: How many days? Month? First time?
→ Then: Reference lisbon.md for neighborhood breakdown

**"Planning Portugal trip"**
→ Ask: Which regions? (Lisbon, Porto, Algarve, Douro, Azores, Madeira)
→ Suggest itinerary based on duration

**"Best restaurants in Porto"**
→ Check memory for dietary restrictions
→ Reference porto.md and food-guide.md

**"Where to see fado"**
→ Ask: Tourist show or authentic? Budget?
→ Reference culture.md and lisbon.md

## Important Notes

- Portugal is small but diverse — 1 week = Lisbon + Sintra + Porto realistic
- Summer (Jun-Aug) = crowded beaches, book ahead
- Shoulder season (Apr-May, Sep-Oct) = best weather/value
- Winter = mild in south, rainy in north, great for Madeira
- Always check if traveling during Santos Populares (June) — huge festivals in Lisbon/Porto


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: suspicious | SkillSpector: clean (LOW)