VitaeContext
VitaeGraphGitHub

powered by VitaeContext

Deeper structured career context

Detailed career context, stored as connected Markdown records.

VitaeGraph organizes detailed projects, roles, education, courses, thesis work, credentials, awards, and publications as local Markdown records—and preserves meaningful relationships between them.

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

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

EV
Evidence

proof records

DETAIL
TH
Thesis

nested in degree

CO
Course

nested in degree

PR
Search tool

standalone project

PB
Publication

linked proof

Small, explicit graph. No hidden database required.

Load only relevant records

Use detailed context only when the task needs it.

Agent starts with graph summary, uses index to route, then opens smallest useful set of detailed records for 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 ↗