remote-ready 🌍

Your AI career coach for remote & relocation jobs — works out of the box in Claude Code or Codex.

Azərbaycanca oxu → README.az.md

Finding a remote or relocation job is not "send 300 CVs and pray". It's a project with a strategy. This repo turns your AI coding agent into a career coach that runs that strategy with you — built on the mentorship framework of Ilkin Alibayli (Head of Engineering in Berlin, went the Baku → Germany path himself).

The idea in one picture

        ┌─────────────────────────────────────┐
        │        workspace/  (your data)      │
        │  profile.json — who you are         │
        │  okr.md       — goals + deadlines   │
        │  progress.json— what you've done    │
        │  roadmap.html — your visual journey │
        └──────────────┬──────────────────────┘
                       │ reads / writes
        ┌──────────────▼──────────────────────┐
        │   Claude Code / Codex  + CLAUDE.md  │
        │   (the coach: 7-step framework)     │
        └──────────────┬──────────────────────┘
                       │ public pages only, no login
        ┌──────────────▼──────────────────────┐
        │  Playwright MCP → LinkedIn Jobs,    │
        │  RemoteOK, WWR, relocate.me ...     │
        └─────────────────────────────────────┘

The 7 steps: Goal → OKR → Gap Diagnosis → Hard Skills → English & Soft Skills → CV + STAR → Application Campaign.

Quickstart (5 minutes)

The lazy way — tell your agent:

Clone github.com/ilkin007/remote-ready and start working inside it.

Or by hand:

git clone https://github.com/ilkin007/remote-ready.git
cd remote-ready
claude        # or: codex

Say hi. The coach will ask which language you prefer (Azərbaycanca / Русский / English), then interview you (or parse the CV you drop into workspace/), build your OKR plan, and generate workspace/roadmap.html — open it in a browser and watch your progress fill in over the weeks.

Optional but recommended — job search on live boards needs Playwright MCP:

claude mcp add playwright -- npx -y @playwright/mcp@latest

What you can say to it

• "Find me matching jobs" — scans public LinkedIn Jobs, RemoteOK, WeWorkRemotely, relocate.me; scores each posting against your profile, names your top-3 gaps.
• "I finished the Kubernetes course" — logs it, updates your roadmap.
• "Rewrite my CV for this posting: " — ATS-friendly rewrite, honest verdict.
• "What should I learn next?" — books / YouTube / Coursera / Udemy for your exact gaps, in your language.
• "Interview me" — behavioral (STAR) or technical mock, with feedback.

Privacy & safety

• Your data lives only in workspace/ on your machine — gitignored, never sent anywhere.
• Job search uses public pages only. The agent will never ask for your LinkedIn login, never auto-apply, never touch captchas. Your accounts stay safe.
• No backend, no database, no API keys in this repo. Plain files you own.

Want the same framework with a human?

This repo is the self-service version of my mentorship program. If you want to walk it together — mock interviews, CV reviews, accountability calls — find me at ilkinalibayli.com.

License

GPLv3 — free forever, keep it open.