JobAgent

A polyglot (Go + Python) system that combines a rules engine with an AI agent orchestrator for intelligent job-application management. Both a real tool for managing a job search and a portfolio project demonstrating systems engineering.

Architecture

                    ┌──────────────────────┐
                    │      CLI / API       │
                    └──────────┬───────────┘
                               │
              ┌────────────────┴────────────────┐
              ▼                                  ▼
┌──────────────────────┐          ┌──────────────────────────┐
│  Rules Engine (Go)   │  score   │ Agent Orchestrator (Py)  │
│                      │ ───────▶ │                          │
│  - JD parsing        │          │  - Resume tailoring       │
│  - Skill matching    │          │  - Cover letter gen       │
│  - Gap analysis      │          │  - Referral lookup        │
│  - Fit scoring       │          │  - Interview prep         │
│  - Priority ranking  │          │  - Status tracking        │
└──────────────────────┘          └──────────────────────────┘
     :8080 (REST/gRPC)                    Claude API

The Go rules engine is the decision layer: it parses job descriptions, matches skills, scores fit with confidence weighting, and ranks opportunities. The Python orchestrator is the execution layer: it drives AI-powered resume tailoring, cover-letter generation, and application tracking.

Project structure

jobagent/
├── rules-engine/    Go service (decision layer) — scoring, matching, ranking
├── orchestrator/    Python service (execution layer) — AI workflows, tools
├── rules/           YAML rule definitions
├── taxonomy/        skill / role taxonomy
├── jobs/            job-search data
└── docs/            architecture and design decisions

Build & run

Rules engine (Go)

cd rules-engine
go run cmd/server/main.go        # dev server on :8080
go test ./...

Orchestrator (Python)

cd orchestrator
# see docs/ for environment setup and workflow configuration

Tech stack

Go · Python · Claude API · REST/gRPC · YAML rule definitions

Status

Active development.