Skip to content

Commit 3aa7606

Browse files
kitelevkitelev
authored
docs: add workflow customization guide and update property schema (#2409)
- WORKFLOW_CUSTOMIZATION.md: complete user guide with examples - PROPERTY_SCHEMA.md: all 17 new workflow properties documented - README.md: workflow customization section added Closes #2368
1 parent 1873536 commit 3aa7606

File tree

3 files changed

+813
-37
lines changed

3 files changed

+813
-37
lines changed

‎README.md‎

Lines changed: 118 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -44,13 +44,13 @@ Exocortex is an instrument for becoming **Übermensch** (Nietzsche):
4444

4545
### What Sets Exocortex Apart
4646

47-
| Traditional Tools | Exocortex |
48-
| ----------------- | ----------------------------------------------------- |
49-
| Files and folders | **Semantic graph of knowledge** |
50-
| Tags and links | **Ontology-driven relationships** |
51-
| Full-text search | **SPARQL semantic queries** |
52-
| AI chatbot | **SPARQL semantic queries** over your knowledge graph |
53-
| Data storage | **Domain model of consciousness** |
47+
| Traditional Tools | Exocortex |
48+
| ----------------- | ------------------------------------------------------- |
49+
| Files and folders | **Semantic graph of knowledge** |
50+
| Tags and links | **Ontology-driven relationships** |
51+
| Full-text search | **SPARQL semantic queries** |
52+
| AI chatbot | **Cognitive partner** working with your knowledge graph |
53+
| Data storage | **Domain model of consciousness** |
5454

5555
### Exocortex vs Generative AI
5656

@@ -98,11 +98,11 @@ DCC = **ExoAPI** — semantic contract between exocortexes.
9898

9999
### Modular Ontologies
100100

101-
| Module | Purpose |
102-
| -------------------------------- | ------------------------------------------------------------------------ |
103-
| **IMS** (Information Management) | Knowledge, concepts, relationships. Classes: `Concept`, `Note`, `Person` |
104-
| **EMS** (Effort Management) | Tasks, projects, time. Classes: `Task`, `Project`, `Meeting` |
105-
| **ZTLK** (Zettelkasten) | Atomic notes methodology |
101+
| Module | Purpose |
102+
| -------------------------------- | -------------------------------------------------------------------------------------- |
103+
| **IMS** (Information Management) | Knowledge, concepts, relationships. Classes: `Simulacrum`, `Concept`, `Note`, `Person` |
104+
| **EMS** (Effort Management) | Tasks, projects, time. Classes: `Task`, `Project`, `Meeting` |
105+
| **ZTLK** (Zettelkasten) | Atomic notes methodology |
106106

107107
### STIR Model — Knowledge Coordinates
108108

@@ -117,25 +117,80 @@ DCC = **ExoAPI** — semantic contract between exocortexes.
117117

118118
---
119119

120-
## Vision
121-
122-
Exocortex encompasses 42 unique ideas for cognitive augmentation — from implemented features like the Asset knowledge model and SPARQL engine to visionary concepts like ExoEcoSystem (federated knowledge networks) and ExoProphet (prediction engine).
123-
124-
**[See full vision document →](./VISION.md)** with implementation status for all 42 ideas.
125-
126-
### Implemented Highlights
127-
128-
- **Asset as Knowledge Quantum** — Atomic unit with UUID, class, semantic relationships
129-
- **Modular Ontologies** — IMS (concepts), EMS (tasks), ZTLK (notes)
130-
- **ExoLayout** — Flexible views over knowledge graph
131-
- **Local-First Architecture** — Data stays on device
120+
## 42 Unique IT Ideas
121+
122+
The Exocortex project encompasses a comprehensive vision for cognitive augmentation. Here are the core concepts that make this system unique:
123+
124+
### Core Architecture (1-10)
125+
126+
| # | Idea | Description |
127+
| --- | ----------------------------------------- | ------------------------------------------------------------------------------------------- |
128+
| 1 | **Asset as Knowledge Quantum** | Atomic unit of knowledge with UUID, class, label, and semantic relationships |
129+
| 2 | **DCC (Direct Conceptual Communication)** | Communication without worldview conversion — semantic contract between exocortexes |
130+
| 3 | **ExoBlockchain** | Immutable knowledge provenance tracking — who, when, and how created each fact |
131+
| 4 | **ExoEcoSystem** | Federation of exocortexes forming collective intelligence network |
132+
| 5 | **Modular Ontology System** | IMS (concepts), EMS (tasks), ZTLK (notes), PTMS (personality), Observation (world tracking) |
133+
| 6 | **Simulacrum** | Digital representation of external entities (people, companies) for modeling interactions |
134+
| 7 | **ExoLang** | Domain-specific language for knowledge operations and transformations |
135+
| 8 | **Inference Engine** | Logical reasoning over knowledge graph — deriving new facts from existing |
136+
| 9 | **BOM (Brain Object Model)** | Inspired by DOM — programmatic access to consciousness structure |
137+
| 10 | **Ontological Relativity** | Each user has their own ontology, mapped to others through DCC |
138+
139+
### Semantic Layer (11-20)
140+
141+
| # | Idea | Description |
142+
| --- | -------------------------------- | ------------------------------------------------------------------------- |
143+
| 11 | **ExoRDF** | Extended RDF with temporal and provenance dimensions |
144+
| 12 | **ExoProphet** | Prediction engine based on personal patterns and knowledge graph |
145+
| 13 | **Braindance + IoT** | Integration with wearables (HR, glucose, location) for context enrichment |
146+
| 14 | **Action Tracking** | Every action becomes data — browsing, reading, communication patterns |
147+
| 15 | **"Not AI" Principle** | Exocortex stores verified facts; AI generates but cannot be trusted alone |
148+
| 16 | **ExoTag** | Semantic tags with inheritance and property propagation |
149+
| 17 | **Life Integration** | System becomes invisible layer over life, not separate application |
150+
| 18 | **Local-First Architecture** | Data stays on device, cloud is optional synchronization |
151+
| 19 | **IExE (Inference x Exocortex)** | Intelligence-enhanced reasoning combining human and machine cognition |
152+
| 20 | **ExoProtocol** | Communication standard between exocortex instances |
153+
154+
### Process & Methodology (21-30)
155+
156+
| # | Idea | Description |
157+
| --- | ---------------------------- | ----------------------------------------------------------------------------------- |
158+
| 21 | **Echoization** | Every external information piece gets internal representation with personal context |
159+
| 22 | **ExoAdapter** | Integration layer for external services (calendars, email, social) |
160+
| 23 | **Dynamic Naming** | Assets can have multiple names based on context and audience |
161+
| 24 | **Human as Execution Organ** | Exocortex plans, human executes — partnership model |
162+
| 25 | **Knowledge Monetization** | Verified knowledge as tradeable asset in ExoEcoSystem |
163+
| 26 | **Trigger System** | Automated reactions to patterns in knowledge graph changes |
164+
| 27 | **No Permanent Self** | Identity is emergent property of knowledge graph, not fixed entity |
165+
| 28 | **Breadcrumbs** | Automatic trail of attention and reasoning for later reconstruction |
166+
| 29 | **GTD Integration** | Getting Things Done methodology as native workflow |
167+
| 30 | **ExoLayout** | Flexible views over knowledge graph for different cognitive tasks |
168+
169+
### Advanced Concepts (31-42)
170+
171+
| # | Idea | Description |
172+
| --- | ---------------------------------- | ----------------------------------------------------------------------- |
173+
| 31 | **Property Polymorphism** | Same property behaves differently based on subject class |
174+
| 32 | **Life Streams** | Parallel timelines of different life aspects (work, health, learning) |
175+
| 33 | **Human Consciousness Schema** | Formal model of consciousness structure (perception, memory, will) |
176+
| 34 | **Meta-Position** | Ability to observe your own cognitive processes through the system |
177+
| 35 | **7 Levels of Abstraction** | From raw data to wisdom, with explicit transformations |
178+
| 36 | **ExoFocus** | Attention management based on goals and current context |
179+
| 37 | **Cognitive Load Balancing** | Automatic task distribution based on mental energy patterns |
180+
| 38 | **Knowledge Decay Model** | Tracking and refreshing knowledge that becomes stale |
181+
| 39 | **Semantic Versioning of Beliefs** | Tracking how your understanding evolves over time |
182+
| 40 | **ExoMirror** | Reflection interface showing patterns in your cognition |
183+
| 41 | **Collective Wisdom Extraction** | Aggregating insights from ExoEcoSystem while preserving privacy |
184+
| 42 | **Consciousness Continuity** | Exocortex as vehicle for cognitive persistence beyond biological limits |
132185

133186
### Ethics & Principles
134187

135188
The project adheres to core ethical principles:
136189

137-
- **Human Primacy** — Technology serves human flourishing
138-
- **Privacy by Design** — Personal knowledge under user control
190+
- **Human Primacy** — Technology serves human flourishing, not replaces humanity
191+
- **Privacy by Design** — Personal knowledge remains under user control
192+
- **Transparency** — All inferences and recommendations are explainable
193+
- **Non-Manipulation** — System informs, never manipulates
139194
- **Open Standards** — Based on W3C Semantic Web standards (RDF, SPARQL, OWL)
140195

141196
---
@@ -152,7 +207,7 @@ Exocortex is a **monorepo** with five packages sharing Clean Architecture core:
152207
│ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
153208
│ │ Obsidian Plugin │ │ CLI │ │ Your App │ │
154209
│ │ (@exocortex/ │ │ (@kitelev/ │ │ (REST API │ │
155-
│ │ obsidian-plugin)│ │ exocortex-cli) │ │ planned) │ │
210+
│ │ obsidian-plugin)│ │ exocortex-cli) │ │ coming soon) │ │
156211
│ └────────┬─────────┘ └────────┬─────────┘ └────────┬─────────┘ │
157212
│ │ │ │ │
158213
│ └───────────────────────┼────────────────────────┘ │
@@ -163,7 +218,7 @@ Exocortex is a **monorepo** with five packages sharing Clean Architecture core:
163218
│ │ │ │
164219
│ │ • Domain models │ │
165220
│ │ • SPARQL engine │ │
166-
│ │ • RDFS inference │ │
221+
│ │ • Inference rules │ │
167222
│ │ • Storage adapters │ │
168223
│ └─────────────────────────┘ │
169224
│ │
@@ -192,8 +247,8 @@ Exocortex is a **monorepo** with five packages sharing Clean Architecture core:
192247
├─────────────────────────────────────────────────────────────────────────┤
193248
│ Infrastructure Layer │
194249
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │
195-
│ │ Markdown │ │ SPARQL │ │ RDF │ │
196-
│ │ Parser │ │ Engine │ │ Serializers │ │
250+
│ │ Markdown │ │ SPARQL │ │ N-Triples │ │
251+
│ │ Parser │ │ Engine │ │ Storage │ │
197252
│ └─────────────┘ └─────────────┘ └─────────────────┘ │
198253
└─────────────────────────────────────────────────────────────────────────┘
199254
```
@@ -206,7 +261,7 @@ Exocortex is a **monorepo** with five packages sharing Clean Architecture core:
206261
| **@exocortex/obsidian-plugin** | Private | Interactive UI: 24+ components, 6 renderers, 34+ commands, 11 modals |
207262
| **@kitelev/exocortex-cli** | `@kitelev/exocortex-cli` | CLI for automation, archive/unarchive, SPARQL queries, AI agent integration |
208263
| **@exocortex/test-utils** | Private | Shared test utilities, mock factories, flaky test reporter |
209-
| **physics-wasm** | Private | WebAssembly force simulation (experimental, not currently integrated) |
264+
| **physics-wasm** | Private | WebAssembly force simulation for 3D graph visualization |
210265

211266
---
212267

@@ -242,9 +297,20 @@ exocortex-cli command complete "tasks/my-task.md" --vault ~/vault
242297

243298
### Option 3: Core Library
244299

245-
Best for: Building custom applications on top of Exocortex domain models.
300+
Best for: Building custom applications.
301+
302+
```typescript
303+
import { SparqlService, NodeFsAdapter } from "exocortex";
246304

247-
> **Note**: The core library (`exocortex`) provides domain models, SPARQL engine internals, and service interfaces. For query execution, use the CLI package (`@kitelev/exocortex-cli`) which provides a complete runtime.
305+
const sparql = new SparqlService(new NodeFsAdapter("/path/to/vault"));
306+
const results = await sparql.query(`
307+
SELECT ?concept ?definition
308+
WHERE {
309+
?concept exo:Instance_class ims:Concept .
310+
?concept ims:Concept_definition ?definition .
311+
}
312+
`);
313+
```
248314

249315
---
250316

@@ -289,6 +355,20 @@ Organize knowledge domains hierarchically:
289355
▶ Finance
290356
```
291357

358+
### Workflow Customization
359+
360+
Define custom status lifecycles for your tasks and projects. Skip unnecessary steps, add new statuses, or create per-project workflow overrides -- all using regular vault assets:
361+
362+
```bash
363+
# List defined workflows
364+
exocortex-cli workflow list --vault ~/vault
365+
366+
# Validate a workflow definition
367+
exocortex-cli workflow validate <uid> --vault ~/vault
368+
```
369+
370+
See **[Workflow Customization Guide](./docs/WORKFLOW_CUSTOMIZATION.md)** for step-by-step instructions and examples.
371+
292372
### Ontology-Driven Forms
293373

294374
Create assets with forms generated from your RDF ontology — fields appear based on `rdfs:domain`, types detected from `rdfs:range`.
@@ -386,11 +466,12 @@ See **[SPARQL 1.2 Features](./docs/sparql/SPARQL-1.2-Features.md)** for complete
386466
- **[SPARQL 1.2 Features](./docs/sparql/SPARQL-1.2-Features.md)** — LATERAL, PREFIX\*, directionality, and more
387467
- **[SPARQL 1.2 Migration](./docs/sparql/SPARQL-1.2-Migration.md)** — Upgrading from SPARQL 1.1
388468

389-
### Graph View
469+
### Graph View & Visualization
390470

391-
- **[Graph View Overview](./docs/graph-view/README.md)** — Label patching for Obsidian's built-in graph view
392-
- **[Configuration Reference](./docs/graph-view/guides/configuration.md)** — Configuration options for graph label display
393-
- **[Inference & Reasoning Guide](./docs/graph-view/guides/inference.md)** — RDFS inference and neighborhood exploration
471+
- **[Graph View Overview](./docs/graph-view/README.md)** — Introduction to 2D and 3D graph visualization
472+
- **[3D Visualization Guide](./docs/graph-view/guides/3d-visualization.md)** — WebGL-powered 3D graph exploration
473+
- **[Configuration Reference](./docs/graph-view/guides/configuration.md)** — All configuration options for graph views
474+
- **[Inference & Reasoning Guide](./docs/graph-view/guides/inference.md)** — RDFS/OWL inference, neighborhood exploration
394475

395476
### Layout Code Blocks
396477

0 commit comments

Comments
 (0)