Nomad Pro – UK Residency Tracker

use this when running the scheduled check-in, when the user says where they were or what they did, when they come back after missed days, when they ask "check my week", when the check-in rhythm changes, or when they ask to change how often the calendar review runs.

use this when the user asks for the dashboard, an overview, charts, a picture of their year or "where do I stand" in counts, and after onboarding and each export.

use this when the user asks "where should I go next?", "where could I spend the winter?" or a similar open destination question; never during onboarding.

use this when Nomad Pro is used for the first time (before onboarding), whenever a tool under ~/nomad-pro-engine is missing or errors on import, and once a week to check for an engine update.

use this when attaching evidence to days (Gmail links, screenshots, bank exports), when the user sends a file or says where a record is, when filing status documents (contract, termination notice, tenancy end), or when they say they work full-time overseas.

use this when the user asks for their records, a PDF, a CSV, an export or something for an accountant or adviser, and at the 7 April year-end lockdown for the tax year just ended.

use this when the weekly HMRC guidance routine runs, when the user asks whether HMRC's SRT guidance has changed, or before citing a page that hasn't been checked this week.

use this when the user is leaving the UK (or has just left) and asks what to sort out ("give me the leaving-the-UK checklist", "what do I tell HMRC, my GP, the council?"), or is coming back to live in the UK (arriving variant).

use this when doing anything as Nomad Pro: read it before every reply that states a count, an HMRC rule, a visa or stay limit, or closes with a disclaimer, and whenever another skill says "core rules".

use this when this bot has just been imported and is talking to its new owner for the first time, or when the owner says "set me up" or "start again".

use this when a new user starts Nomad Pro, or asks to set up, redo or complete their profile, history, ties, work-day rule, record sources, connections, calendar rules, upcoming trips or backfill; it ends by creating the routines.

use this when the monthly backup routine runs, when the user asks for a backup or copy of all their records, or asks how to restore them.

use this when the user wants everything in one bundle for one or more tax years, e.g. "HMRC is enquiring, build a pack for 2024/25 and 2025/26", "my accountant wants all my records", "zip up my records".

use this when the user asks how the Statutory Residence Test works, what a term means (tie, midnight rule, split year, transit day), or asks "how does that work?" about their circumstances, e.g. "I'm still on my UK GP register, how does that work?".

use this when the user mentions a trip or destination, arrives in a new country, the weekly travel-rules routine runs, or they ask about visa or stay limits (Schengen 90/180, Cyprus, Thailand and others).

use this when the user wants to model or compare proposed trips, asks how many UK or Schengen days they have left, asks "where can I go?", or is planning a UK visit or next tax year.

use this when the yearly 7 April year-end routine runs, when the user asks to lock down, close or finalise a tax year, or wants to change a day in a locked year.

Keeps the day log current by catching up any missed days and asking the four check-in questions at the owner's chosen rhythm.

Watches entry rules, stay limits and document expiry dates for the owner's current and planned countries, and speaks up only when a rule changes or a trip or document comes close to a limit.

Keeps the Nomad Pro engine and the owner's copy of HMRC's residence guidance up to date, and reports only real wording changes and what they do to the counts.

Turns the owner's calendar (and Gmail, if connected) into proposed day rows since the last review for them to confirm, weekly by default or fortnightly, monthly or quarterly as they choose; only if Google Calendar is connected.

Every 7 April, books a short session with the owner to check and lock down the facts for the tax year that just ended, then makes the final Travel and day log.

On the 1st of each month, makes a checked backup of all the owner's Nomad Pro records and sends it to them (and to their Google Drive folder, if they chose that), with a one-line summary.