Back to the catalog

knowledge-bricks — the EOS Knowledge Base

Bundle OKF 0.1 · 5 conceitos · damian0o/knowledge-bricks

Open source Repository Open in the app JSON README (API)

About

# knowledge-bricks — the EOS Knowledge Base

*87 concepts · 7 grounding thinkers · 6 operators · 3 axioms · 8 philosophy clusters*

**The problem this bundle works on is philosophical: what is reality, and how can a reasoning
agent operate on concepts when no fixed grounding for them exists?** Twenty-five centuries of
answers — from Parmenides' unchanging Being to the quantum measurement problem — have not closed
the question. This bundle maps those answers as a graph and builds toward the one node it
deliberately leaves unwritten: the *next step for philosophy to resolve*, the empty socket the
whole graph points at.

## Why

An AI agent that reviews, refactors, and updates knowledge is constantly transforming concepts —
stabilizing them, renaming them, re-relating them, dissolving them. Doing that well is not an
engineering problem first; it is an epistemological one. Each move the agent makes silently takes a
position on what concepts *are* and where their meaning comes from. This bu

Details

Kind
OKF bundles
Topic
AI, RAG & memory
Publisher
damian0o
Origin
okf_github
Category
dados
Version
0.1
Stars
1
Last push
2026-08-20T06:58:28Z
Repository state
ativo
Language
Astro
Added
2026-09-09 19:04:11
Updated
2026-09-09 19:04:11
Origin id
damian0o/knowledge-bricks:index.md

README

# knowledge-bricks

A knowledge base authored as an **[OKF v0.1](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) bundle**
(Open Knowledge Format, Google's vendor-neutral markdown spec): 25 centuries of philosophical
conceptions of reality, wired as a graph to the **Epistemic Operator System (EOS)** — the
meta-reasoning layer of an AI code assistant. Every reasoning operator the agent uses is grounded
in the philosophical tradition that thought it through first.

**Live site:** <https://damian0o.github.io/knowledge-bricks/> ·
**Interactive graph:** <https://damian0o.github.io/knowledge-bricks/graph/>

*81 concepts · 7 grounding thinkers · 6 operators · 3 axioms · 8 philosophy clusters*

## The idea

An AI agent that reviews, refactors, and updates knowledge is constantly transforming concepts —
stabilizing, renaming, re-relating, dissolving them. Each move silently takes a position on what
concepts *are* and where meaning comes from. This bundle makes those positions explicit:

- **[philosophy/](philosophy/index.md)** — how thinkers from Parmenides to Bell conceived what
  reality fundamentally is: eight clusters (ancient → quantum, plus cross-cultural and a layer of
  cross-era dialectical *tensions*), linked as a web of influence, reaction, and synthesis.
- **[eos/](eos/index.md)** — the operators, axioms, and dynamics of the reasoning layer itself.
- **The spine** — each operator-grounding thinker (Kant → O1, Quine/Latour → O4, Wittgenstein/
  Deleuze → O3, Foucault/Derrida → O5) links forward to its operator, and the operator links back.

Start reading at **[index.md](index.md)** — it offers four curated paths in. The one node the
graph deliberately leaves unwritten is the "next step for philosophy to resolve": the empty socket
the whole graph points at.

## What an OKF bundle is

Plain markdown, no tooling required:

- A concept's **ID is its file path** minus `.md` (e.g. `philosophy/empiricism-kant/kant`).
- Every concept file carries YAML frontmatter with a `type`
  (e.g. `Philosophical Model of Reality`, `EOS Operator`, `Philosophical Tension`).
- A markdown link asserts a directed edge; the prose around it names the relationship
  (influenced / reacts-against / refines / opposes / synthesizes / grounds / takes-position …).
- `index.md` files are cluster tables of contents; `log.md` is the change history.

The bundle is the source of truth; the website is derived from it.

## Running the site builder

The static site is built by [`tools/okf-to-astro/`](tools/okf-to-astro/) (Astro + Cytoscape;
Node 22+):

```sh
cd tools/okf-to-astro
npm install
npm run dev     # local preview
npm run build   # static build in dist/
```

CI builds and deploys `main` → GitHub Pages on every push (`.github/workflows/pages.yml`).

## Contributing / conventions

Authoring rules — frontmatter order, section conventions per node type, the linking model, and
the verification commands every change must pass — live in **[AGENTS.md](AGENTS.md)**. The change
history lives in **[log.md](log.md)**.

More