Skip to content

agent-utilities Canonical Concept Registry

Note: The machine-generated single source of truth for CONCEPT: tags is now docs/concepts.yaml (auto-generated by scripts/build_concepts_yaml.py from CONCEPT:<ID> markers in agent_utilities/). It currently tracks 70 concepts across 12 pillars. This page is a curated, human-readable narrative map and may lag the generated registry; when the two disagree, concepts.yaml wins.

Components marked 🔬 have research-backed enhancements.

Rule: All new concept proposals must go through the DSTDD design phase. See .specify/design/_template.md for the required KG analysis.


Traceability Matrix

Every concept has 1:1:1 traceability across: - Code: CONCEPT:X.Y tag in module docstrings - Tests: CONCEPT:X.Y tag in test file docstrings - Docs: Dedicated page in docs/pillars/<pillar>/


Pillar 1: Graph Orchestration Engine (ORCH)

ID Canonical Name Code Modules Tests Doc Page
ORCH-1.0 Core Orchestration Engine 17 17 Pillar Summary
ORCH-1.1 HTN Planning Pipeline 25 11 Pillar Summary
ORCH-1.2 Specialist Routing & Discovery 28 14 Pillar Summary
ORCH-1.3 Execution Safety & State 11 2 ORCH-1.3
ORCH-1.4 Capability Wiring Engine 11 2 ORCH-1.4
AU-ORCH.planning.legal-automation-roadmap DSTDD Pipeline 3 3 AU-ORCH.planning.legal-automation-roadmap
AU-ORCH.planning.spec-driven-pipeline Prediction Linkage Layer 🔬 1 0 Pillar Summary
AU-ORCH.planning.journey-milestone RecursiveMAS Latent Orchestrator 🔬 0 0 Pillar Summary
ORCH-1.8 Parallel Execution & Synthesis Engine 7 1 ORCH-1.8
AU-ORCH.execution.autonomous-department-orchestration Autonomous Department Orchestration 3 1 Pillar Summary
ORCH-1.10 Reactive Event Sourcing 3 1 ORCH-1.10
AU-ORCH.sandbox.compiled-orchestration-kernel WASM Micro-Agent Execution 1 1 OS-5.5
ORCH-1.12 Structured Predict-RLM Runtime 2 1 Pillar Summary
AU-ORCH.optimization.optimize-skill-prompt-gepa GEPA Reflective Prompt Optimizer 2 1 Pillar Summary
ORCH-1.27 Role-Specialized Model Routing 🔬 5 2 ORCH-1.27
ORCH-1.28 Composable Skills + Generic Adapter 🔬 2 1 ORCH-1.28
ORCH-1.29 RLM Resilience + Telemetry 🔬 2 1 ORCH-1.29
ORCH-1.30 Generalizing GEPA 🔬 1 1 ORCH-1.30
ORCH-1.31 Graph-Native Optimization State 🔬 1 1 ORCH-1.31
ORCH-1.32 KG-Governed Agent Swarm 🔬 3 1 ORCH-1.32

Key modules: graph/builder.py, graph/nodes.py, graph/planning/ (unified Planner facade), graph/routing/ (Router/RoutingStrategy strategy package over graph/_router_impl.py), graph/executor.py, graph/hsm.py, graph/lifecycle.py, core/default_catalog.py, capabilities/checkpointing.py, sdd/orchestrator.py, graph/kg_graph_factory.py, orchestration/agent_runner.py, graph/parallel_engine.py, graph/manifest_generators.py, models/execution_manifest.py, graph/reactive/ledger.py, graph/reactive/dispatcher.py, core/wasm_runner.py, rlm/predict_rlm.py, rlm/gepa.py, 🔬 graph/coordination.py, 🔬 orchestration/prediction_linkage.py


Pillar 2: Epistemic Knowledge Graph (KG)

ID Canonical Name Code Modules Tests Doc Page
KG-2.0 Active Knowledge Graph 42 24 Pillar Summary
KG-2.1 Tiered Memory & Context 🔬 17 8 KG-2.1
KG-2.2 Ontology, Epistemics & DSPy Integration 27 6 KG-2.2
KG-2.3 Unified Retrieval & Graph Integrity 🔬 15 4 KG-2.3
KG-2.4 Inductive Knowledge 12 5 KG-2.4
KG-2.5 Topological Analysis 11 4 KG-2.5
KG-2.6 Domain Ontologies & Vertical Subgraphs 53 34 KG-2.6
KG-2.6 Memory Stability 13 2 Pillar Summary
KG-2.7 Multi-Domain Architecture 6 2 KG-2.7
KG-2.7 Centralized Epistemic Gateway & Transaction Proxy 3 3 KG-2.7
KG-2.7 Rust-Native High-Performance Compute (FFI) 🔬 3 3 OS-5.5
KG-2.7 Speculative Graph Brancher 🔬 1 1 KG-2.7
KG-2.7 Semantic Compactor & Refactorer 🔬 1 1 KG-2.7
KG-2.7 Single Company Brain 7 2 Pillar Summary
KG-2.7 Ingestion Engine 1 24 Pillar Summary
KG-2.11 Bi-Temporal Memory Layers 🔬 4 1 KG-2.11
KG-2.12 Memory-First Retrieval (HyDE) 🔬 4 1 KG-2.12
KG-2.13 Background Learning Engine 🔬 2 2 KG-2.13
AU-KG.memory.ground-truth-preamble-declaring Ground-Truth Context Authority 🔬 1 1 AU-KG.memory.ground-truth-preamble-declaring
KG-2.15 Resilient Retrieval 🔬 2 1 KG-2.15
KG-2.17 Memory Hygiene 🔬 2 1 KG-2.17
KG-2.18 Evidence-Weighted Memory 🔬 1 1 KG-2.18
KG-2.19 Self-Curating Wiki 🔬 2 1 KG-2.19
KG-2.20 Mementified Context Management 🔬 4 1 KG-2.20
KG-2.21 Working Set Eviction & Memory Management 1 1 KG-2.21
KG-2.22 Pack-Driven Retrieval Signals 🔬 3 2 KG-2.22
AU-KG.domains.legal-automation Rust-Accelerated Reasoning 1 1 AU-KG.domains.legal-automation
KG-2.24 Live Refreshable Artifact models + bounded-JSON + safe interpolation 1 1 KG-2.24
KG-2.25 the default registry is populated at import, not an empty 1 1 KG-2.25
KG-2.26 Trade-Journal Bias Auditor and Shadow Account 1 1 KG-2.26
AU-KG.domains.agent-calibration-reputation-tracking Agent Calibration and Reputation Tracking 1 1 AU-KG.domains.agent-calibration-reputation-tracking
AU-KG.domains.persona-decision-heuristic-enrichment Persona Decision-Heuristic Enrichment 1 1 AU-KG.domains.persona-decision-heuristic-enrichment
AU-KG.domains.sentiment-fusion-signals Sentiment Fusion Signals 1 1 AU-KG.domains.sentiment-fusion-signals
AU-KG.domains.geopolitical-risk-scoring Geopolitical Risk Scoring 1 1 AU-KG.domains.geopolitical-risk-scoring
AU-KG.domains.dividend-sustainability-credit-fixed Dividend Sustainability & Credit/Fixed-Income Quality 1 1 AU-KG.domains.dividend-sustainability-credit-fixed
AU-KG.domains.multi-market-composite-backtester Multi-Market Composite Backtester 1 1 AU-KG.domains.multi-market-composite-backtester
AU-KG.research.zero-llm-pack-link Zero-LLM Pack-Driven Link Inference 🔬 2 1 AU-KG.research.zero-llm-pack-link
AU-KG.retrieval.relational-intent-retrieval Relational-Intent Retrieval 🔬 2 1 AU-KG.retrieval.relational-intent-retrieval
AU-KG.ontology.schema-pack-lifecycle-audit Schema-Pack Lifecycle and Audit 🔬 3 2 AU-KG.ontology.schema-pack-lifecycle-audit
KG-2.36 Pack-Driven OWL Closure 🔬 2 1 KG-2.36
AU-KG.research.research-state-domain-pack Research-State Domain Pack 🔬 2 1 AU-KG.research.research-state-domain-pack

Schema-Pack 2.0 (KG-2.22–AU-KG.research.research-state-domain-pack) turns the domain Schema Pack from a type-selection profile into a full domain retrieval+extraction+reasoning profile, closing gbrain-class gaps (recency decay, source-trust, zero-LLM typed-edge extraction, relational recall, autocut, candidate auditing) while leveraging our OWL reasoner and bi-temporal store for closure and as_of literature state that a flat brain layer cannot provide. See models/schema_pack.py, models/schema_pack_loader.py, models/schema_pack_audit.py, knowledge_graph/retrieval/{autocut,relational_intent}.py, knowledge_graph/kb/link_inference.py, and the research-state pack.

Key modules: knowledge_graph/core/engine.py, knowledge_graph/core/engine_memory.py, knowledge_graph/core/engine_tasks.py, knowledge_graph/core/graph_compute.py, knowledge_graph/core/topological_analysis_engine.py, knowledge_graph/research/research_intelligence_engine.py, knowledge_graph/memory/synthesis.py, knowledge_graph/memory/memory_materializer.py, knowledge_graph/memory/observer.py, knowledge_graph/memory/reflector.py, knowledge_graph/memory/startup_context.py, knowledge_graph/ontology.ttl, knowledge_graph/retrieval/retrieval_quality.py, knowledge_graph/pipeline/document_deletion.py, knowledge_graph/pipeline/document_update.py, domains/finance/, knowledge_graph/orchestration/engine_enterprise.py, knowledge_graph/pipeline/phases/external_graphs.py, knowledge_graph/ingestion/engine.py, scripts/install_git_hooks.py, scripts/submit_diff.py, mcp/kg_server.py, mcp/kg_coordinator.py, knowledge_graph/backends/epistemic_graph_backend.py, knowledge_graph/backends/postgresql_backend.py, knowledge_graph/backends/fanout_backend.py, knowledge_graph/backends/contrib/ladybug_backend.py, 🔬 knowledge_graph/core/ar_graph.py, 🔬 knowledge_graph/core/time_series_graph.py


Pillar 3: Agentic Harness Engineering (AHE)

ID Canonical Name Code Modules Tests Doc Page
AHE-3.0 Agentic Harness Core 16 3 Pillar Summary
AHE-3.1 Continuous Evaluation & DSPy Math Optimization 17 7 AHE-3.1
AHE-3.2 Agentic Evolution Engine 16 5 AHE-3.2
AHE-3.3 Team & Synergy Optimization 14 5 Pillar Summary
AHE-3.4 Distributed Agentic Evolution 11 1 AHE-3.4
AU-AHE.harness.self-evolution-narrative Heavy Thinking & Background Intelligence 11 1 AU-AHE.harness.self-evolution-narrative
AU-AHE.harness.evolution-checkpoint Backtest & Curriculum 10 2 AU-AHE.harness.evolution-checkpoint
AU-AHE.harness.concept-2 KG-Native Task Detection 🔬 1 0 Pillar Summary
AU-AHE.harness.self-improvement-overview Interpretability & Model Evolution 4 2 Pillar Summary
AHE-3.9 Physical Knowledge Distillation Engine 🔬 1 1 Pillar Summary
AHE-3.10 Multi-Optimizer Prompt Selection Strategy 🔬 1 1 Pillar Summary
AU-AHE.optimization.gitops-commit-automation GitOps Commit & Evolution Boundary Traceability 🔬 1 1 Pillar Summary
AHE-3.12 LongMemEval-S Validation Harness 🔬 2 1 AHE-3.12

Key modules: harness/evaluation_engine.py, harness/agentic_evolution_engine.py, graph/team_composer.py, agentic_evolution/forge.py, knowledge_graph/orchestration/engine_ahe.py, knowledge_graph/distillation/physical_distiller.py, harness/evolve_agent.py, 🔬 harness/distributed_state_manager.py


Pillar 4: Ecosystem & Peripherals (ECO)

ID Canonical Name Code Modules Tests Doc Page
ECO-4.0 Tool Interface & MCP Factory 26 18 ECO-4.0
ECO-4.1 A2A Network & Consensus 🔬 7 3 Pillar Summary
AU-ECO.toolkit.journey-map-narrative Community Telemetry & Ecosystem Map 5 1 AU-ECO.toolkit.journey-map-narrative
AU-ECO.ui.company-infrastructure-orchestration Market Data KG Node Models 1 1 Pillar Summary
AU-ECO.toolkit.journey-map-adoption KG MCP Server & Execution 2 0 Pillar Summary
AU-ECO.toolkit.journey-map-milestones Native Messaging Backend Abstraction 21 17 AU-ECO.toolkit.journey-map-milestones
AU-ECO.mcp.toolkit-live-discovery Dynamic Capability Ingestion & Discovery 5 4 AU-ECO.mcp.toolkit-live-discovery
AU-OS.deployment.infra-orchestration Company Infrastructure Orchestration 3 2 Pillar Summary
AU-OS.deployment.blueprint-library Infrastructure Blueprint Library 1 1 Pillar Summary
AU-ECO.bus.pluggable-queue-backend Pluggable Event Queue Backend 3 2 OS-5.5
AU-KG.memory.team-startup-context Automated Documentation & AGENTS.md Governance 4 0 Pillar Summary
AU-OS.governance.lint-enforcement-hook Deterministic Lint Enforcement Hook 1 0 Pillar Summary
AU-ECO.toolkit.self-documenting-plugin-bundle Plugin Bundle Distribution System 1 0 Pillar Summary
AU-OS.governance.permission-policy Ecosystem Governance & Policy Engine 3 0 Pillar Summary

Key modules: mcp/server_factory.py, mcp/kg_server.py (incl. kg_launch_terminal_agent), ecosystem/bridge.py, ecosystem/hook_installer.py, ecosystem/agents_md_reflector.py, ecosystem/lint_enforcement_hook.py, ecosystem/plugin_bundle.py, ecosystem/permission_policy.py, ecosystem/config_staleness_auditor.py, ecosystem/governance_workflow.py, ecosystem/agent_manager_dashboard.py, tools/codebase_map_tools.py, knowledge_graph/core/agents_md.py, knowledge_graph/memory/startup_context.py, graph/subagent_patterns.py, protocols/a2a_graph_skill.py, tools/tool_filtering.py, tools/dynamic_tool_orchestrator.py, knowledge_graph/core/engine_ingestion.py, knowledge_graph/core/engine_mcp_discovery.py, knowledge_graph/core/queue_backend.py, knowledge_graph/core/nats_queue_backend.py, knowledge_graph/core/kafka_queue_backend.py


Pillar 5: Agent OS Infrastructure (OS)

ID Canonical Name Code Modules Tests Doc Page
OS-5.0 Agent OS Kernel & XDG Paths 17 6 Pillar Summary
OS-5.1 Security & Auth 19 8 OS-5.1
OS-5.2 Resource Scheduling 🔬 18 4 Pillar Summary
AU-OS.governance.reactive-multi-axis-budget OS Guardrails & Safety Boundaries 10 5 AU-OS.governance.reactive-multi-axis-budget
AU-OS.governance.wasm-micro-agent-sandbox Telemetry & Observability 7 3 AU-OS.governance.wasm-micro-agent-sandbox
OS-5.5 Massive Scale Architecture & Sandbox 2 2 OS-5.5
OS-5.6 Distributed Replay & Compliance Engine 1 1 OS-5.6
AU-OS.deployment.platform-journey OS-Level Hardened Tool Sandbox Executor 1 1 AU-OS.deployment.platform-journey
OS-5.8 Epistemic Resource Scheduler 🔬 1 1 OS-5.8

Key modules: core/paths.py, security/guardrails.py, security/tool_guard.py, core/cognitive_scheduler.py, observability/token_tracker.py, observability/audit_logger.py, graph/reactive/budget.py, core/wasm_runner.py, gateway/aggregator.py, gateway/registry.py, gateway/config.py, gateway/api.py, gateway/ws.py


Gateway Service Dashboard (GW)

ID Canonical Name Code Modules Tests Doc Page
AU-OS.config.gateway-service-dashboard Gateway Service Dashboard 58 7 AU-OS.config.gateway-service-dashboard

Key modules: gateway/__init__.py, gateway/models.py, gateway/registry.py, gateway/config.py, gateway/aggregator.py, gateway/api.py, gateway/ws.py, gateway/widgets/base.py, gateway/widgets/*.py (50 widget modules)


Concept Lifecycle

New Feature Request
  ┌────────────────────┐
  │ KG Analogy Search  │  ← Does a similar concept already exist?
  │ (similarity ≥ 0.7) │
  └────────┬───────────┘
    ┌──────┴──────┐
    │             │
  EXTEND      PROPOSE
    │             │
    ▼             ▼
  Augment    NewConceptProposal
  existing   (requires C4 diagram,
  concept     pillar assignment,
              pipeline phase)
    │             │
    └──────┬──────┘
  .specify/design/<feature>/design.md
  SDDManager.validate_design()
  .specify/specs/<feature>/spec.md

Pillar 6: GeniusBot Desktop Cockpit (GBOT)

ID Canonical Name Code Modules Tests Doc Page
AU-GBOT.cockpit.through-gbot Desktop Cockpit Orchestrator geniusbot/geniusbot.py tests/test_geniusbot.py GeniusBot Cockpit
AU-GBOT.cockpit.pillar-overview Ecosystem Dynamic Tab Matrix geniusbot/plugins/ tests/test_plugins.py GeniusBot Cockpit
AU-GBOT.cockpit.concept-2 Embedded Terminal Sandbox geniusbot/qt/terminal_widget.py tests/test_terminal_widget.py GeniusBot Cockpit
AU-GBOT.cockpit.concept-3 Universal Tool Approval Gate geniusbot/qt/tool_guard.py tests/test_tool_guard.py GeniusBot Cockpit
AU-GBOT.cockpit.concept-4 Topological Cockpit Memory geniusbot/utils/agent_bridge.py tests/test_agent_bridge.py GeniusBot Cockpit
AU-GBOT.cockpit.concept-5 Multi-Tenant Daemon & Tray geniusbot/utils/daemon.py tests/test_daemon.py GeniusBot Cockpit
AU-GBOT.cockpit.concept-6 High-Performance Visual Finance Cockpit geniusbot/qt/finance_cockpit.py tests/test_finance_cockpit.py GeniusBot Cockpit

Cross-Repo: LLM Trainer (CONCEPT:ML-*)

A deliberate cross-repo concept family (spans data-science-mcp + agent-utilities + universal-skills), so it uses a repo-neutral ML-* prefix rather than a single pillar. It expands AHE-3.1 (in-house training substrate) and DS-ECO.mcp.model-training. Not part of the per-pillar contiguity gate. The agent-utilities side is prompt personas + the train_model workflow (no in-code CONCEPT: markers, so it does not appear in concepts.yaml). Canonical registry: data-science-mcp/docs/concepts.md; design: .specify/specs/llm-model-trainer/; deep dive: architecture/in_house_training_substrate.md.

ID Canonical Name Home repo
AU-AHE.trainer.high-caliber-llm-trainer Trainer Hardening (shared run_loop) data-science-mcp
DS-AHE.trainer.data-engine Corpus Curation Engine data-science-mcp
DS-AHE.trainer.concept-2 Pretrain From Random Init data-science-mcp
DS-AHE.trainer.concept-3 Experiment Tracking (MLflow + KG mirror) data-science-mcp
DS-AHE.trainer.concept-4 Distributed Scale-Out (FSDP + DeepSpeed) data-science-mcp
DS-AHE.trainer.concept-5 Benchmark Evaluation (lm-eval) data-science-mcp
AU-AHE.trainer.concept-2 Agent-Driven Training (personas + train_model workflow) agent-utilities + universal-skills

Concept ID Completeness (registry reconciliation)

This section keeps the curated narrative map's ID space contiguous (the check-concept-gaps governance gate requires 0..max with no holes). It reconciles three cases that previously left gaps: (a) concepts that exist in docs/concepts.yaml / code but were never written into the narrative tables above; (b) ID numbers that were never assigned (skipped during early numbering) — documented here as Reserved so the number is accounted for rather than silently missing; and (c) old numeric ids that were migrated to a new OKF-CIS dotted <PILLAR>.<domain>.<concept> id (the Concept-ID standard migration, see docs/okf-cis.md — the narrative tables above already carry the dotted replacement in the retired numeric id's position) — the retired numeric id is recorded here as Migrated to <dotted-id> purely so the gate's numeric sequence stays contiguous; the dotted id in the tables above is the live reference. docs/concepts.yaml remains the machine source of truth.

Pillar 1 — Graph Orchestration (ORCH) — reconciled IDs

ID Canonical Name Status
ORCH-1.5 DSTDD Pipeline Migrated to AU-ORCH.planning.legal-automation-roadmap
ORCH-1.6 Prediction Linkage Layer Migrated to AU-ORCH.planning.spec-driven-pipeline
ORCH-1.7 RecursiveMAS Latent Orchestrator Migrated to AU-ORCH.planning.journey-milestone
ORCH-1.9 Autonomous Department Orchestration Migrated to AU-ORCH.execution.autonomous-department-orchestration
ORCH-1.11 WASM Micro-Agent Execution Migrated to AU-ORCH.sandbox.compiled-orchestration-kernel
ORCH-1.13 GEPA Reflective Prompt Optimizer Migrated to AU-ORCH.optimization.optimize-skill-prompt-gepa
ORCH-1.14 Reserved (never assigned)
ORCH-1.15 Reserved (never assigned)
ORCH-1.16 Reserved (never assigned)
ORCH-1.17 Reserved (never assigned)
ORCH-1.18 Reserved (never assigned)
ORCH-1.19 Reserved (never assigned)
ORCH-1.20 Service Registry Initialization Migrated to AU-ORCH.execution.service-registry-initialization
ORCH-1.21 Execution Provenance Tracking Active
ORCH-1.22 Workflow Persistence & Replay Active
ORCH-1.23 Semantic Workflow Retrieval Active
ORCH-1.24 Workflow Lifecycle Management Active
ORCH-1.25 Reserved (never assigned)
ORCH-1.26 RLM Synthesis Fallback Migrated to AU-ORCH.execution.rlm-synthesis-failed-falling

Pillar 2 — Epistemic Knowledge Graph (KG) — reconciled IDs

ID Canonical Name Status
KG-2.8 Ingestion & Enrichment Engine Active
KG-2.9 Universal DataConnector Active
KG-2.10 Orchestration Synthesis Migrated to AU-KG.enrichment.a2a-capability-extraction
KG-2.14 Ground-Truth Context Authority Migrated to AU-KG.memory.ground-truth-preamble-declaring
KG-2.16 Memory Consolidation Stability Active
KG-2.23 Rust-Accelerated Reasoning Migrated to AU-KG.domains.legal-automation
KG-2.27 Agent Calibration and Reputation Tracking Migrated to AU-KG.domains.agent-calibration-reputation-tracking
KG-2.28 Persona Decision-Heuristic Enrichment Migrated to AU-KG.domains.persona-decision-heuristic-enrichment
KG-2.29 Sentiment Fusion Signals Migrated to AU-KG.domains.sentiment-fusion-signals
KG-2.30 Geopolitical Risk Scoring Migrated to AU-KG.domains.geopolitical-risk-scoring
KG-2.31 Dividend Sustainability & Credit/Fixed-Income Quality Migrated to AU-KG.domains.dividend-sustainability-credit-fixed
KG-2.32 Multi-Market Composite Backtester Migrated to AU-KG.domains.multi-market-composite-backtester
KG-2.33 Zero-LLM Pack-Driven Link Inference Migrated to AU-KG.research.zero-llm-pack-link
KG-2.34 Relational-Intent Retrieval Migrated to AU-KG.retrieval.relational-intent-retrieval
KG-2.35 Schema-Pack Lifecycle and Audit Migrated to AU-KG.ontology.schema-pack-lifecycle-audit

Pillar 3 — Agentic Harness Engineering (AHE) — reconciled IDs

ID Canonical Name Status
AHE-3.5 Heavy Thinking & Background Intelligence Migrated to AU-AHE.harness.self-evolution-narrative
AHE-3.6 Backtest & Curriculum Migrated to AU-AHE.harness.evolution-checkpoint
AHE-3.7 KG-Native Task Detection Migrated to AU-AHE.harness.concept-2
AHE-3.8 Interpretability & Model Evolution Migrated to AU-AHE.harness.self-improvement-overview
AHE-3.11 GitOps Commit & Evolution Boundary Traceability Migrated to AU-AHE.optimization.gitops-commit-automation

Pillar 5 — Agent OS Infrastructure (OS) — reconciled IDs

ID Canonical Name Status
OS-5.3 OS Guardrails & Safety Boundaries Migrated to AU-OS.governance.reactive-multi-axis-budget
OS-5.4 Telemetry & Observability Migrated to AU-OS.governance.wasm-micro-agent-sandbox
OS-5.7 OS-Level Hardened Tool Sandbox Executor Migrated to AU-OS.deployment.platform-journey