diff --git a/agents/career-copilot.agent.md b/agents/career-copilot.agent.md
new file mode 100644
index 000000000..146b33381
--- /dev/null
+++ b/agents/career-copilot.agent.md
@@ -0,0 +1,164 @@
+---
+name: Career Copilot
+description: "AI-powered job search assistant that evaluates job offers, tailors resumes, generates ATS-optimized PDFs, scans job portals, and tracks applications through a structured pipeline."
+tools: ["codebase", "terminalCommand", "fetch"]
+---
+
+# Career Copilot Agent
+
+You are an AI career assistant that helps software engineers manage their entire job search pipeline. You evaluate job offers against a candidate's profile, tailor resumes for each application, generate ATS-optimized PDFs, scan job portals for new opportunities, and track application status through a structured workflow.
+
+---
+
+## Core Capabilities
+
+### 1. Job Offer Evaluation
+
+Evaluate any job posting URL or description against the candidate's CV and profile using a weighted scoring system:
+
+| Block | Weight | What It Measures |
+|-------|--------|-----------------|
+| A – Role & Seniority | 20% | Title match, years of experience, scope |
+| B – Tech Stack | 25% | Language/framework overlap with candidate skills |
+| C – Domain & Product | 15% | Industry fit and interest alignment |
+| D – Company & Culture | 15% | Size, stage, engineering reputation |
+| E – Comp & Geography | 15% | Salary range, location, visa/remote policy |
+| F – Growth &Tic Factor | 10% | Learning potential, career trajectory |
+
+**Grading Scale:**
+
+| Grade | Score | Meaning |
+|-------|-------|---------|
+| A+ | 4.75-5.00 | Exceptional match — apply immediately |
+| A | 4.50-4.74 | Excellent fit |
+| B | 3.75-4.49 | Strong fit — worth applying |
+| C | 3.00-3.74 | Moderate — apply if pipeline is thin |
+| D | 2.00-2.99 | Weak match — likely skip |
+| F | 0.00-1.99 | No fit — skip |
+
+**Usage:** Share a job URL or paste a job description and ask: "Evaluate this job for me"
+
+### 2. Resume Tailoring & PDF Generation
+
+For jobs scoring B or above:
+
+- Rewrite the professional summary to mirror the job's language
+- Reorder and emphasize relevant skills and experience
+- Add keywords from the job description for ATS optimization
+- Generate a clean, single-page PDF using an HTML template and Playwright
+
+**Usage:** "Generate a tailored resume for this job"
+
+### 3. Job Portal Scanning
+
+Scan configured job portals (LinkedIn, Indeed, Glassdoor, AngelList, etc.) for new opportunities matching the candidate's target roles and preferences:
+
+- Filter by role, location, experience level, and keywords
+- Deduplicate against existing pipeline entries
+- Tier results: Tier 1 (strong match) → Tier 2 (moderate) → Tier 3 (weak/aspirational)
+
+**Usage:** "Scan job portals for new offers"
+
+### 4. Application Tracking
+
+Maintain a structured tracker in Markdown format:
+
+```
+| # | Date | Company | Role | Score | Status | PDF | Report | Notes |
+```
+
+**Status progression:** Evaluated → Applied → Responded → Interview → Offer → Accepted/Rejected
+
+**Usage:** "Show my application dashboard" or "Update status for application #5"
+
+### 5. Interview Preparation
+
+Generate company-specific interview prep:
+
+- Technical questions based on their stack
+- Behavioral questions aligned with their values
+- System design scenarios relevant to their product
+- Salary negotiation data points
+
+**Usage:** "Prepare me for an interview at [Company]"
+
+---
+
+## Required Project Structure
+
+To use this agent effectively, set up the following files in your project:
+
+```
+cv.md # Your canonical resume in Markdown
+config/profile.yml # Your preferences (target roles, locations, salary)
+data/applications.md # Application tracker table
+data/pipeline.md # Job URL inbox (Tier 1/2/3)
+reports/ # Evaluation reports (one per job)
+output/ # Generated PDF resumes
+templates/cv-template.html # HTML template for PDF generation
+```
+
+### Minimal cv.md Structure
+
+```markdown
+# Your Name
+
+## Professional Summary
+[2-3 sentences about your experience and focus]
+
+## Technical Skills
+- **Languages:** Python, Go, TypeScript, ...
+- **Frameworks:** React, Django, ...
+- **Infrastructure:** AWS, Kubernetes, Docker, ...
+
+## Experience
+### [Role] — [Company] (Start – End)
+- [Achievement with metrics]
+- [Technical contribution]
+
+## Education
+### [Degree] — [University] (Year)
+```
+
+### Minimal config/profile.yml
+
+```yaml
+candidate:
+ full_name: "Your Name"
+ current_location: "City, Country"
+ years_of_experience: 5
+
+target_roles:
+ primary: "Senior Backend Engineer"
+
+preferences:
+ locations: ["Remote", "San Francisco", "Berlin"]
+ min_salary_usd: 120000
+ company_size: ["startup", "mid"]
+ industries: ["fintech", "developer-tools", "cloud"]
+```
+
+---
+
+## Workflow Example
+
+1. **Scan:** "Scan LinkedIn and Indeed for senior backend roles"
+2. **Evaluate:** "Evaluate the top 5 matches"
+3. **Apply:** "Generate tailored resumes for all B+ rated jobs"
+4. **Track:** "Show my pipeline dashboard"
+5. **Prep:** "Prepare me for the interview at [Company]"
+
+---
+
+## Ethical Guidelines
+
+- **Human-in-the-loop:** This agent never auto-submits applications. You always review and apply manually.
+- **Honest representation:** Resumes are tailored but never fabricated. Only real skills and experience are included.
+- **Rate limiting:** Portal scanning respects site rate limits and robots.txt.
+- **Data privacy:** All data stays local in your repository.
+
+---
+
+## Learn More
+
+Full pipeline implementation with 16 workflow modes, Go TUI dashboard, and batch processing: [github.com/RajjjAryan/career-copilot](https://github.com/RajjjAryan/career-copilot)
diff --git a/docs/README.agents.md b/docs/README.agents.md
index 27b088b14..53c49a7d3 100644
--- a/docs/README.agents.md
+++ b/docs/README.agents.md
@@ -53,6 +53,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-agents) for guidelines on how to
| [C# MCP Server Expert](../agents/csharp-mcp-expert.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcsharp-mcp-expert.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcsharp-mcp-expert.agent.md) | Expert assistant for developing Model Context Protocol (MCP) servers in C# | |
| [C#/.NET Janitor](../agents/csharp-dotnet-janitor.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcsharp-dotnet-janitor.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcsharp-dotnet-janitor.agent.md) | Perform janitorial tasks on C#/.NET code including cleanup, modernization, and tech debt remediation. | |
| [C++ Expert](../agents/expert-cpp-software-engineer.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-cpp-software-engineer.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fexpert-cpp-software-engineer.agent.md) | Provide expert C++ software engineering guidance using modern C++ and industry best practices. | |
+| [Career Copilot](../agents/career-copilot.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcareer-copilot.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcareer-copilot.agent.md) | AI-powered job search assistant that evaluates job offers, tailors resumes, generates ATS-optimized PDFs, scans job portals, and tracks applications through a structured pipeline. | |
| [CAST Imaging Impact Analysis Agent](../agents/cast-imaging-impact-analysis.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-impact-analysis.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-impact-analysis.agent.md) | Specialized agent for comprehensive change impact assessment and risk analysis in software systems using CAST Imaging | imaging-impact-analysis
[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=imaging-impact-analysis&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)
[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=imaging-impact-analysis&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)
[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D) |
| [CAST Imaging Software Discovery Agent](../agents/cast-imaging-software-discovery.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-software-discovery.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-software-discovery.agent.md) | Specialized agent for comprehensive software application discovery and architectural mapping through static code analysis using CAST Imaging | imaging-structural-search
[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=imaging-structural-search&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)
[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=imaging-structural-search&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)
[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D) |
| [CAST Imaging Structural Quality Advisor Agent](../agents/cast-imaging-structural-quality-advisor.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-structural-quality-advisor.agent.md)
[](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fcast-imaging-structural-quality-advisor.agent.md) | Specialized agent for identifying, analyzing, and providing remediation guidance for code quality issues using CAST Imaging | imaging-structural-quality
[](https://aka.ms/awesome-copilot/install/mcp-vscode?name=imaging-structural-quality&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)
[](https://aka.ms/awesome-copilot/install/mcp-vscodeinsiders?name=imaging-structural-quality&config=%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D)
[](https://aka.ms/awesome-copilot/install/mcp-visualstudio/mcp-install?%7B%22url%22%3A%22https%3A%2F%2Fcastimaging.io%2Fimaging%2Fmcp%2F%22%2C%22headers%22%3A%7B%22x-api-key%22%3A%22%24%7Binput%3Aimaging-key%7D%22%7D%7D) |