VitaeContext
VitaeGraphGitHub

powered by VitaeContext

Deeper structured career context

Detailed career context, stored as connected Markdown records.

VitaeGraph is VitaeContext's optional deeper layer for detailed career material. It stores projects, roles, education, courses, thesis work, certifications, awards, and publications as connected local Markdown records; generated JSON indexes are deterministic and rebuildable.

VitaeContext gives agents the compact overview. VitaeGraph is the optional deeper layer for tasks that need specific records and connections.

It is not a résumé or an independent proof system. Validation checks record structure, IDs, and links; it does not authenticate whether a real-world claim is true.

Published . Specification reviewed .

Set up VitaeGraphSee the record modelRead specification
  • MD Markdown canonical
  • Hierarchy + cross-links
  • ⌂ Local-first

Sample career knowledge graph · drag to explore

Separate Markdown records

Store detailed career material in focused files.

Each record is a focused Markdown file with stable identity and substantive prose. Add only domains supported by available material; leave unsupported claims out and keep useful open questions visible.

MDprojects/local-search-tool/project.mdcanonical record

---

type: project

id: project:local-search-tool

title: Local search tool

status: active

visibility: private

related_records:

- thesis:search-retrieval

---

# Local search tool

## Executive summary

What the project does, why it exists, and the person’s supported contribution.

Clear record relationships

Keep career records connected.

VitaeGraph uses hierarchy for real containment and cross-links for meaningful connections. Markdown paths stay understandable to people; stable record IDs let generated indexes rebuild those edges deterministically.

Contains
A thesis or university course belongs to its degree.
Related to
A project can connect to a role, thesis, publication, or other relevant record.

VitaeGraph keeps related career records connected while the Markdown files remain readable on their own.

ROOT
VG
VITAEGRAPH.md

identity + direction

DOMAINS
ED
Education

degree record

PR
Projects

project records

EX
Experience

role records

CT
Certifications

credential records

DETAIL
TH
Thesis

nested in degree

CO
Course

nested in degree

PR
Search tool

standalone project

PB
Publication

related record

Small, explicit graph. No hidden database required.

Load only relevant records

Use detailed context only when the task needs it.

An agent starts with the graph summary, uses the index to route, then opens the smallest useful set of detailed records for the current task.

  1. 01OrientVITAEGRAPH.md

    Read graph-level direction and restrictions.

  2. 02Routeindex.md

    Find smallest relevant record set.

  3. 03Retrieveselected records

    Open only detail needed for current task.

  4. 04Applyfocused skill

    Use deeper context without changing facts.

TASKTailor a CV for one role
SELECTED DEPTH2 roles · 1 project · 1 degree
GROUNDED INPUTRelevant records, not whole graph

Set up VitaeGraph

Initialize the files, add material, then validate.

CLI creates empty structure, checks records and links, then generates rebuildable local indexes. It does not invent or automatically verify career claims.

  • Markdown stays canonicalgraph.json, search index, and diagnostics are caches.
  • Private by defaultUser graph lives outside package and installed skills.
  • Optional by designCompact career context file remains independently useful.
VitaeGraph quick start
$ npx vitaecontext graph init

$ npx vitaecontext graph validate

$ npx vitaecontext graph index
Markdown canonical · indexes rebuildable
PART OF VITAECONTEXTOne career context. More depth when work demands it.
Install VitaeContextRead CLI guideOpen specification ↗