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
• What it does
• How it works
• Privacy
• Requirements
• Install
• Connect your AI (Claude Code)
• Daily use
• Using it from the terminal
• Backups
• Project structure
• Customize and extend
• Contributing · License · Support

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.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗