Knowledge Portal · engineering documentation

Skip to content

ZAIXOS Terminology

Status: Canonical
Last updated: 2026-07-05


Core identifiers

TermDefinitionExample
Platform (PL-xxx)Product-independent capability layer consumed via contractsPL-003 AI Runtime
Product (PRD-xxx)Customer-facing application with domain modulesPRD-001 Dental Clinic ROS
Registry (RP-xxx)Metadata authority — indexes, not runtimeRP-002 zaixos-registry
ModuleBounded context inside a productApp\Modules\CRM
ContractStable public interface; DTO-firstAiRuntimePlatformContract
CapabilityUser-outcome unit matched by intent + plannercrm.appointments.schedule
AgentPersona-bound AI worker hosted by PL-003Clinic Agent
AdapterIDE or integration bridge implementing contractsCursor Adapter v1
ConsumerProduct repo that pins platform versionsPRD-001
Closed LoopBenchmark → acceptance → release → version registry cycleSee AI/closed-loop.md

Layer vocabulary

TermMeaning
DomainEntities, value objects, domain services, events
ApplicationActions, application services, DTOs, queries
InfrastructurePersistence, external integrations — never cross-import
PresentationControllers, Filament, Blade — no business logic

AI vocabulary

TermOwnerDefinition
IntentPL-003 + product taxonomyClassified user goal
SignalPL-003 / PL-004Structured input to planner
PlannerPL-003Goal → task → tool routing
ToolPL-003Executable capability with permissions
MemoryPL-003 (runtime) / PL-005 (knowledge)Session vs. durable knowledge
BenchmarkPL-006Dataset-driven evaluation — never changes runtime
Acceptance LabPL-006 + PRD-000Human-gated promotion path
Version RegistryPL-004Canonical prompt/model/version records

Governance vocabulary

TermDefinition
FreezeBaseline tag with 0-byte diff requirement on frozen paths
ADRArchitecture Decision Record — immutable decision log
Baseline tagGit tag marking a frozen release
MaterializationMerge platform + adapter + extensions → .cursor/ mount
Cite-onlyReference external authority without duplicating body text

Forbidden terms (in official docs)

AvoidUse instead
"The AI module" (ambiguous)PL-003 or product App\Modules\AI adapter
"Intelligence in product"PL-004 via Integration adapters
"README as authority"Link to docs/ knowledge base section

Breadcrumbs: Home → Standards → Terminology

ZAIXOS Knowledge Portal — public engineering docs at /docs · Staff operations at /admin