Booking GuidanceCAUTION

AI-powered travel hacking and search with cash, points, miles, and award flights. Drop-in skills and MCP servers for Claude, Codex, and OpenCode.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: booking-guidance
description: Step-by-step guidance for booking award flights. Covers the hold-before-transfer rule, phone numbers for major programs, and partner award booking workflows.
category: reference
summary: The booking flow, hold-before-transfer rule, phone numbers for major programs.
---

# Booking Guidance

Finding the deal is half the battle. Telling the user how to actually book it is the other half. **Every recommendation should include a booking path.**

**Reference data:** `data/alliances.json` has booking details for major programs in `key_booking_relationships`.

## Program Fee Profiles

**Check this before recommending a transfer or locking in a departure city.** Fees vary dramatically by program and origin airport and can add $100-700+ per person on top of the miles cost. Two things to keep in mind reading the table: (1) several programs are surcharge-free on their own metal and most partners but pass heavy surcharges on *specific* partners (notably British Airways metal) — the YQ column calls those out; (2) dollar figures are per direction and **scale with cabin** — economy surcharges are materially lower than the business-class figures shown for surcharge-heavy metal. Rows marked ⚠️ are high-surcharge programs that often lose to cash.

| Program | YQ Surcharge? | Typical fees/pp | Notes |
|---------|--------------|-----------------|-------|
| Aeroplan (Air Canada) | No | $50-100 | No YQ pass-through on Star Alliance partners. Low fees. Best for LH/LX/UA awards. |
| Flying Blue (AF/KLM) | Yes | ~$250-400/way economy, ~$489-600/way business, ex-CDG | AF passes full fuel surcharge; France adds heavy departure tax. Worst from Paris. |
| United MileagePlus | No | $50-100 | No YQ on most partners. |
| Virgin Atlantic | Yes (on VS metal) | Cabin-dependent: ~$150-300/way economy, ~$500-700/way Upper Class; low on Delta metal | Surcharges scale with cabin. Delta metal carries surcharges US↔UK specifically. |
| Turkish Miles & Smiles | No on UA/Turkish metal; YES on Lufthansa Group (LH/LX/OS/SN) | $20-50 (own/UA metal) | Extremely low on own/UA metal. Book by phone (online unreliable). Dec 2025 devaluation. |
| British Airways Avios | Yes | ~$200-400/way economy, ~$400-700/way business, BA long-haul metal | Notorious surcharges on BA metal. Use short-haul, or partner metal (AA/Alaska/Qatar), instead. |
| American AAdvantage | No on own metal + most partners; YES on British Airways & Iberia | $50-75 base; on BA/IB metal ~$200-400/way economy to $400-700+/way business | Surcharge-free on JAL/Cathay/Qatar. Route partner awards away from BA/Iberia metal. |
| Alaska / Atmos Rewards | No on own metal + most partners; YES on British Airways, Icelandair, Hainan | $25-75 base; on BA metal ~$150-400/way economy up to ~$1,000/way premium | Renamed from Mileage Plan (Aug 2025). Surcharge-free on Cathay/JAL/Qantas/Condor/Fiji. |
| Avianca LifeMiles | No | ~$25/ticket | No-YQ Star Alliance program. Predictable total even on ANA/Lufthansa/Swiss metal. |
| Iberia Plus (Avios) | Low (far less than BA) | ~$150-200 RT transatlantic business | The transatlantic Avios sweet spot: MAD-US business ~40.5K-59K Avios/way with modest surcharges. |
| JAL Mileage Bank | No on JAL metal | from ~$20 | Cheap distance-based partner chart. Partner metal (e.g. BA) may add YQ. |
| Qatar Privilege Club (Avios) | No fuel surcharge on Qatar metal | ~$30-100 per-segment fee | Excellent Qsuites value. Per-segment cash fee returned in 2025. |
| Delta SkyMiles | No | No award fees | Dynamic award pricing is the real cost, not fees. |
| ⚠️ ANA Mileage Club | Yes — heavy | ~$95-185/way US-Japan YQ | Round-trip booking only; no awards within 96h of departure. |
| ⚠️ Cathay / Asia Miles | Yes | High on long-haul; hiked again in 2026 | Passes full carrier-imposed surcharges. |
| ⚠️ Emirates Skywards | Yes — heavy | Among the highest YQ of any program | Surcharges often kill the redemption vs cash. |

**Key rule:** If the trip ends in Paris or London, or routes on Air France / BA / Virgin / Emirates metal, factor $300-700/pp *per direction* in fees before comparing programs. A 40K Flying Blue award from CDG often costs more in cash fees than a 50K Aeroplan award from FRA. When a program passes surcharges only on *specific* partners (AA/Alaska on BA metal, Turkish on Lufthansa Group), route around that metal to keep fees low.

## General Booking Flow

1. **Find availability** (Seats.aero, airline website, or MCP tool)
2. **Verify the program you want to book through** shows the same availability
3. **If transferring points:** get a HOLD on the award ticket FIRST, then transfer
4. **Transfer points** from credit card to loyalty program
5. **Call or go online** to complete the booking

## Critical Rule: Never Transfer Without a Hold

**Transfers are instant with most programs but IRREVERSIBLE.** If availability disappears between the transfer and the booking, points are stuck in the loyalty program.

The right order:
1. Find the award and put it on hold (24-72 hours typically) through the booking program
2. THEN transfer points from the credit card
3. THEN complete the booking against the held space

**Critical caveat: hold rules vary widely and change.** Always check the `award-holds` skill (data file `data/award-holds.json`) for current per-program rules. As of April 2026: AA holds 24h online (free), Lufthansa M&M 5 days, Flying Blue 3 days ($25 phone fee at ticketing), Cathay Asia Miles 2 days ($39 phone fee), Turkish 2 days, Virgin Atlantic 1-2 days (free, phone), Singapore agent-discretionary. Programs that DO NOT allow holds: United, Alaska, Delta, BA, Aeroplan, ANA, Qatar, Korean. The "hold first, transfer second" pattern works wherever a hold is available.

When holds aren't available, transfer in small batches if you're confident the space will hold (high seat counts, low-popularity dates), or accept the risk. Never transfer your full balance speculatively.

## Phone Numbers for Major Programs

Some awards 

CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (5)

.agents/skills

.claude/skills

.opencode/skills

skills

AGENTS.md

Gates applied: no_behavioural_pass.