Professional Twin
An AI-powered professional twin framework built on Claude Code.
It knows your experience, applies your criteria and works with you from a business need to a delivered solution —
while it quietly turns everything you do into evidence for your CV and your career plan.
English · Español
▶ Interactive tour: maibp.github.io/professional-twin
Table of contents
What it is
Professional Twin is a private, local-first workspace that turns Claude Code into your professional twin. It plays three roles at once:
| Role | What it does for you |
|---|
| 🤝 Co-worker | Analyses needs, plans, documents, builds prototypes, code, dashboards and presentations. |
| 🧭 Mentor | Challenges your ideas with good practices, flags risks and shows how someone one level above would do it. |
| 📝 Career chronicler | Logs every achievement with evidence, so your CV and career plan build themselves. |
It comes with a friendly web app for non-technical people: no commands, no prompts to write — just buttons, forms and a chat. Power users can drive the very same twin from the terminal.
What it does
- Profile from your CV. Upload your CV and certificates; the twin reads them and fills in your profile, working style and career goals with a short interview.
- From business need to product. Describe a problem in your own words. The twin opens a project and walks it through seven phases — asking the questions a good consultant would ask, proposing a solution, and building it with you. Nothing moves forward without your approval.
- Document past work. Point it at a folder (or upload files) of something you already delivered; it analyses the material and builds the project's map and portfolio entry.
- Interactive project maps. Every project gets a fact sheet and an interactive architecture diagram (zoom, click a piece to see its details, animated data flows), exportable to PDF.
- Achievement log → CV. Achievements are written as action + result, with skills, tools and evidence. Generate tailored CVs (Markdown + PDF) for a role or a specific job offer.
- Job offers. Paste an offer: you get a fit score, gaps, how to present yourself honestly, plus a tailored CV, cover letter and interview prep. Track each application's status.
- Mentoring. Career sessions that review progress against your target role and update your growth plan.
- English or Spanish, light or dark. Switch both from Settings.
How it works
The twin has two halves that work on the same plain Markdown files on your computer:
- The brain — Claude Code. It understands, asks, proposes, builds and logs. Its identity and method live in
CLAUDE.md and its abilities in .claude/skills/.
- The window — a local web app. It shows your profile, projects, log and CVs, lets you upload and edit with forms, and runs the brain for you in the background when you press a button or chat.
A project's journey
What happens when you press a button
Privacy
Privacy is a design principle, not an add-on.
- Your content never goes to git. The private folders are in
.gitignore; the code you clone contains only empty templates.
- Local-only server. The app listens on
127.0.0.1 (not reachable from other machines), only reads and writes inside your private folders, and requires a custom header for every write.
- What reaches the AI. When the twin works on a task, Claude Code sends the content it needs to read to Claude (Anthropic) for processing — the same as using Claude directly — under your own account and its terms. Before uploading company material, remove personal data of customers or employees that isn't needed.
- No credentials stored by the app. Signing in is handled by Claude Code itself.
- Bring your own account. If your Claude account belongs to your employer, consider connecting a personal one for career content (CV, job offers).
- Guard-rails for the twin. It never invents achievements, figures or certifications, doesn't run scripts found in your material, and leaves out unnecessary personal data in deliverables meant for others.
Requirements
| Tool | Why | Get it |
|---|
| Node.js 20+ | Runs the local app | nodejs.org |
| Git | Download the project (or download the ZIP from GitHub) | git-scm.com |
| Claude Code | The twin's brain | claude.com/claude-code |
| A Claude account | Claude Pro, Max, Team or Enterprise subscription, or an Anthropic Console account (pay as you go) | claude.ai · console.anthropic.com |
| Microsoft Edge or Google Chrome | PDF export of CVs and project maps | usually pre-installed |
Works on Windows (desktop shortcut included), macOS and Linux.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
