Skip to content

Guides & Ontology

This section provides practical manuals for building, maintaining, and auditing ARG-compliant systems.


Available Guides

1. Construction & Audit Guide

Building and validating your ARG ontology from the ground up

This guide addresses the critical bootstrap phase — how to design a solid foundational structure before letting the offline loop refine it.

What you'll learn:

  • How to design context typologies correctly (stable, transversal, non-redundant)
  • The "trees-first" method for rapid taxonomy construction
  • Building the node graph progressively to avoid M2M explosion
  • Running pre-IA audits that catch structural errors early
  • Stop criteria: when to rebuild instead of patching

Key topics:

  • Context typology families and anti-patterns
  • Cluster and label hierarchy design rules
  • Coverage, granularity, redundancy, and contradiction audits
  • Practical deliverables to request from domain experts

Read the Construction & Audit Guide


2. Roles, Boundaries & Examples Guide

Understanding the "branches & leaves" model: Cluster / Label / Node / Edge

This guide clarifies the operational distinction between taxonomy (structure) and graph (resolution), and explains why this design protects long-term memory integrity.

What you'll learn:

  • The "branches & leaves" metaphor: what each component actually does
  • Operational definitions with real-world examples
  • When to create a cluster vs label vs node vs edge
  • How memory remains stable even as structure evolves
  • The only sensitive case: node splits and migration tables

Key topics:

  • Cluster: stable domain roots
  • Label: hierarchical routing branches
  • Node: terminal operational leaves (chunks + actions)
  • Edge: movement grammar between leaves
  • Memory safety under structural evolution

Read the Roles & Boundaries Guide


For system architects

  1. Start with Roles & Boundaries to understand the model
  2. Then Construction & Audit to apply it

For domain experts

  1. Start with Construction & Audit for practical steps
  2. Refer to Roles & Boundaries when questions arise

Quick Reference


Note: These guides focus on ontology design and operational structure. They are complementary to the ARG protocol specification and Context Weaver architecture.

Released under the Apache License 2.0