MD-OS (Artificial Prefrontal Cortex) v5.0 must preserve semantic coherence as the Markdown network grows.
The semantic knowledge graph is the generated readback that turns every Markdown file into a profiled concept node. It complements the Markdown graph: the Markdown graph checks structural connectivity, while the semantic knowledge graph checks meaning, cognitive role, epistemic status, actionability, concept terms, and concept relations.
Every Markdown node must receive a semantic profile:
Markdown node
-> semantic layer
-> node kind
-> cognitive role
-> epistemic status
-> actionability
-> concept terms
-> structural relation
-> compact readback
If a new Markdown file is added, the next semantic graph rebuild must classify it the same way as the existing network. Growth is not allowed to remain an unrelated pile of notes.
Every semantic node must also be epistemic.
semantic node without epistemic status = incomplete node
The graph must expose:
epistemic_profiled_node_count
missing_epistemic_node_count
epistemic_profile_complete
If any Markdown node has semantic metadata but no epistemic status, the graph must report a critical finding. Semantic classification alone is not enough for MD-OS action.
New concepts are related automatically through two paths:
Markdown links and structural edges
concept co-occurrence inside profiled Markdown nodes
The first path preserves deliberate human and structural relations. The second path gives newly learned concepts an initial semantic adjacency even before a human writes explicit links.
The full graph may grow large. Health checks and bootstraps must prefer the compact summary:
md-os/ops/semantic_knowledge_summary.json
md-os/ops/semantic_knowledge_summary.md
The complete graph remains available at:
md-os/ops/semantic_knowledge_graph.json
md-os/ops/semantic_knowledge_graph.md
Health must read the compact summary first so that coherence checking does not require loading the full semantic graph during ordinary status inspection.
Canonical builder:
node md-os/os/build_semantic_knowledge_graph.js
CLI entrypoint:
cortex semantic graph build
Generated readback:
semantic graph = complete profiled node and edge graph
semantic summary = compact health and bootstrap surface
The graph is coherent only when:
profiled_node_count == markdown_node_count
epistemic_profiled_node_count == markdown_node_count
unprofiled_node_count == 0
missing_epistemic_node_count == 0
semantic_profile_complete == true
epistemic_profile_complete == true
Disconnected nodes are attention findings. Incomplete profiles are critical findings.
This model binds:
The semantic knowledge graph is not the hidden reasoning of the model. It is a filesystem readback that makes MD-OS semantic growth inspectable, compactable, and correctable.