System architecture

How the context layer fits.

VitaeContext sits between selected career material and the agents or systems that use it. Context stays portable; task execution stays downstream.

Read the source design See how it works

Product model

Context and execution stay separate.

VitaeContext maintains the grounded input. Downstream systems own the task method and final output.

Supplied material

CVs, profiles, projects, links, notes, goals, and constraints selected by the person.

Career Context

A maintained Markdown file stores reusable facts, intent, evidence boundaries, and claims to avoid.

Controlled access

A bounded summary, direct file, or stateless MCP server exposes only the context needed for the task.

Downstream systems

Career agents and tools apply their own methods to produce CVs, applications, profiles, and other work.

Canonical project facts

One project, package, and source.

VitaeContext is the current project identity. The public implementation is open source under the MIT license, and the website mirrors the package rather than defining separate runtime behavior.

Project and package: VitaeContext · vitaecontext · version 2.3.0
Canonical source: github.com/vitaecontext/vitaecontext
License: MIT License
Creators and maintainers: Renato Mignone and Elia Innocenti

Progressive disclosure

Retrieve the smallest useful context.

Most tasks need the compact Career Context file or a bounded summary. VitaeGraph adds selected deep records only when a task needs more detail.

request
  └── Career Context
      ├── bounded task summary
      └── selected VitaeGraph records
          └── downstream workflow

Evidence vocabulary

Make certainty visible.

Shared labels stop inference, goals, and inaccessible material from being presented as verified experience.

Project fact: Confirmed by current package source or maintained project documentation.
Supplied career fact: Taken from user-provided or inspected material; not independently authenticated by VitaeContext.
From source: Taken from another supplied source.
Inference: Reasoned from evidence but not directly observed.
Inaccessible: Could not be inspected.
Needs evidence: Should not become a public claim yet.

What the system does not guarantee

VitaeContext does not authenticate every real-world claim or guarantee rankings, recruiter attention, visibility, or career outcomes. Generated work still requires human review.