# VitaeContext

Canonical: https://renatomignone.github.io/projects/VitaeContext/
Editorial review: 2026-10-30

## VitaeContext

I co-created **VitaeContext** (formerly AgentKit SEO), an MIT-licensed open-source framework and MCP server that turns verified career context into scoped instructions for AI agents.

**Problem:** Give agents focused, reusable professional context without copying private files into every project.

**Contribution:** Co-creator with Elia Innocenti, working on context routing, structured memory and MCP integration.

**Result:** Released an MIT-licensed framework with eight skills, adapters for 11 environments, and a stateless Node.js MCP server.

**Scope and limitations:** A career-context framework; downstream factual quality still depends on maintained sources and human review.

**Technologies:** agent skills, context engineering, MCP server, VitaeGraph, Claude Code, Codex, Gemini CLI, OpenCode, npm

[Project](https://renatomignone.github.io/projects/VitaeContext/) · [Repository](https://github.com/vitaecontext/vitaecontext) · [Website](https://vitaecontext.github.io/) · [Usage documentation](https://vitaecontext.github.io/docs/usage/) · [npm package](https://www.npmjs.com/package/vitaecontext)

# Technical documentation

<div align="center">

<img src="https://raw.githubusercontent.com/vitaecontext/vitaecontext/main/.assets/image/banners/vitaecontext/vitaecontext-light.png" alt="VitaeContext - Keep your career context. Reuse it across AI." width="90%" />

<p><strong>Keep your career context. Reuse it across AI.</strong></p>

<p>VitaeContext gives AI agents a private, reusable source of truth about a person's career, then provides focused skills and a Model Context Protocol (MCP) server for turning that context into grounded professional work.</p>

<p>
  <a href="https://www.npmjs.com/package/vitaecontext"><img src="https://img.shields.io/npm/v/vitaecontext?style=flat-square&logo=npm&color=CB3837" alt="npm version" /></a>
  <a href="#modules"><img src="https://img.shields.io/badge/agent_skills-8-2563EB?style=flat-square" alt="8 agent skills" /></a>
  <a href="#mcp-server"><img src="https://img.shields.io/badge/mcp_server-2024--11--05-0EA5E9?style=flat-square" alt="MCP Server" /></a>
  <a href="https://github.com/vitaecontext/vitaecontext/actions/workflows/validate.yml"><img src="https://img.shields.io/github/actions/workflow/status/vitaecontext/vitaecontext/validate.yml?branch=main&style=flat-square&logo=githubactions&logoColor=white&label=build" alt="build status" /></a>
  <a href="https://github.com/vitaecontext/vitaecontext"><img src="https://img.shields.io/github/stars/vitaecontext/vitaecontext?style=flat-square&logo=github&label=stars" alt="GitHub stars" /></a>
  <a href="https://github.com/vitaecontext/vitaecontext/blob/main/LICENSE"><img src="https://img.shields.io/github/license/vitaecontext/vitaecontext?style=flat-square&label=license" alt="MIT license" /></a>
  <img src="https://img.shields.io/badge/formerly-AgentKit_SEO-1F684B?style=flat-square&labelColor=123C2D" alt="formerly AgentKit SEO" />
</p>

<p>
  <a href="https://vitaecontext.github.io/">Website</a> •
  <a href="https://github.com/vitaecontext/vitaecontext">Repository</a> •
  <a href="https://www.npmjs.com/package/vitaecontext">npm Package</a> •
  <a href="#why-vitaecontext">Why</a> •
  <a href="#how-it-works">How it works</a> •
  <a href="#mcp-server">MCP Server</a> •
  <a href="#vitaegraph">VitaeGraph</a>
</p>

</div>

---

## Role and Ownership

I co-created and maintain **VitaeContext** (formerly **AgentKit SEO**) with Elia Innocenti.

My work focuses on:
- **Context Routing & Architecture**: The core engine, validation gates, and export layer that turns raw career material into an evidence-bounded source of truth.
- **Model Context Protocol (MCP) Server**: The native stateless MCP server implementation allowing coding assistants (Claude Code, Cursor, Windsurf, Roo Code, Antigravity, IBM Bob, Grok) to query career facts and VitaeGraph without repo duplication.
- **VitaeGraph**: The hierarchical Markdown knowledge graph and progressive retrieval architecture for complex career records.
- **Provider Adapters**: Provider-specific skill packaging that lets tools such as Codex, Claude Code, Gemini CLI, Antigravity, and OpenCode load focused instructions.

---

## Why VitaeContext

> Formerly AgentKit SEO. The project grew beyond profile SEO into reusable career context for grounded AI work. The deprecated `agentkit-seo` command remains available as a compatibility alias and forwards to the VitaeContext CLI.

Every new AI chat starts with the same problem: the agent does not know which career facts are current, which claims have evidence, what role is being targeted, or how the output should change for each platform.

The usual result is repeated explanation, inconsistent profiles, generic writing, and occasionally invented claims.

VitaeContext applies the familiar `AGENTS.md` and `CLAUDE.md` pattern to professional identity. Its Context Builder skill turns a user's raw career material into a private Markdown source of truth called a **Career Context file**. Focused skills then adapt that file for LinkedIn, GitHub, CV/ATS, web portfolios, and X/Twitter.

The goal is simple:
- Explain professional context once instead of rebuilding it in every chat.
- Keep facts, goals, constraints, proof links, and claims to avoid in one reusable file.
- Adapt the same evidence to each platform without turning positioning into invention.
- Reuse the workflow across supported AI coding agents via standard Agent Skills or a stateless MCP server.

### The context layer before career automation

Many tools can draft a CV, tailor an application, write a message, or automate a career workflow. Those tools can only work from the career information they receive. When that input is scattered, stale, incomplete, or overstated, the same problems travel through the rest of the workflow.

VitaeContext sits one logical layer before those systems. It helps create and maintain the private, evidence-bounded Career Context file that an agent, CV builder, application workflow, or other career tool can use as its starting point.

---

## How it works

<p align="center">
  <img src="https://raw.githubusercontent.com/vitaecontext/vitaecontext/main/.assets/image/public-visuals/vitaecontext/basic-workflow.png" alt="VitaeContext workflow: scattered career material becomes a Career Context file, passes through VitaeContext platform skills, and produces grounded professional outputs" width="100%" />
</p>

1. **Gather the raw material.** Start with CVs, profile sections, GitHub and portfolio links, exports, screenshots, and project notes.
2. **Create the Career Context file with VitaeContext.** Give the raw material to an AI agent and invoke `vitaecontext-build`. The skill guides the agent in organizing the material into one private Markdown file containing verified facts, stated goals, constraints, proof links, and evidence boundaries.
3. **Load one focused skill or query via MCP.** Use the LinkedIn, GitHub, CV/ATS, web portfolio, or X/Twitter module for the surface being improved.
4. **Produce grounded work.** Get an audit, rewrite, patch proposal, or action plan based on the supplied context and platform guidance.

---

## Model Context Protocol (MCP) Server

<p align="center">
  <img src="https://raw.githubusercontent.com/vitaecontext/vitaecontext/main/.assets/image/public-visuals/mcp/mcp-workflow.png" alt="VitaeContext MCP: Stateless Model Context Protocol bridge between coding workspaces and private career facts" width="100%" />
</p>

VitaeContext provides a native, stateless MCP server over `stdio` using standard JSON-RPC 2.0. Any AI client supporting MCP can query your career context directly:

```json
{
  "mcpServers": {
    "vitaecontext": {
      "command": "npx",
      "args": ["-y", "vitaecontext-mcp"]
    }
  }
}
```

Exposed resources, tools, and prompts include:
- `career-context://current` and `vitaegraph://index`
- `get_career_context`, `search_vitaegraph`, and `validate_context`
- Built-in prompts for CV tailoring, LinkedIn profile audit, and portfolio optimization

---

## VitaeGraph: Structured Career Memory

<p align="center">
  <img src="https://raw.githubusercontent.com/vitaecontext/vitaecontext/main/.assets/image/public-visuals/vitaegraph/vitaegraph-diff.png" alt="Comparison between the compact Career Context file for fast facts and VitaeGraph for deep hierarchical records" width="100%" />
</p>

**VitaeGraph** is VitaeContext's deeper structured-memory layer. Use the Career Context file for compact, repeated facts and quick grounded drafts. Use VitaeGraph when an agent needs detailed records for projects, roles, degrees, courses, thesis work, certifications, awards, publications, and the relationships between them.

---

## Modules and Skills

VitaeContext ships one compact-context module, VitaeGraph, and five platform modules, coordinated by the root routing skill:

| Goal | Module | Description |
| --- | --- | --- |
| **Context Builder** | `vitaecontext-build` | Build the private, evidence-bounded Career Context source of truth |
| **VitaeGraph** | `vitaecontext-vitaegraph` | Build and validate a detailed local career knowledge graph |
| **GitHub** | `vitaecontext-github` | Optimize READMEs, pinned repositories, topics, and discoverability |
| **LinkedIn** | `vitaecontext-linkedin` | Structure headline, about, experience, and verifiable proof |
| **CV / ATS** | `vitaecontext-cv` | Tailor resumes for ATS parsing without inventing claims |
| **Web Portfolio** | `vitaecontext-portfolio` | Improve portfolio IA, schema markup, and AI-answer-engine readability |
| **X / Twitter** | `vitaecontext-x` | Shape technical positioning, bio, and content strategy |

---

## Agentic AI & Security Relevance

VitaeContext is directly connected to agentic AI systems engineering and security:
- **Context as a Control Surface**: It treats context, prompt boundaries, constraints, verified facts, and tool instructions as control surfaces.
- **Evidence Boundaries**: Prevents hallucination and overstatement by enforcing strict provenance and labeling.
- **Safe Multi-Provider Tooling**: Provides deterministic local-first execution across Claude Code, Codex, Gemini CLI, Antigravity, OpenCode, Cursor, and Windsurf.

---

## Public Links & Proof

- **Website**: [https://vitaecontext.github.io/](https://vitaecontext.github.io/)
- **Repository**: [https://github.com/vitaecontext/vitaecontext](https://github.com/vitaecontext/vitaecontext)
- **npm Package**: [https://www.npmjs.com/package/vitaecontext](https://www.npmjs.com/package/vitaecontext)
