Skip to content

v2.0.0: Seven-Pillar Ontology

Latest

Choose a tag to compare

@DavidROliverBA DavidROliverBA released this 31 Jan 07:28
· 29 commits to main since this release

ArchitectKB v2.0.0 - Seven-Pillar Ontology

A complete restructuring of how knowledge is organised in your architecture vault.

The Seven Pillars

Pillar Nature Location Purpose
Entities Things that exist Root Actors and objects in the world
Nodes Units of knowledge Root Understanding that persists
Events Things that happen Folders Temporal occurrences
Views Aggregated data Root Reports and dashboards
Artifacts External resources Attachments/ Reference materials collected
Governance Rules & standards Sync/ Policies and guardrails
Navigation Finding aids Root (_ prefix) Help locate content

Core Principle: Events happen TO entities and ABOUT nodes. Views aggregate data. Governance constrains decisions. Artifacts provide reference.

What's Included

Component Count Purpose
Claude Code Skills 62 AI-assisted workflows
Note Templates 32 Structured templates for all note types
Automation Hooks 11 Quality enforcement and workflow automation
User Guides 7 Comprehensive documentation

Key Changes

  • New pillar field - All notes now declare their pillar (entity, node, event, view, governance, navigation)
  • Relationship fields - nodeRelationships and entityRelationships on all content notes
  • Folder restructuring - Events in dedicated folders (ADRs/, Projects/, Tasks/)
  • Navigation prefix - MOCs and Dashboards use _ prefix for sorting
  • 12 new templates - Concept, Pattern, Capability, Theme, Location, ArchModel, Workstream, Forum, Email, Policy, Guardrail, and more

Breaking Changes

See CHANGELOG.md for complete migration guide including:

  • Folder renames (removed + prefix)
  • File renames (Person prefix, _ for navigation)
  • Frontmatter field additions

Quick Start

git clone https://github.com/DavidROliverBA/ArchitectKB.git
cd ArchitectKB
npm install
npm run vault:index

Then open in Obsidian and start with _Dashboard.md.