.
├── multi_repo_roles.json    # Role definitions
├── KG_ROLES.md              # Documentation
└── kg/                      # Knowledge graphs per role
    ├── terraphim-ai/        # Terraphim AI (Rust)
    ├── openclaw/            # OpenClaw (TypeScript)
    ├── last30days/          # Last30Days skill
    ├── system/              # System Operator
    └── terraphim-engineer/  # Default engineer role

Roles

1. Terraphim AI Developer

Focus: Rust-based AI assistant development
Thesaurus: Rust, Knowledge Graph, Agent, Search, Role
Embeddings: local (deep)

2. OpenClaw Developer

Focus: TypeScript gateway and agent platform
Thesaurus: TypeScript, Gateway, Channel, Skill, Config
Embeddings: local (standard)

3. Last30Days Skill Developer

Focus: Claude Code skill for web research
Thesaurus: Research, Reddit, Twitter/X, Web, Claude
Embeddings: none (basic)

4. System Operator

Focus: System administration and operations
Thesaurus: Logs, Config, Service, Network, Security
Embeddings: none (minimal)

5. Learning Capture

Focus: Personal knowledge and learning capture
Thesaurus: 20 concept groups (knowledge, config, git, etc.)
Embeddings: local (deep)

6. Terraphim Engineer (Default)

Focus: General engineering tasks
Thesaurus: Comprehensive 20-group thesaurus
Embeddings: local (deep)

Usage

Installation

# Clone to Terraphim config directory
git clone https://git.terraphim.cloud/kimie05c34be198a20b9/terraphim-kg-config.git ~/.config/terraphim/kg-config

# Or copy files manually
cp -r kg/* ~/.config/terraphim/kg/
cp multi_repo_roles.json ~/.config/terraphim/

Configuration

Update ~/.config/terraphim/settings.toml:

role_config = "~/.config/terraphim/multi_repo_roles.json"
default_role = "LearningCapture"

Switching Roles

# List roles
terraphim-agent roles list

# Select role
terraphim-agent roles select "Terraphim AI Developer"

# Query with synonym expansion
terraphim-agent learn query "rust"

Thesaurus Format

Each thesaurus is a JSON file mapping terms to canonical concepts:

{
  "name": "Role Name",
  "data": {
    "term1": { "id": 1, "nterm": "concept" },
    "term2": { "id": 1, "nterm": "concept" },
    "term3": { "id": 2, "nterm": "concept2" }
  }
}

Embeddings Control

Role	Model	Depth	Use Case
Terraphim AI	local	deep	Complex reasoning
OpenClaw	local	standard	Balanced
Last30Days	none	basic	Simple lookup
System Operator	none	minimal	Log analysis
Learning Capture	local	deep	Semantic memory

Synonym Groups

Knowledge (ID: 1)

learning, knowledge, lesson, insight, discovery

Configuration (ID: 2)

setup, configuration, install, deployment, initialize

Git (ID: 3)

gitea, git, github, repository, version control

AI Assistant (ID: 4)

terraphim, ai assistant, agent, claude, kimi

Tool (ID: 5)

skill, tool, capability, function, feature

Storage (ID: 6)

memory, storage, persistence, database

Context Management (ID: 7)

arscontexta, onecontext, context, progress

Retrieval (ID: 8)

search, retrieval, query, find, lookup

Failure (ID: 9)

error, failure, mistake, bug, issue, problem

Documentation (ID: 10)

documentation, docs, guide, manual, readme

Programming Languages (IDs: 11-13)

Rust: rust, cargo
JavaScript: javascript, js, node, npm
Python: python, py, pip

Testing (ID: 14)

test, testing, spec, verify, validation

Security (ID: 15)

security, secure, safety, protect, guard, audit

Performance (ID: 16)

performance, speed, fast, optimize, efficiency

Build (ID: 17)

build, compile, make, package

Execution (ID: 18)

run, execute, start, launch

Debugging (ID: 19)

debug, debugging, troubleshoot, diagnose

Repair (ID: 20)

fix, repair, correct, resolve, solve

License

Apache-2.0