This is a text-based project that allows users to research and compare different countries based on various criteria for relocation purposes. The project is designed to be interactive, prompting users for input and updates as necessary.
Input folder contains all the input data required for this research.
Contains the user's background information, including nationality, age, family status, profession, education, language skills, and available documents. This information is crucial for evaluating relocation options and investigating the feasibility of different routes.
Basic configuration of countries, including a blacklist of countries that are not considered for relocation. Scope is expressed as a rule — all EU member states, minus the blacklist — not as a fixed list.
Details the available relocation routes, such as Digital Nomad Visa (DNV) and EU Blue Card, along with their requirements and conditions. This information is used to assess the feasibility of relocation to different countries based on the user's background.
List of criteria used.
Every criteria has its own configuration in criteria/<CRITERIA>.md file. This information is used by agent to correctly extract and interpret info from web.
Filenames match the keys in input/criteria.md exactly (route_availability.md, cost_of_living_rent.md, …). Each config gives the value shape, the normalization assumptions that keep the criterion comparable across countries, ranked preferred sources, a search strategy, and known pitfalls.
Each is a playbook in workflows/, with a thin slash-command wrapper in .claude/commands/.
- update countries list from web, prompt user for changes —
workflows/update-countries-list.md - for every criteria check for updates in web —
workflows/update-criteria.md - compare the new data with the old data and prompt user for changes —
workflows/review-changes.md - update summary —
workflows/update-results.md
Research writes proposals to .scratch/ (gitignored). Only review-changes writes facts into output/, and only after you confirm them.
Every country has it's own folder in output/ with files corresponding to criteria used.
Also, RESULTS.md should be generated to provide an overview of the relocation options and comparisons across different countries. It is generated by workflows/update-results.md as a view over the country files — never hand-edited. It does not exist yet.