RobOS Knowledge Graph Schemas & Ontologies
Comprehensive, machine-readable ontologies and W3C SHACL constraint specifications governing the RobOS Dual-State SDLC Knowledge Graph across all 8 standard package stores.
Table of contents
- Architectural Overview
- The 8 Standard RobOS Package Stores
- Universal Schema.org & De Facto Standards Matrix
- Automated Validation via SHACL
- Regenerating Schema Documentation
Architectural Overview
RobOS structures the entire software development lifecycle as an open, interconnected Dual-State Knowledge Graph. Rather than proprietary siloes or monolithic configuration files, RobOS combines three international standards:
- OASIS OSLC Core 3.0 & W3C JSON-LD: Global semantic web standard for linking requirements, changes, architectures, and tests.
- W3C SHACL (Shapes Constraint Language): Strictly validates graph nodes against structural schemas before saving or synthesizing code.
- Modular Namespaced Packages (
.robos/kgraphs/): Eliminates Git merge conflicts and blurs across teams by dividing the universe into 8 domain-isolated package stores.
The 8 Standard RobOS Package Stores
| Package ID | Namespace | Target Domain | Schemas & Shapes |
|---|---|---|---|
core-platform | robos.platform | Foundational architectural graph, system roots, and platform configuration. | robos:BuildSystem, robos:Database, robos:NoSQLDatabase, robos:MessageBroker, robos:MCPServer, robos:ContextSource, robos:PromptStrategy, robos:DatabaseSchema, robos:DatabaseTable, robos:DatabaseColumn, robos:DatabaseIndex, robos:NoSQLCollection, robos:MessageTopic, robos:ConsumerGroup, robos:MCPTool, robos:MCPResource, robos:MCPPrompt |
organization | robos.org | People, developer profiles, team topologies, and cross-team communication channels. | robos:Team, robos:Project, robos:Epic, robos:GitProjectOrganization, robos:AgentPersona, robos:TaskServer, robos:UserStory, robos:Task, robos:Subtask, robos:Bug, robos:Sprint, robos:Milestone, robos:GitRepository, robos:GitBranch, robos:PullRequest, robos:GitCommit, robos:GitTag |
services | robos.services | Backend microservices, OpenAPI 3.1 specifications, gRPC reflection stubs, and BDD verification features. | robos:Microservice, robos:Contract, oslc_rm:Requirement, robos:ProtobufContract, robos:GraphQLContract, robos:Feature, robos:APIEndpoint, robos:DataModel |
applications | robos.apps | Front-end SPAs, desktop workstations, PC & mobile games, mobile apps, and CLI tools. | robos:DesktopApp, robos:ConsoleApp, robos:MobileApp, robos:Library, robos:FrontEndApp, robos:PCGame, robos:MobileGame, robos:WebRoute, robos:CLICommand, robos:CLIFlag |
devops | robos.devops | Cloud providers, CI/CD pipelines, container registries, OAuth apps, DNS domains, and secure GPG pass credentials. | robos:DataPipeline, robos:RemoteExecutionCluster, robos:KubernetesCluster, robos:Environment, robos:GitOpsDeployment, robos:CICDPipeline, robos:KubernetesNamespace, robos:KubernetesDeployment, robos:KubernetesService, robos:KubernetesIngress, robos:PipelineStage, robos:PipelineJob, robos:PipelineStep |
learning | robos.learning | Interactive developer courses, tutorials, and architectural training modules. | robos:ELearning, robos:LearningModule, robos:LearningLesson, robos:HandsOnLab, robos:QuizAssessment |
documentation | robos.docs | Living documentation pages, architecture decision records (ADRs), interactive walkthroughs, and visual flow diagrams with AI illustrations. | robos:FlowDiagram, robos:DocumentationPage, robos:ArchitectureDecisionRecord, robos:InteractiveWalkthrough, robos:CodeSnippet, robos:DocSection, robos:ADROption |
testing | robos.testing | First-class Gherkin features, scenarios, step definitions, test execution records, and major testing frameworks. | robos:Scenario, robos:ScenarioStep, robos:GherkinFeature, robos:GherkinBackground, robos:GherkinRule, robos:ScenarioOutline, robos:ExamplesTable, robos:StepDefinition, robos:DataTable, robos:DocString, robos:TestingLibrary, robos:TestPlan, robos:TestSuite, robos:TestExecutionRecord |
Universal Schema.org & De Facto Standards Matrix
Every single entity in the RobOS Knowledge Graph is formally mapped to a canonical Schema.org parent class (ensuring 100% interoperability with search engines, web indexers, and general AI reasoning models) alongside an international De Facto Domain Standard (OASIS OSLC 3.0, W3C C4 Model, Cucumber BDD, OpenAPI 3.1, CNCF).
The formal, machine-readable W3C RDF Schema / OWL ontology bridge is published at ontology.jsonld.
Automated Validation via SHACL
Every node in the Knowledge Graph is verified using programmatic SHACL validators before it can be merged into .robos/knowledge-graph.jsonld or deployed to production:
const { SHACLValidator } = require('/usr/local/share/robos/robos-graph/lib/shacl-validator');
const { SDLCKnowledgeGraphStore } = require('/usr/local/share/robos/robos-graph');
const store = new SDLCKnowledgeGraphStore();
const validationResult = store.validate();
if (!validationResult.conforms) {
console.error("SHACL Violations:", validationResult.violations);
} else {
console.log("All graph nodes strictly conform to SHACL specifications.");
}
Regenerating Schema Documentation
RobOS includes a built-in companion generator that keeps documentation in continuous lockstep with schema code:
# Run automated schema doc generator
node scripts/generate-kgraph-schema-docs.js