GitResume Agent 🚀

Autonomous Git-Driven Resume & Portfolio Agent
A zero-touch agentic pipeline that perceives git diffs and codebase ASTs upon commit, synthesizes grounded Google XYZ accomplishment bullets with adversarial critique, and autonomously compiles role-tailored resumes directly to production portfolio endpoints.

💡 Why GitResume Agent?

As software and AI engineers, our codebases evolve every day — we ship features, refactor parsers, optimize vector retrieval latencies, and increase test coverage. Yet, our resumes remain static, outdated, and ungrounded.

GitResume Agent automates the entire lifecycle of engineering credentials as an event-driven CI/CD system:

1. Perception: Interrogates active Git repositories (commits, lines of code, test suites, and AST diffs) in < 5ms.
2. Schema Discovery: Dynamically detects tech stack additions and hackathon track changes from README.md files and package manifests, updating configuration in-place.
3. Reasoned Synthesis: Synthesizes quantified achievement bullets following the Google XYZ formula ("Accomplished X, measured by Y, by doing Z").
4. Adversarial Critique: Validates every cited metric and library against the commit AST to mathematically eliminate hallucinations.
5. Multi-Format Execution & Sync: Injects fresh bullets into Word (.docx) runs preserving exact styling, exports headless PDFs via COM automation, and syncs directly to your live portfolio website.

🤖 Truly Autonomous: How It Works

GitResume Agent operates on an event-driven, zero-touch autonomy loop:

                       ┌─────────────────────────────────────┐
                       │           DEVELOPER ACTION          │
                       │          `git commit -m "..."`      │
                       └──────────────────┬──────────────────┘
                                          │
                                          ▼ (Post-Commit Hook Trigger)
 ┌──────────────────────────────────────────────────────────────────────────────────┐
 │                          AUTONOMOUS AGENT PIPELINE                               │
 │                                                                                  │
 │  1. PERCEPTION           2. SCHEMA DISCOVERY      3. REASONING & SYNTHESIS       │
 │  ┌──────────────────┐    ┌──────────────────┐    ┌───────────────────────────┐   │
 │  │ InspectorAgent   │───▶│ SchemaDiscoverer │───▶│ SynthesizerAgent          │   │
 │  │ Git Log / AST    │    │ README & Badges  │    │ Flagship Ollama Cloud LLM │   │
 │  └──────────────────┘    └──────────────────┘    └─────────────┬─────────────┘   │
 │                                                                │                 │
 │                                                                ▼                 │
 │  5. DUAL-TIER SYNC       4. COMPILATION           4. ADVERSARIAL CRITIQUE        │
 │  ┌──────────────────┐    ┌──────────────────┐    ┌───────────────────────────┐   │
 │  │ Portfolio / Web  │◀───│ Docx & PDF Engine│◀───│ GroundingVerifierAgent    │   │
 │  │ Public Mirroring │    │ Headless Word COM│    │ AST / Metric Verification │   │
 │  └──────────────────┘    └──────────────────┘    └───────────────────────────┘   │
 └──────────────────────────────────────────────────────────────────────────────────┘

• Zero-Touch Git Hooks: Once installed, you never need to manually trigger compilation. Committing to any project repository automatically initiates background resume updates.
• In-Place Schema Auto-Sync: Adding a new framework to package.json or a hackathon badge to README.md automatically mutates gitresume.yaml idempotently.
• Deterministic Guardrails: Human governance controls initial role personas and target paths, while multi-agent execution handles perception, critique, and artifact compilation.

🏗️ Multi-Agent Architecture

Agent Roles:

• SchemaDiscoverer Agent: Parses project README.md files, badges, and manifests (package.json, pyproject.toml, requirements.txt). When you add a tool or win a hackathon track, it updates gitresume.yaml in-place.
• Inspector Agent: Interrogates git ls-files, git log, and test directories across 100K+ lines of code in < 5ms without traversal bottlenecks.
• Synthesizer Agent: Employs flagship coding LLMs (e.g. kimi-k2.7-code, deepseek-v4-pro, qwen2.5-coder) via Ollama Cloud or local Ollama to craft high-impact accomplishment bullets.
• Grounding Verifier Agent: Acts as an adversarial critic, verifying that cited frameworks and performance metrics are mathematically grounded in the git history.
• Persona Dispatcher & Compilers: Modifies specific paragraph runs in Word .docx documents preserving exact typography, triggers MS Word COM automation for pixel-perfect PDF export, and syncs directly to public portfolio directories.

📂 Where Generated Resumes Are Stored & Synced

GitResume Agent manages a dual-tier storage system defined in your gitresume.yaml:

1. Primary Master Directory (output.resume_dir)

• The primary folder where your master .docx templates and compiled .pdf files are stored.
• Keeps all role-specific persona documents organized (e.g. Forward_Deployed_Engineer.docx, GenAI_Engineer.docx, AI_Engineer.docx, Master_Resume.docx).

2. Public Web / Portfolio Sync (output.sync_paths)

• Mirrors compiled .docx and .pdf files directly to your live portfolio website (e.g. ./portfolio_site/public/resume), static site generator public folders, or CDN buckets.
• Every time you run git-resume sync (or make a git commit), your live portfolio immediately serves the freshest resumes.

⚡ Quickstart & Installation

1. Install via PyPI (Recommended)

pip install git-resume-agent

git clone https://github.com/Naman6019/git-resume-agent.git
cd git-resume-agent

# Create virtual environment
python -m venv .venv
.venv\Scripts\activate      # Windows (or `source .venv/bin/activate` on Linux/macOS)

# Install editable package
pip install -e .

2. Configure Environment (Optional LLM Keys)

Copy .env.example to .env:

# Option A: Ollama Cloud (Uses flagship cloud models without local download)
OLLAMA_BASE_URL=https://ollama.com
OLLAMA_API_KEY=your_ollama_api_key

# Option B: Local Ollama (100% Free, Offline)
OLLAMA_BASE_URL=http://127.0.0.1:11434

# Option C: Google Gemini Free Endpoint
GEMINI_API_KEY=your_gemini_api_key

🕹️ CLI Usage & Core Workflows

1. Live Codebase Intelligence Dashboard

Displays real-time commit counts, file statistics, total lines of code, test suites, and deployment status across all tracked repositories:

git-resume scan

Output:

                     GitResume Live Codebase Intelligence                      
┌───────────┬───────────────────────────┬──────────────────────────────────┬─────────┬───────┬───────────┬─────────────┐
│ Repos     │ Tag / Track               │ Status & Links                   │ Commits │ Files │ Total LOC │ Test Suites │
├───────────┼───────────────────────────┼──────────────────────────────────┼─────────┼───────┼───────────┼─────────────┤
│ FundersAI │ OpenAI Build Week         │ ● Deployed (https://www.fund...  │     410 │   752 │   132,449 │         142 │
│           │                           │ https://github.com/...           │         │       │           │             │
│ TalentOS  │ All Things Agentic        │ ● Deployed (https://all-thin...  │      56 │   130 │    22,348 │          26 │
│           │                           │ https://github.com/...           │         │       │           │             │
│ CareFlow  │ Clinical Research         │ ○ In-Repo                        │       3 │    77 │    10,410 │           7 │
│           │                           │ https://github.com/...           │         │       │           │             │
│ GitResume │ Autonomous Multi-Agent... │ ○ In-Repo                        │      17 │    22 │     2,554 │           1 │
│           │                           │ https://github.com/...           │         │       │           │             │
└───────────┴───────────────────────────┴──────────────────────────────────┴─────────┴───────┴───────────┴─────────────┘

2. Auto-Discover Schema & Stack from READMEs

Inspects configured repositories, sanitizes code blocks, discovers git origin remotes, and syncs newly added tech tools or hackathon tags into gitresume.yaml:

git-resume auto-config

3. Full End-to-End Multi-Agent Sync (All Projects at Once)

Runs the entire multi-agent pipeline across all projects simultaneously (Inspect $\rightarrow$ Synthesize $\rightarrow$ Verify $\rightarrow$ Compile .docx with clickable hyperlinks $\rightarrow$ Export .pdf via Word COM $\rightarrow$ Sync to Portfolio):

git-resume sync

4. Synthesize Grounded Achievement Bullets

Uses multi-agent reasoning over recent git commits to generate role-specific Google XYZ bullets:

# Generate bullet for Forward-Deployed Engineer role
git-resume generate --repo FundersAI --persona fde

# Generate bullet for Generative AI Engineer role
git-resume generate --repo TalentOS --persona genai

# Generate bullet for AI/ML Engineer role
git-resume generate --repo CareFlow --persona ai_engineer

5. Install Zero-Touch Git Post-Commit Hooks

Automatically wires up post-commit hooks across all repositories listed in gitresume.yaml:

git-resume install-hooks

➕ How to Add a New Repository to GitResume

Adding a new project to your resume pipeline takes less than 30 seconds:

Step 1: Add the Repository to gitresume.yaml

Add an entry under the repositories: section:

repositories:
  - name: MyNewProject
    path: C:/Users/yourusername/Desktop/MyNewProject
    repo_url: https://github.com/yourusername/MyNewProject   # Or leave blank for auto-discovery
    live_url: https://mynewproject.com                      # Optional (if deployed)
    deployed: true                                          # Set to true if live, false if in-repo

Step 2: Auto-Discover Schema & Tools

Run auto-config to inspect the project's README.md, package.json, or pyproject.toml and populate tags and tools:

git-resume auto-config

Step 3: Install Zero-Touch Git Hooks

Ensure background auto-sync is triggered every time you make a commit in the new repo:

git-resume install-hooks

Step 4: Re-Sync Resumes

git-resume sync

📄 Managing Resume Length: 1-Page vs 2-Page Persona Strategy

When you have 4+ active repositories, fitting everything onto a single page without overcrowding is a common challenge. GitResume supports Persona-Driven Project Budgeting (Strategy A):

                                  MASTER PIPELINE
                                         │
                 ┌───────────────────────┴───────────────────────┐
                 ▼                                               ▼
     🎯 1-PAGE TARGETED RESUMES                      📑 2-PAGE MASTER RESUME
    (fde, genai, ai_engineer)                               (master)
 ┌───────────────────────────────┐               ┌───────────────────────────────┐
 │ • 2 Flagship Projects (Full)  │               │ • All 4+ Projects (Full)      │
 │   - FundersAI (3 bullets)     │               │   - FundersAI (4 bullets)     │
 │   - TalentOS (3 bullets)      │               │   - TalentOS (3 bullets)      │
 │ • Compact Secondary Projects  │               │   - CareFlow (3 bullets)      │
 │   - CareFlow & GitResume      │               │   - GitResume (3 bullets)     │
 │     (1-line in-repo links)    │               │                               │
 └───────────────────────────────┘               └───────────────────────────────┘

1. Targeted 1-Page Resumes (fde, genai, ai_engineer)

• Flagship Focus: Dedicate full multi-line accomplishment bullets to your top 2 relevant flagships (e.g. FundersAI and TalentOS).
• Secondary / In-Progress Aggregation: Mention non-flagship projects (e.g. CareFlow, GitResume) as a single compact, high-impact bullet with clickable in-repo links (Repo: github.com/...).
• Bullet Count: Maintain 3 bullets for primary work experience and 3 bullets per flagship project.

2. Comprehensive 2-Page Master Resume (master)

• Full Coverage: Dedicate full sections and 3–4 quantified bullets to every project in your portfolio (FundersAI, TalentOS, CareFlow, and GitResume).
• Deep Architecture: Include full infrastructure breakdowns, CI/CD pipeline counts, and test suite metrics.

🔗 Clickable Native Word & PDF Hyperlinks

GitResume Agent automatically embeds native Word OpenPackaging XML hyperlinks (w:hyperlink elements) into .docx documents:

• Deployed Projects: Subheaders feature clickable Live and Repo links (e.g. Live: www.fundersai.co.in | Repo: github.com/Naman6019/FundersAI).
• Non-Deployed Projects: Subheaders feature clickable In-Repo links (e.g. Repo: github.com/Naman6019/CareFlow-Intelligence).
• PDF Preservation: When Word COM exports the .pdf during git-resume sync, all hyperlinks remain interactive across web browsers, PDF viewers, and ATS portals.

⚙️ Configuration (gitresume.yaml)

version: "1.0"

developer:
  name: "Naman Manocha"
  email: "namanmanocha6019@gmail.com"
  github: "https://github.com/Naman6019"
  linkedin: "https://linkedin.com/in/naman-d-manocha"
  location: "Mumbai, India"

# Repositories to inspect & ground
repositories:
  - name: FundersAI
    path: C:/Users/naman/OneDrive/Desktop/FundersAI
    tag: OpenAI Build Week Submission
    repo_url: https://github.com/Naman6019/FundersAI
    live_url: https://www.fundersai.co.in
    deployed: true
    primary_stack:
      - Python
      - FastAPI
      - React
      - TypeScript
      - Qdrant
      - PostgreSQL
      - Next.js
      - LangGraph

  - name: TalentOS
    path: C:/Users/naman/OneDrive/Desktop/ALLThingsAgentic
    tag: All Things Agentic Hackathon (Taskmaster Track)
    repo_url: https://github.com/Naman6019/all-things-agentic
    live_url: https://all-things-agentic--allthingsagentic-505213.asia-southeast1.hosted.app
    deployed: true
    primary_stack:
      - Python
      - Google ADK
      - LangGraph
      - Next.js
      - Firestore
      - Google Cloud Run

  - name: CareFlow
    path: C:/Users/naman/OneDrive/Desktop/CareFlow Intelligence
    tag: Clinical Research Intelligence
    repo_url: https://github.com/Naman6019/CareFlow-Intelligence
    deployed: false
    primary_stack:
      - Python
      - FastAPI
      - Next.js
      - TypeScript
      - ChromaDB

  - name: GitResume
    path: C:/Users/naman/OneDrive/Desktop/resume_automation
    tag: Autonomous Multi-Agent Resume & Portfolio Intelligence Engine
    repo_url: https://github.com/Naman6019/git-resume-agent
    deployed: false
    primary_stack:
      - Python
      - Typer
      - Rich
      - Ollama
      - Pytest
      - python-docx

# Resume Personas & Target Documents
personas:
  - id: fde
    title: Agentic AI / Forward-Deployed Engineer (1 Page)
    resume_file: Naman_Manocha_Agentic_AI_FDE_Resume.docx
    emphasis:
      - evals
      - hybrid-search
      - strict-abstention
      - production-agents
      - forward-deployed

  - id: genai
    title: Generative AI Engineer (1 Page)
    resume_file: Naman_Manocha_GenAI_Engineer_Resume.docx
    emphasis:
      - rag
      - vector-embeddings
      - langgraph
      - llm-pipelines
      - tool-calling

  - id: ai_engineer
    title: AI / ML Engineer (1 Page)
    resume_file: Naman_Manocha_AI_Engineer_Resume.docx
    emphasis:
      - mlops
      - benchmarks
      - latency-optimization
      - fine-tuning
      - rag-systems

  - id: master_1page
    title: Master Resume (1 Page)
    resume_file: Naman_Manocha_Master_1Page_Resume.docx
    emphasis:
      - full-stack
      - ai-agents
      - rag
      - applied-ml
      - production-systems

  - id: master
    title: Master Comprehensive Resume (2 Page)
    resume_file: Naman_Manocha_Master_Resume.docx
    emphasis:
      - full-stack
      - distributed-systems
      - ai-agents
      - production-architecture

# Dual-Tier Storage & Compilation Targets
output:
  formats:
    - docx
    - pdf
  resume_dir: C:/Users/naman/OneDrive/Desktop/Personal/Resume
  sync_paths:
    - C:/Users/naman/OneDrive/Desktop/Personal/portfolio_site/public/resume

# LLM Intelligence Engine
llm:
  provider: ollama
  model: kimi-k2.7-code
  fallback_model: gpt-4o-mini

🪝 Zero-Touch Git Hook Integration

How does the automation work on every commit? When you run git-resume install-hooks (or python scripts/install_hooks.py):

1. It reads your configured repository paths in gitresume.yaml.
2. Locates each repository's .git/hooks/ folder.
3. Installs an executable post-commit script that triggers git-resume sync in the background upon every commit.

git-resume install-hooks

Output:

🔧 Installing Git post-commit hooks...
  * ✓ Installed hook for [EnterpriseAI]: ./projects/EnterpriseAI
  * ✓ Installed hook for [AgentOS]: ./projects/AgentOS
✅ Successfully installed hooks across 2 repositories!

🧪 Testing

Run the automated unit test suite:

pytest tests/ -v

collected 5 items
tests/test_git_resume.py::test_load_config PASSED        [ 20%]
tests/test_git_resume.py::test_inspector_agent PASSED    [ 40%]
tests/test_git_resume.py::test_grounding_verifier PASSED [ 60%]
tests/test_git_resume.py::test_synthesizer_agent PASSED  [ 80%]
tests/test_git_resume.py::test_schema_discoverer PASSED  [100%]
====================== 5 passed in 0.62s ======================

📄 License

Distributed under the MIT License. See LICENSE for more information.

👤 Author

Naman Manocha — @Naman6019