Knowledge_baseDevelopmentVerticals
Vitruvyan Docs
Vertical Sacred Orders
Focus: real verticalization impact across Sacred Orders
Rule: document only what is verifiable in this repo
TOC
- Simple view
- Orthodoxy Wardens
- Vault Keepers
- Babel Gardens
- Pattern Weavers
- Codex Hunters
- Neural Engine
- Recommended rollout sequence for a new domain
Simple view
You do not need to modify all orders at once.
For each domain:
- enable LangGraph hooks first (intent/entity/exec),
- then enable only the required orders,
- mark each capability with actual status:
ACTIVE,EXPERIMENTAL,PLANNED.
Orthodoxy Wardens
Real hook:
domains.<domain>.governance_rules- required function:
get_domain_rules() - loader:
GovernanceRuleRegistry.register_domain(domain)
References:
vitruvyan_core/core/governance/orthodoxy_wardens/governance/rule_registry.pyvitruvyan_core/domains/finance/governance_rules.py
Status:
EXPERIMENTAL
Why:
- hook is implemented in core
- default service startup does not register domain rules
GOVERNANCE_DOMAINappears in comments/docs but no startup wiring is currently in place
Vault Keepers
Verified capability:
- domain-agnostic
signal_timeseriesarchive/query with explicitverticalfield - adapter methods:
handle_signal_timeseries_archival(...)query_signal_timeseries(...)
References:
services/api_vault_keepers/adapters/bus_adapter.pyservices/api_vault_keepers/adapters/persistence.pyvitruvyan_core/core/governance/vault_keepers/domain/signal_archive.py
Status:
ACTIVEat adapter/internal flow levelPLANNEDfor dedicated HTTP endpoints (not present inservices/api_vault_keepers/api/routes.py)
LangGraph note:
vault_node.pysupportsstate["_domain_config"]["vault_keywords"].- automatic injection of that config via a global plugin loader is not wired in current
graph_flow.py.
Babel Gardens
Signals YAML contract:
- loader:
load_config_from_yaml(signals_path, taxonomy_path=None) - contract file:
vitruvyan_core/core/cognitive/babel_gardens/domain/signal_schema.py
Service-level plugin pattern:
- finance example:
services/api_babel_gardens/plugins/finance_signals.py
Status:
EXPERIMENTAL
Why:
- YAML contract + plugin example exist
- no single automatic domain/plugin/config loader is wired in API startup
Pattern Weavers
Existing config hook:
- domain config supports
PATTERN_TAXONOMY_PATHviaPatternConfig.from_env() - service config also reads
PATTERN_TAXONOMY_PATH
References:
vitruvyan_core/core/cognitive/pattern_weavers/domain/config.pyservices/api_pattern_weavers/config.py
Status:
PLANNED
Why:
- current service startup does not build and inject
PatternConfig.from_env()into domain config viaset_config(...)
Codex Hunters
Available domain pattern:
- finance domain pack documented in
examples/verticals/finance/CODEX_HUNTERS_DOMAIN_PACK.md - domain-agnostic config object:
CodexConfigwithfrom_yaml(...)
References:
vitruvyan_core/core/governance/codex_hunters/domain/config.pyexamples/verticals/finance/CODEX_HUNTERS_DOMAIN_PACK.md
Status:
EXPERIMENTAL
Why:
- pattern and components exist
- no automatic domain-pack/config startup wiring is visible in
api_codex_hunters - orchestration integration via graph plugin remains manual pattern
Neural Engine
Real contracts:
IDataProviderIScoringStrategy
References:
vitruvyan_core/contracts/neural_engine/data_provider.pyvitruvyan_core/contracts/neural_engine/scoring_strategy.pyservices/api_neural_engine/modules/engine_orchestrator.py
Status:
EXPERIMENTAL(contracts + injection model are in place)PLANNED(automatic domain loader in service)
Why:
- API orchestrator currently initializes mock provider/strategy and contains explicit TODO for env-based domain loading
Recommended rollout sequence for a new domain
- LangGraph hooks (
intent_config.py, then entity/exec). - Orthodoxy (
governance_rules.py) only if domain is regulated/sensitive. - Babel/Pattern if domain needs signal or taxonomy extensions.
- Codex/Neural only when advanced discovery or multi-factor ranking is required.
For the single matrix with files/env/wiring/status:
docs/knowledge_base/development/verticals/Vertical_Technical_Reference.md