Document Types

git-lex uses kits to define document types. Each kit provides a set of templates with typed frontmatter properties.

Solo Kit

The solo kit ships with git-lex and is designed for personal knowledge management. Install it with:

git lex init --kit solo

General-purpose notes with topic linking.

solo:
  type: Note
  topic: "knowledge graphs"
  relatedTo: "[[other-document]]"

Property	Type	Description
topic	string	Primary topic
relatedTo	reference	Link to related document

People and organizations.

solo:
  type: Contact
  contactType: "person"
  relationship: "collaborator"
  squad: "engineering"
  email: "name@example.com"

Trackable work items.

solo:
  type: Task
  taskStatus: "active"
  priority: "high"
  blockedBy: "[[other-task]]"
  project: "git-lex"

Architectural and strategic decisions.

solo:
  type: Decision
  alternatives: "Option A, Option B"
  rationale: "Option A has better performance"
  outcome: "Chose Option A"

Property	Type	Description
alternatives	string	Options considered
rationale	string	Reasoning
outcome	string	What was decided
supersededBy	reference	Later decision that replaced this one

Investigation and analysis.

solo:
  type: Research
  researchStatus: "in-progress"
  hypothesis: "RDF scales for code graphs"
  findings: ""

Property	Type	Description
researchStatus	string	in-progress, complete, abandoned
hypothesis	string	What you’re investigating
findings	string	Results
references	string	Sources

Things to remember — facts, preferences, context.

solo:
  type: Memory
  confidence: "high"
  source: "direct observation"
  category: "technical"

Use @mentions and [[wikilinks]] in document bodies to create relationships:

These are extracted automatically from both document content and commit messages.