jobtrackingapp/docs/planning/global-jobs-prompts/README.md

Jobjakt — International Job Discovery Codex Prompt Pack

This package contains one master prompt and nine standalone staged prompts for INT-GLOBAL-JOBS-01. It is for a cross-industry, country-aware, multilingual discovery system for Norway, Sweden and the UK initially, with explicit extension paths.

Recommended use

1. Use 00_MASTER_ORCHESTRATOR.md when you want Codex/Astra to understand the full roadmap and overall constraints.
2. Start with 01_GJ_00_DISCOVERY.md for planning, architecture, provider-rights audit and source access checks. Planning can be done before Phase 10 completion; do not implement until Phase 10/Product Review entry gates actually permit it.
3. Then run files 02 to 09 separately in order, only after the previous stage's acceptance and latest development baseline are verified. All implementation branches build on accepted predecessor development history, not on outdated main.
4. Each stage's instruction to commit and push is restricted to its feature/planning/test branch. No production/main merge or deployment.

Contents

File	Purpose
00_MASTER_ORCHESTRATOR.md	Overall master orchestration and universal requirements
01_GJ_00_DISCOVERY.md	Architecture, APIs, source rights, acceptance plan
02_GJ_01_PREFERENCES_I18N.md	Country, language and saved search defaults
03_GJ_02_GEOGRAPHY.md	Region/town refinements and optional radius
04_GJ_03_OCCUPATIONS.md	All-profession multilingual autocomplete and search
05_GJ_04_PROVIDERS.md	NAV/Swedish/UK sources, FINN manual fallback, rights
06_GJ_05_SEARCH_UI.md	Three-pane search, full permitted job description, actions
07_GJ_06_ALERTS_MATCHING.md	Saved searches, alerts, relevance and job-tracker integration
08_GJ_07_ADMIN_SECURITY.md	Provider/job sync monitoring, failures and secure logs
09_GJ_08_ACCEPTANCE.md	Final combined QA, source rights and rollout gating

What is deliberately not assumed

• No general FINN job-search API access without an approved business relationship.
• No ongoing commercial Adzuna integration before approval/licensing.
• No guaranteed full in-app descriptions from snippet-only providers.
• No production-grade NAV consumer token unless the consumer has actually registered.
• No new UI language shown as fully supported without complete translation and QA.
• No automatically enabled live AI model, scraping, auto job applications, merge to main or production deployment.

Official starting points (reverify when executing)

• NAV: https://navikt.github.io/pam-stilling-feed/ ; https://arbeidsplassen.nav.no/vilkar-api
• FINN: https://www.finn.no/api/
• Sweden JobAd Links: https://links.api.jobtechdev.se/
• Adzuna: https://developer.adzuna.com/docs/search ; https://developer.adzuna.com/docs/terms_of_service
• ESCO: https://esco.ec.europa.eu/en/use-esco/use-esco-services-api
• UK ONS: https://geoportal.statistics.gov.uk/