knowledge-architecture

Knowledge Architecture

Organize knowledge by being, not bureaucracy.

Ontological Foundations

The Problem with Arbitrary Categories

Most knowledge systems fail because they organize by:

• Convention: "This is how it's always been done"
• Convenience: "This was easiest at the time"
• Accident: "It just ended up here"

Result: Knowledge fragments. Connections hide. Understanding atrophies.

Ontological Alternative

Organize by asking: What is this thing, essentially?

Not "where should this file go?" but "what is the nature of this entity, and what does it relate to by that nature?"

Categories of Being

Substances (Primary Entities)

Things that exist in themselves, not as properties of other things.

Category	Examples	Identifying Question
Persons	You, collaborators, mentors	Who acts?
Projects	in-midst-my-life, AI Council	What is being built?
Tools	Claude, Figma, modular synth	What enables action?
Works	Essays, code, art pieces	What has been created?
Concepts	Ideas, theories, frameworks	What is understood?

Properties (Dependent Entities)

Exist only as aspects of substances.

Category	Examples	Identifying Question
States	In-progress, complete, abandoned	What phase?
Qualities	Elegant, experimental, stable	What character?
Relations	Depends-on, extends, contradicts	How connected?
Measures	Size, duration, complexity	What quantity?

Events (Temporal Entities)

Things that happen, with beginning and end.

Category	Examples	Identifying Question
Actions	Decisions, commits, publications	What was done?
Processes	Learning, building, evolving	What unfolds?
Occasions	Meetings, deadlines, milestones	What marks time?

Structural Principles

Essential vs. Accidental Properties

Essential: What makes the thing that thing. Remove it, and it's something else. Accidental: Could be otherwise without changing identity.

Example: A "portfolio website"

• Essential: Displays work, represents identity
• Accidental: Uses React, hosted on Vercel, blue color scheme

Organizing principle: Group by essential properties. Tag/filter by accidental.

Genus and Differentia

Classical definition structure: "A is a B that C"

Project
├── Software Project (produces code)
│   ├── Library (produces reusable code)
│   ├── Application (produces usable program)
│   └── Infrastructure (produces enabling system)
├── Creative Project (produces art/writing)
│   ├── Visual Work (produces images)
│   ├── Written Work (produces text)
│   └── Interactive Work (produces experience)
└── Research Project (produces knowledge)
    ├── Academic (produces citable work)
    └── Applied (produces practical insight)

Relations as First-Class Citizens

Don't bury relations in properties. Make them navigable.

Relation Type	Meaning	Inverse
depends-on	Cannot exist without	enables
extends	Builds upon foundation	is-extended-by
contradicts	In tension with	is-contradicted-by
implements	Realizes abstraction	is-implemented-by
exemplifies	Is instance of pattern	is-exemplified-by
supersedes	Replaces previous	is-superseded-by

Architecture Patterns

The Atomic Note

Each note captures ONE thing:

• One concept
• One decision
• One reference
• One connection

Connections emerge from linking atoms, not from cramming compounds into single containers.

The Index Pattern

Create navigational hubs, not hierarchical folders.

# Project Index

## By Nature
- [[Software Projects]]
- [[Creative Projects]]
- [[Research Projects]]

## By State
- [[Active Work]]
- [[Completed Work]]
- [[Archived Work]]

## By Relation
- [[Dependencies Map]]
- [[Influence Graph]]

The Context Layer

Same entity, different contexts:

/entities/project-alpha.md          # The thing itself
/contexts/technical/project-alpha.md  # Technical view
/contexts/business/project-alpha.md   # Business view
/contexts/personal/project-alpha.md   # Personal meaning

The Temporal Layer

Knowledge changes. Track it:

/current/concept-x.md      # Current understanding
/history/concept-x/        # Evolution
  ├── 2024-01-understanding.md
  ├── 2024-06-revision.md
  └── changelog.md

Naming Conventions

Entity Naming

[type]-[identifier]

project-in-midst-my-life
concept-modular-synthesis
person-mentor-name
tool-claude-desktop

Relation Naming

[source]--[relation]--[target]

project-alpha--depends-on--library-beta
concept-x--contradicts--concept-y

State Naming

[entity].[state-type]

project-alpha.status = active
project-alpha.phase = development
project-alpha.health = stable

Cross-Domain Integration

The Translation Pattern

Same concept, different domain vocabularies:

concept: feedback-loop
domains:
  synthesis: "output patches to input, creating evolving timbre"
  systems: "output affects input, creating dynamic behavior"
  learning: "results inform practice, creating improvement"
  biology: "effect influences cause, creating homeostasis"

The Isomorphism Pattern

Find structural similarities across domains:

Modular Synthesis     ←→     Software Architecture
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Oscillator            ←→     Data Source
Filter                ←→     Transformer
Patch Cable           ←→     API Connection
Mixer                 ←→     Aggregator
CV                    ←→     Configuration
Audio Signal          ←→     Data Payload

The Emergence Pattern

Document what emerges from combination:

Component A + Component B = Emergent Property C

# Example
Note-taking + Linking + Time = Evolving understanding
(None of the parts alone produces this)

Implementation

File System Mapping

knowledge/
├── entities/           # Primary substances
│   ├── projects/
│   ├── concepts/
│   ├── works/
│   └── tools/
├── relations/          # Connection maps
│   ├── dependencies.md
│   ├── influences.md
│   └── contradictions.md
├── contexts/           # Perspective layers
│   ├── technical/
│   ├── personal/
│   └── temporal/
├── indices/            # Navigation hubs
│   ├── by-nature.md
│   ├── by-state.md
│   └── by-domain.md
└── meta/               # About the system itself
    ├── ontology.md
    ├── conventions.md
    └── changelog.md

Metadata Schema

---
type: [entity-type]
nature: [essential description]
state: [current state]
created: [date]
modified: [date]
relations:
  depends-on: [list]
  extends: [list]
  relates-to: [list]
contexts: [list of applicable contexts]
tags: [accidental properties for filtering]
---

References

• references/ontological-terms.md - Philosophical vocabulary
• references/implementation-patterns.md - Concrete file/linking patterns