@prefix :       <https://deanofbigdatadobd.substack.com/p/genais-missing-layer-reasoning-state#> .
@prefix schema: <http://schema.org/> .
@prefix xsd:    <http://www.w3.org/2001/XMLSchema#> .
@prefix rdf:    <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs:   <http://www.w3.org/2000/01/rdf-schema#> .
@prefix owl:    <http://www.w3.org/2002/07/owl#> .
@prefix skos:   <http://www.w3.org/2004/02/skos/core#> .
@prefix prov:   <http://www.w3.org/ns/prov#> .
@prefix dbr:    <http://dbpedia.org/resource/> .
@prefix schmarzo: <https://www.linkedin.com/in/schmarzo#> .
@prefix kidehen: <https://www.linkedin.com/in/kidehen#> .
@prefix ace:    <https://linkeddata.uriburner.com/DAV/demos/daas/ai-agent-memory-context-engineering-claude_sonnet_4_6-1.ttl#> .
@prefix karp:   <https://linkeddata.uriburner.com/DAV/demos/daas/karp-frontier-models-enterprise-ai-claude_sonnet_5-1.ttl#> .

# ── Ontology ──────────────────────────────────────────────────────────────

: a owl:Ontology ;
    schema:name "Reasoning State Engineering / agent-rdf-memory Alignment Ontology"@en ;
    schema:description "A lightweight ontology modeling Bill Schmarzo's four-layer AI-context architecture, his three-layer human-AI collaboration progression, and the drift qualities Reasoning State Engineering restores, defined so that agent-rdf-memory's own implementation can be mapped onto it entity-by-entity."@en ;
    schema:identifier <https://deanofbigdatadobd.substack.com/p/genais-missing-layer-reasoning-state> .

:ContextArchitectureLayer a rdfs:Class ;
    rdfs:label "Context Architecture Layer"@en ;
    rdfs:comment "One of the four distinct architectural layers an AI Thinking Partner draws context from: Identity, Knowledge, Reasoning State, or Current Prompt."@en ;
    rdfs:isDefinedBy : .

:hasDurabilityStatus a rdf:Property ;
    rdfs:label "has durability status"@en ;
    rdfs:comment "Whether a context architecture layer is durable (persists across conversations) or fragile (lives only inside the current conversation)."@en ;
    rdfs:domain :ContextArchitectureLayer ;
    rdfs:range xsd:string ;
    rdfs:isDefinedBy : .

:CollaborationEngineeringLayer a rdfs:Class ;
    rdfs:label "Collaboration Engineering Layer"@en ;
    rdfs:comment "One of the three progressive engineering disciplines in human-AI collaboration: Prompt Engineering, Context Engineering, or Reasoning State Engineering."@en ;
    rdfs:isDefinedBy : .

:teachesAI a rdf:Property ;
    rdfs:label "teaches AI"@en ;
    rdfs:comment "What a collaboration engineering layer teaches, grounds, or preserves for the AI."@en ;
    rdfs:domain :CollaborationEngineeringLayer ;
    rdfs:range xsd:string ;
    rdfs:isDefinedBy : .

:ReasoningDriftCost a rdfs:Class ;
    rdfs:label "Reasoning Drift Cost"@en ;
    rdfs:comment "One of the three cascading failures that occur as an AI's reasoning state slips: declining Relevance, fading Responsibility, or dangerous Accuracy loss."@en ;
    rdfs:isDefinedBy : .

:failureMode a rdf:Property ;
    rdfs:label "failure mode"@en ;
    rdfs:comment "The dominant way a reasoning drift cost manifests in an AI's output once the reasoning state has slipped."@en ;
    rdfs:domain :ReasoningDriftCost ;
    rdfs:range xsd:string ;
    rdfs:isDefinedBy : .

:ReasoningStateQuality a rdfs:Class ;
    rdfs:label "Reasoning State Quality"@en ;
    rdfs:comment "One of the three qualities Reasoning State Engineering improves in long-running AI collaborations: Continuity, Consistency, or Recoverability."@en ;
    rdfs:isDefinedBy : .

# ── Provenance: generating skills ────────────────────────────────────────

<https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/kg-generator#this>
    a schema:SoftwareApplication, prov:SoftwareAgent ;
    schema:name "kg-generator skill"@en ;
    schema:url <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/kg-generator> ;
    schema:description "A skill that generates schema.org-aligned RDF-Turtle or JSON-LD knowledge graphs from web content using curated prompt templates."@en .

<https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/rdf-infographic-skill#this>
    a schema:SoftwareApplication, prov:SoftwareAgent ;
    schema:name "rdf-infographic-skill"@en ;
    schema:url <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/rdf-infographic-skill> ;
    schema:description "A skill that renders RDF knowledge graphs as interactive HTML infographics with a KG Explorer and Markdown companion documents."@en .

# ── People and organizations ─────────────────────────────────────────────

schmarzo:this a schema:Person ;
    schema:name "Bill Schmarzo"@en ;
    schema:alternateName "Dean of Big Data 🎓 #DOBD"@en ;
    schema:description "Teacher, author, Chief DataMonetization Officer, USF Executive Fellow, NUI Galway Honorary Professor, Iowa State University Professor, AI Customer Innovation Specialist at Dell Technologies."@en ;
    schema:url <https://www.linkedin.com/in/schmarzo/> ;
    schema:identifier <https://www.linkedin.com/in/schmarzo/> ;
    owl:sameAs <https://twitter.com/schmarzo#this>, <https://substack.com/@deanofbigdata#this> .

<https://twitter.com/schmarzo#this> a schema:Person ;
    schema:url <https://twitter.com/schmarzo> .

<https://substack.com/@deanofbigdata#this> a schema:Person ;
    schema:url <https://substack.com/@deanofbigdata> .

kidehen:this a schema:Person ;
    schema:name "Kingsley Uyi Idehen"@en ;
    schema:jobTitle "Founder & CEO, OpenLink Software"@en ;
    owl:sameAs <https://linkedin.com/in/kidehen#this> .

:deanOfBigDataNewsletter a schema:Blog ;
    schema:name "Dean of Big Data Newsletter"@en ;
    schema:url <https://deanofbigdatadobd.substack.com/> ;
    schema:publisher schmarzo:this ;
    schema:author schmarzo:this .

:OpenLinkSoftware a schema:Organization ;
    schema:name "OpenLink Software"@en ;
    schema:url <https://www.openlinksw.com/> .

:yoda a schema:SoftwareApplication, schema:DefinedTerm ;
    schema:name "YODA"@en ;
    schema:alternateName "Your Own Digital Assistant"@en ;
    schema:description "Bill Schmarzo's practical, project-level AI Thinking Partner implementation — the vehicle through which Context Engineering and, in this article, Reasoning State Engineering are applied and stress-tested."@en ;
    schema:creator schmarzo:this ;
    schema:isPartOf :deanOfBigDataNewsletter .

# ── Source article and top-level analysis ────────────────────────────────

<https://deanofbigdatadobd.substack.com/p/genais-missing-layer-reasoning-state>
    a schema:Article ;
    schema:headline "GenAI's Missing Layer: Reasoning State Engineering"@en ;
    schema:alternativeHeadline "The next evolution of AI Thinking Partners—from engineering what AI knows to preserving the state of your reasoning."@en ;
    schema:author schmarzo:this ;
    schema:publisher :deanOfBigDataNewsletter ;
    schema:isPartOf :deanOfBigDataNewsletter ;
    schema:datePublished "2026-08-11"^^xsd:date ;
    schema:url <https://deanofbigdatadobd.substack.com/p/genais-missing-layer-reasoning-state> ;
    schema:abstract "Argues that long-running AI Thinking Partners suffer 'reasoning drift' because the accumulated objectives, priorities, assumptions, decisions, and definitions of a collaboration — its 'reasoning state' — have no durable home, and proposes Reasoning State Engineering as the architectural fix."@en ;
    schema:about :yoda .

:analysis a schema:Article ;
    schema:name "How agent-rdf-memory Answers GenAI's Missing Layer: Reasoning State Engineering"@en ;
    schema:headline "How agent-rdf-memory Answers GenAI's Missing Layer: Reasoning State Engineering"@en ;
    schema:abstract "A layer-by-layer alignment of Bill Schmarzo's Reasoning State Engineering thesis against agent-rdf-memory, an RDF-based agent memory harness whose sessions/, preferences.ttl, and SPARQL-routed retrieval already operationalize durable, recoverable reasoning state outside the conversation."@en ;
    schema:about <https://deanofbigdatadobd.substack.com/p/genais-missing-layer-reasoning-state> ;
    schema:isBasedOn <https://deanofbigdatadobd.substack.com/p/genais-missing-layer-reasoning-state> ;
    schema:datePublished "2026-08-11"^^xsd:date ;
    schema:author <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/kg-generator#this> ;
    schema:accountablePerson kidehen:this ;
    schema:hasPart :contextLayersSection, :collaborationLayersSection, :driftCostsSection, :qualitiesSection,
        :quotationsSection, :criticalPerspectivesSection, :howtoSection, :faqSection, :glossarySection ;
    prov:wasGeneratedBy <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/kg-generator#this>,
        <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/rdf-infographic-skill#this> ;
    schema:relatedLink <https://deanofbigdatadobd.substack.com/p/genais-missing-layer-reasoning-state>,
        <https://www.linkedin.com/in/schmarzo/>, <https://twitter.com/schmarzo>,
        <https://substack.com/@deanofbigdata>, <https://deanofbigdatadobd.substack.com/>,
        <https://www.linkedin.com/in/kidehen#this>,
        <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/agent-rdf-memory>,
        <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/kg-generator>,
        <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/rdf-infographic-skill>,
        <https://linkeddata.uriburner.com/DAV/demos/daas/ai-agent-memory-context-engineering-claude_sonnet_4_6-1.ttl>,
        <https://linkeddata.uriburner.com/DAV/demos/daas/karp-frontier-models-enterprise-ai-claude_sonnet_5-1.ttl>,
        <http://dbpedia.org/resource/Prompt_engineering> .

# ── Quotations ────────────────────────────────────────────────────────────

:quotationsSection a schema:CreativeWork ;
    schema:name "Key Quotations"@en ;
    schema:isPartOf :analysis ;
    schema:hasPart :quoteReasoningState, :quoteDriftCost, :quoteFix, :quoteSmarter, :quoteFourLayers .
:analysis schema:hasPart :quotationsSection .

:quoteReasoningState a schema:Quotation ;
    schema:text "The AI is gradually losing its reasoning state that anchors the collaboration—the objectives, priorities, assumptions, decisions, and definitions that make the recommendations uniquely yours."@en ;
    schema:creator schmarzo:this ;
    schema:citation <https://deanofbigdatadobd.substack.com/p/genais-missing-layer-reasoning-state> ;
    schema:isPartOf :quotationsSection .

:quoteFourLayers a schema:Quotation ;
    schema:text "That unprotected Reasoning State, caught between the durable inputs and the fleeting prompt, is the gap Reasoning State Engineering fills — by making the initiative's evolving state durable and recoverable."@en ;
    schema:creator schmarzo:this ;
    schema:citation <https://deanofbigdatadobd.substack.com/p/genais-missing-layer-reasoning-state> ;
    schema:isPartOf :quotationsSection .

:quoteDriftCost a schema:Quotation ;
    schema:text "That's the real cost of reasoning drift. AI simply stops reasoning from your context and gradually returns to reasoning from everyone else's."@en ;
    schema:creator schmarzo:this ;
    schema:citation <https://deanofbigdatadobd.substack.com/p/genais-missing-layer-reasoning-state> ;
    schema:isPartOf :quotationsSection .

:quoteFix a schema:Quotation ;
    schema:text "The fix follows directly from the diagnosis: stop treating your reasoning as something that lives inside the conversation, and start treating it as durable architecture that lives outside it."@en ;
    schema:creator schmarzo:this ;
    schema:citation <https://deanofbigdatadobd.substack.com/p/genais-missing-layer-reasoning-state> ;
    schema:isPartOf :quotationsSection .

:quoteSmarter a schema:Quotation ;
    schema:text "'The more I use it, the smarter it gets' actually becomes true—not because the AI is learning on its own, but because you've engineered an architecture that continuously preserves, recovers, and refines the reasoning behind your work."@en ;
    schema:creator schmarzo:this ;
    schema:citation <https://deanofbigdatadobd.substack.com/p/genais-missing-layer-reasoning-state> ;
    schema:isPartOf :quotationsSection .

# ── Four context architecture layers ─────────────────────────────────────

:contextLayersSection a schema:CreativeWork ;
    schema:name "Where AI Gets Its Context — Four Architectural Layers"@en ;
    schema:isPartOf :analysis ;
    schema:hasPart :identityLayer, :knowledgeLayer, :reasoningStateLayer, :currentPromptLayer .
:analysis schema:hasPart :contextLayersSection .

:identityLayer a :ContextArchitectureLayer, schema:DefinedTerm ;
    schema:name "Identity Layer"@en ;
    schema:description "Who the AI is: the project-level Activation Prompt establishing role, behaviors, reasoning disciplines, and guardrails. Durable at the project level across all subsequent conversations."@en ;
    schema:position 1 ;
    :hasDurabilityStatus "Durable"@en ;
    schema:isPartOf :contextLayersSection .

:knowledgeLayer a :ContextArchitectureLayer, schema:DefinedTerm ;
    schema:name "Knowledge Layer"@en ;
    schema:description "What the AI knows: uploaded credible research, proven frameworks, and organizational domain knowledge that persist in the initiative's growing contextual knowledgebase."@en ;
    schema:position 2 ;
    :hasDurabilityStatus "Durable"@en ;
    schema:isPartOf :contextLayersSection .

:reasoningStateLayer a :ContextArchitectureLayer, schema:DefinedTerm ;
    schema:name "Reasoning State Layer"@en ;
    schema:description "Where you are in the work: the initiative's accumulated objectives, priorities, assumptions, decisions, and definitions. Develops inside a conversation but is not durably protected — the layer that slips."@en ;
    schema:position 3 ;
    :hasDurabilityStatus "Fragile — unprotected by default"@en ;
    schema:isPartOf :contextLayersSection .

:currentPromptLayer a :ContextArchitectureLayer, schema:DefinedTerm ;
    schema:name "Current Prompt Layer"@en ;
    schema:description "What you just said: the latest message, useful but fragile, temporary, and limited to the current conversation."@en ;
    schema:position 4 ;
    :hasDurabilityStatus "Fragile"@en ;
    schema:isPartOf :contextLayersSection .

# ── Three collaboration engineering layers ───────────────────────────────

:collaborationLayersSection a schema:CreativeWork ;
    schema:name "The Next Layer of Human-AI Collaboration"@en ;
    schema:isPartOf :analysis ;
    schema:hasPart :promptEngineeringLayer, :glossContextEngineeringLayer, :reasoningStateEngineeringLayer .
:analysis schema:hasPart :collaborationLayersSection .

:promptEngineeringLayer a :CollaborationEngineeringLayer, schema:DefinedTerm ;
    schema:name "Prompt Engineering"@en ;
    schema:description "Taught AI what to do. Shapes the AI's behavior for a single instruction."@en ;
    schema:position 1 ;
    :teachesAI "What to do"@en ;
    skos:related dbr:Prompt_engineering ;
    schema:isPartOf :collaborationLayersSection .

:glossContextEngineeringLayer a :CollaborationEngineeringLayer, schema:DefinedTerm ;
    schema:name "Context Engineering"@en ;
    schema:description "Taught AI what it should know. Grounds the AI in the objectives, trusted knowledge, and expert perspectives that turn a generic tool into an AI Thinking Partner."@en ;
    schema:position 2 ;
    :teachesAI "What it should know"@en ;
    skos:exactMatch ace:ContextEngineering ;
    rdfs:seeAlso <https://linkeddata.uriburner.com/DAV/demos/daas/ai-agent-memory-context-engineering-claude_sonnet_4_6-1.ttl> ;
    schema:isPartOf :collaborationLayersSection .

:reasoningStateEngineeringLayer a :CollaborationEngineeringLayer, schema:DefinedTerm ;
    schema:name "Reasoning State Engineering"@en ;
    schema:description "Preserves the collaborative reasoning currently in place — the ongoing objectives, priorities, assumptions, decisions, and definitions of a live initiative — as durable architecture that lives outside the conversation."@en ;
    schema:position 3 ;
    :teachesAI "What has already been reasoned and decided"@en ;
    schema:isPartOf :collaborationLayersSection .

# ── Three reasoning-drift costs ──────────────────────────────────────────

:driftCostsSection a schema:CreativeWork ;
    schema:name "The Cost of Reasoning Drift"@en ;
    schema:isPartOf :analysis ;
    schema:hasPart :relevanceCost, :responsibilityCost, :accuracyCost .
:analysis schema:hasPart :driftCostsSection .

:relevanceCost a :ReasoningDriftCost, schema:DefinedTerm ;
    schema:name "Relevance Loss"@en ;
    schema:description "The first casualty of reasoning drift: as the reasoning state slips, the AI quietly slides back toward generic advice instead of the user's unique situation."@en ;
    :failureMode "Recommendations drift toward the generic average"@en ;
    schema:isPartOf :driftCostsSection .

:responsibilityCost a :ReasoningDriftCost, schema:DefinedTerm ;
    schema:name "Responsibility Fade"@en ;
    schema:description "Guardrails such as 'flag uncertainty' or 'don't present a draft as a final answer' are part of the reasoning state; once they fall outside the AI's working context, they stop influencing its recommendations."@en ;
    :failureMode "Guardrails silently stop applying"@en ;
    schema:isPartOf :driftCostsSection .

:accuracyCost a :ReasoningDriftCost, schema:DefinedTerm ;
    schema:name "Dangerous Accuracy Loss"@en ;
    schema:description "The most dangerous cost because it fails silently: the AI answers using plausible general knowledge with the same confidence it once reserved for evidence-based reasoning."@en ;
    :failureMode "Confident generalization replaces evidence-based reasoning, unnoticed"@en ;
    schema:isPartOf :driftCostsSection .

# ── Three reasoning-state qualities ──────────────────────────────────────

:qualitiesSection a schema:CreativeWork ;
    schema:name "What Reasoning State Engineering Does"@en ;
    schema:isPartOf :analysis ;
    schema:hasPart :continuityQuality, :consistencyQuality, :recoverabilityQuality .
:analysis schema:hasPart :qualitiesSection .

:continuityQuality a :ReasoningStateQuality, schema:DefinedTerm ;
    schema:name "Continuity"@en ;
    schema:description "The thread of the initiative survives across a long-running collaboration instead of resetting each session."@en ;
    schema:isPartOf :qualitiesSection .

:consistencyQuality a :ReasoningStateQuality, schema:DefinedTerm ;
    schema:name "Consistency"@en ;
    schema:description "The user's objectives, priorities, and guardrails continue guiding the AI's reasoning rather than fading out of context."@en ;
    schema:isPartOf :qualitiesSection .

:recoverabilityQuality a :ReasoningStateQuality, schema:DefinedTerm ;
    schema:name "Recoverability"@en ;
    schema:description "The reasoning state can be restored whenever a conversation drifts — whether at the start of a new conversation, mid-conversation, or weeks later when the task continues."@en ;
    schema:isPartOf :qualitiesSection .

# ── Critical perspectives: agent-rdf-memory alignment ────────────────────

:criticalPerspectivesSection a schema:CreativeWork ;
    schema:name "How agent-rdf-memory Already Answers This Thesis"@en ;
    schema:description "An agent-authored alignment showing that agent-rdf-memory, an RDF-based agent memory harness, already implements the durable Reasoning State layer this thesis calls for — and where the analogy still has real limits."@en ;
    schema:author <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/kg-generator#this> ;
    schema:accountablePerson kidehen:this ;
    prov:wasGeneratedBy <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/kg-generator#this> ;
    schema:isPartOf :analysis ;
    schema:hasPart :agentRdfMemoryAsReasoningState, :fourLayerMappingPerspective,
        :continuityConsistencyRecoverabilityPerspective, :sparqlRecoverabilityPerspective,
        :limitOfAnalogyPerspective .
:analysis schema:hasPart :criticalPerspectivesSection .

:agentRdfMemoryAsReasoningState a karp:CriticalPerspective ;
    schema:name "agent-rdf-memory Is a Working Reasoning State Engineering Implementation"@en ;
    schema:text "Schmarzo's diagnosis — that objectives, priorities, assumptions, decisions, and definitions have 'no durable home by default' inside a conversation — describes exactly the gap ace:AgentRdfMemoryRepo was built to close. Its sessions/ directory, entities/ directory, and preferences.ttl are precisely the reasoning state: not a transcript of what was said, but a structured record of what was decided, why, and under what constraint."@en ;
    schema:author <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/kg-generator#this> ;
    schema:accountablePerson kidehen:this ;
    schema:mentions ace:AgentRdfMemoryRepo, :reasoningStateLayer ;
    rdfs:seeAlso ace:AgentRdfMemoryRepo ;
    schema:isPartOf :criticalPerspectivesSection .

:fourLayerMappingPerspective a karp:CriticalPerspective ;
    schema:name "Each of the Four Context Layers Has a Named File in agent-rdf-memory"@en ;
    schema:text "The four-layer model maps onto concrete, inspectable artifacts rather than remaining an abstraction: Identity onto core.ttl and AGENTS.md (the agent's and user's standing identity, read every session); Knowledge onto entities/ and howto/ (persistent, reusable domain facts and behavioral skills); Reasoning State onto sessions/ and preferences.ttl (the accumulating objectives, priorities, and decisions Schmarzo says has no durable home); and Current Prompt onto the live user message, which agent-rdf-memory never tries to make durable — matching Schmarzo's own claim that this layer alone is fine as fleeting."@en ;
    schema:author <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/kg-generator#this> ;
    schema:accountablePerson kidehen:this ;
    schema:mentions :identityLayer, :knowledgeLayer, :reasoningStateLayer, :currentPromptLayer, ace:AgentRdfMemoryRepo ;
    schema:isPartOf :criticalPerspectivesSection .

:continuityConsistencyRecoverabilityPerspective a karp:CriticalPerspective ;
    schema:name "The Mandatory Session-Start Protocol Delivers the Three Qualities Mechanically"@en ;
    schema:text "agent-rdf-memory does not leave Continuity, Consistency, and Recoverability to a human remembering to re-paste context. A mandatory 9-step retrieval protocol runs at the start of every session — list the memory directory, read core.ttl, read preferences.ttl, read the private overlay, read ontology.ttl, read index.ttl, classify prompt intent, SPARQL-route context, and fall back to file reads — turning the three qualities Schmarzo names into an enforced startup sequence rather than a hoped-for habit."@en ;
    schema:author <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/kg-generator#this> ;
    schema:accountablePerson kidehen:this ;
    schema:mentions :continuityQuality, :consistencyQuality, :recoverabilityQuality, ace:AgentRdfMemoryRepo ;
    schema:isPartOf :criticalPerspectivesSection .

:sparqlRecoverabilityPerspective a karp:CriticalPerspective ;
    schema:name "SPARQL-Routed Retrieval Extends Recoverability Beyond a Flat File Re-Read"@en ;
    schema:text "Schmarzo's Recoverability claim — retrieval 'whenever necessary... weeks later when the task continues' — is easy to promise and hard to scale once a reasoning state grows into hundreds of prior decisions. agent-rdf-memory addresses that by making the reasoning state a queryable RDF graph, not just an appended file: prompt-intent classification selects a retrieval policy that SPARQL-queries the loaded graph for only the relevant prior decisions — a relevance budget, not a full dump — which is what genuine weeks-later recoverability requires once reasoning state has scaled past what fits in one prompt."@en ;
    schema:author <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/kg-generator#this> ;
    schema:accountablePerson kidehen:this ;
    schema:mentions :recoverabilityQuality, ace:AgentRdfMemoryRepo ;
    schema:isPartOf :criticalPerspectivesSection .

:limitOfAnalogyPerspective a karp:CriticalPerspective ;
    schema:name "Where the Analogy Breaks: agent-rdf-memory Assumes a Governed CLI Harness, Not a Consumer Chat Platform"@en ;
    schema:text "The alignment is not exact. YODA operates inside a consumer chat product's Activation Prompt and uploaded-file model, with no equivalent to a SessionStart hook, no local filesystem to hold sessions/ or preferences.ttl, and no SPARQL endpoint to route retrieval against. agent-rdf-memory's durability guarantees depend on a harness that can execute a mandatory protocol and query a live graph before the first token is generated — an assumption Schmarzo's own architecture cannot yet make without the platform-level activation mechanics his Part 2 promises to detail."@en ;
    schema:author <https://github.com/OpenLinkSoftware/ai-agent-skills/tree/main/kg-generator#this> ;
    schema:accountablePerson kidehen:this ;
    schema:mentions :yoda, ace:AgentRdfMemoryRepo ;
    schema:isPartOf :criticalPerspectivesSection .

# ── HowTo: operationalizing Reasoning State Engineering today ────────────

:howtoSection a schema:HowTo ;
    schema:name "How agent-rdf-memory Operationalizes Reasoning State Engineering"@en ;
    schema:description "The concrete session-start sequence that turns Schmarzo's four-layer diagnosis into an enforced retrieval routine, mapped one step at a time."@en ;
    schema:isPartOf :analysis ;
    schema:step :step1, :step2, :step3, :step4, :step5, :step6 .
:analysis schema:hasPart :howtoSection .

:step1 a schema:HowToStep ;
    schema:name "List the memory directory before anything else"@en ;
    schema:text "At session start, enumerate agent-rdf-memory/ and its subfolders so the Identity and Knowledge layers are known to exist before any reasoning begins."@en ;
    schema:position 1 ;
    schema:isPartOf :howtoSection .

:step2 a schema:HowToStep ;
    schema:name "Read the Identity layer: core.ttl"@en ;
    schema:text "Load the agent's and user's standing identity — the durable, project-level layer Schmarzo places at the top of his model."@en ;
    schema:position 2 ;
    :addressesLayer :identityLayer ;
    schema:isPartOf :howtoSection .

:step3 a schema:HowToStep ;
    schema:name "Read the Reasoning State layer: preferences.ttl and the private overlay"@en ;
    schema:text "Load the accumulated behavioral rules, confirmed decisions, and standing preferences that would otherwise live only inside a single conversation and slip once it grows."@en ;
    schema:position 3 ;
    :addressesLayer :reasoningStateLayer ;
    schema:isPartOf :howtoSection .

:step4 a schema:HowToStep ;
    schema:name "Read ontology.ttl and index.ttl"@en ;
    schema:text "Load the schema that lets prompt-intent classification later select which Knowledge-layer entities and prior Reasoning State sessions are actually relevant."@en ;
    schema:position 4 ;
    :addressesLayer :knowledgeLayer ;
    schema:isPartOf :howtoSection .

:step5 a schema:HowToStep ;
    schema:name "Classify the current prompt's intent"@en ;
    schema:text "Treat the live user message as the fragile Current Prompt layer it is — useful for direction, but never the durable source of truth."@en ;
    schema:position 5 ;
    :addressesLayer :currentPromptLayer ;
    schema:isPartOf :howtoSection .

:step6 a schema:HowToStep ;
    schema:name "SPARQL-route context, falling back to file reads"@en ;
    schema:text "Query the loaded graph for only the Reasoning State and Knowledge entries relevant to the classified intent — a relevance budget, not a full dump — falling back to direct file reads if the SPARQL endpoint is unavailable, so Recoverability degrades gracefully instead of failing closed."@en ;
    schema:position 6 ;
    :addressesLayer :reasoningStateLayer ;
    schema:isPartOf :howtoSection .

:addressesLayer a rdf:Property ;
    rdfs:label "addresses layer"@en ;
    rdfs:comment "Links a HowToStep in agent-rdf-memory's retrieval protocol to the context architecture layer it operationalizes."@en ;
    rdfs:domain schema:HowToStep ;
    rdfs:range :ContextArchitectureLayer ;
    rdfs:isDefinedBy : .

# ── FAQ ───────────────────────────────────────────────────────────────────

:faqSection a schema:FAQPage ;
    schema:name "Frequently Asked Questions"@en ;
    schema:isPartOf :analysis ;
    schema:mainEntity :q1, :q2, :q3, :q4, :q5, :q6, :q7, :q8, :q9, :q10, :q11, :q12, :q13, :q14, :q15 .
:analysis schema:hasPart :faqSection .

:q1 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "What is Reasoning State Engineering?"@en ;
    schema:acceptedAnswer :a1 .
:a1 a schema:Answer ; schema:text "The architectural layer that maintains the ongoing collaborative reasoning state — the objectives, priorities, assumptions, decisions, and definitions accumulated during an AI collaboration — as durable, recoverable infrastructure outside the conversation itself."@en .

:q2 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "What problem does Reasoning State Engineering diagnose that Context Engineering alone doesn't solve?"@en ;
    schema:acceptedAnswer :a2 .
:a2 a schema:Answer ; schema:text "Context Engineering grounds an AI in durable identity and knowledge, but the reasoning state built up during a live conversation — what the user has actually decided so far — has no durable home by default and gradually slips, even when the durable inputs are unchanged."@en .

:q3 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "What are the four architectural context layers?"@en ;
    schema:acceptedAnswer :a3 .
:a3 a schema:Answer ; schema:text "Identity (who the AI is), Knowledge (what the AI knows), Reasoning State (where you are in the work), and Current Prompt (what you just said)."@en .

:q4 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "Which of the four layers is durable and which are fragile?"@en ;
    schema:acceptedAnswer :a4 .
:a4 a schema:Answer ; schema:text "Identity and Knowledge are durable — they persist at the project level. Reasoning State and Current Prompt live only inside the conversation; Reasoning State is the one that should be durable but currently is not."@en .

:q5 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "What is 'reasoning drift' and what three qualities does it erode?"@en ;
    schema:acceptedAnswer :a5 .
:a5 a schema:Answer ; schema:text "Reasoning drift is the gradual loss of a conversation's reasoning state. It erodes Relevance (advice slides toward the generic average), Responsibility (guardrails stop applying), and Accuracy (confident generalization silently replaces evidence-based reasoning)."@en .

:q6 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "What three qualities does Reasoning State Engineering restore?"@en ;
    schema:acceptedAnswer :a6 .
:a6 a schema:Answer ; schema:text "Continuity (the initiative's thread survives), Consistency (objectives and guardrails keep guiding reasoning), and Recoverability (the reasoning state can be restored whenever a conversation drifts)."@en .

:q7 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "How does Reasoning State Engineering relate to Prompt Engineering and Context Engineering?"@en ;
    schema:acceptedAnswer :a7 .
:a7 a schema:Answer ; schema:text "They are three complementary, progressively added layers: Prompt Engineering taught AI what to do, Context Engineering taught it what to know, and Reasoning State Engineering preserves the collaborative reasoning already in place."@en .

:q8 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "What is YODA?"@en ;
    schema:acceptedAnswer :a8 .
:a8 a schema:Answer ; schema:text "YODA — Your Own Digital Assistant — is Bill Schmarzo's practical AI Thinking Partner implementation, the vehicle used to apply and stress-test Context Engineering and, in this article, Reasoning State Engineering."@en .

:q9 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "Does Reasoning State Engineering claim AI reasoning becomes error-free?"@en ;
    schema:acceptedAnswer :a9 .
:a9 a schema:Answer ; schema:text "No. The article explicitly states it doesn't eliminate today's model limitations or guarantee correct reasoning — humans stay involved to challenge assumptions, evaluate evidence, and decide."@en .

:q10 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "What will Part 2 of this article cover?"@en ;
    schema:acceptedAnswer :a10 .
:a10 a schema:Answer ; schema:text "The activation mechanics — the file, the one prompt, the routine — that YODA subscribers will use to stress-test the Reasoning State Engineering architecture in practice."@en .

:q11 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "How does agent-rdf-memory already implement the Reasoning State layer described in this thesis?"@en ;
    schema:acceptedAnswer :a11 .
:a11 a schema:Answer ; schema:text "Its sessions/ and entities/ directories plus preferences.ttl are a structured, durable record of confirmed decisions, priorities, and definitions — not a conversation transcript — which is exactly what Schmarzo says a durable reasoning state layer requires."@en .

:q12 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "Which agent-rdf-memory files correspond to each of the four context layers?"@en ;
    schema:acceptedAnswer :a12 .
:a12 a schema:Answer ; schema:text "Identity maps to core.ttl and AGENTS.md; Knowledge maps to entities/ and howto/; Reasoning State maps to sessions/ and preferences.ttl; Current Prompt maps to the live user message, deliberately left un-persisted."@en .

:q13 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "How does agent-rdf-memory's SessionStart hook deliver Continuity, Consistency, and Recoverability?"@en ;
    schema:acceptedAnswer :a13 .
:a13 a schema:Answer ; schema:text "A mandatory 9-step retrieval protocol runs automatically at session start — reading identity, preferences, ontology, and index files, then classifying intent and SPARQL-routing context — mechanically enforcing the three qualities rather than relying on the user to re-supply them."@en .

:q14 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "What capability does agent-rdf-memory add beyond what the thesis describes?"@en ;
    schema:acceptedAnswer :a14 .
:a14 a schema:Answer ; schema:text "It makes the reasoning state a queryable RDF graph rather than a file to be re-read in full — prompt-intent classification triggers a SPARQL query that retrieves only the relevant prior decisions, a relevance budget that scales as reasoning state accumulates over weeks."@en .

:q15 a schema:Question ; schema:isPartOf :faqSection ;
    schema:name "Where does the analogy between YODA and agent-rdf-memory break down?"@en ;
    schema:acceptedAnswer :a15 .
:a15 a schema:Answer ; schema:text "YODA runs inside a consumer chat product's Activation Prompt and uploaded-file model, with no equivalent to a SessionStart hook, local filesystem, or SPARQL endpoint — agent-rdf-memory's durability guarantees depend on harness-level mechanics that Schmarzo's own platform cannot yet assume without the activation details his Part 2 promises."@en .

# ── Glossary ──────────────────────────────────────────────────────────────

:glossarySection a skos:ConceptScheme, schema:DefinedTermSet ;
    schema:name "Glossary"@en ;
    schema:isPartOf :analysis ;
    schema:hasDefinedTerm :reasoningStateEngineeringLayer, :glossReasoningDrift, :glossAiThinkingPartner, :yoda,
        :glossContextEngineeringExact, :promptEngineeringLayer, :identityLayer, :knowledgeLayer, :reasoningStateLayer,
        :currentPromptLayer, :continuityQuality, :consistencyQuality, :recoverabilityQuality, :glossAgentRdfMemory .
:analysis schema:hasPart :glossarySection .

:reasoningStateEngineeringLayer schema:inDefinedTermSet :glossarySection .
:glossReasoningDrift a schema:DefinedTerm ;
    schema:name "Reasoning Drift"@en ;
    schema:description "The gradual, silent loss of a collaboration's reasoning state, causing an AI's advice to slide from user-specific reasoning back toward generic averages."@en ;
    schema:inDefinedTermSet :glossarySection .

:glossAiThinkingPartner a schema:DefinedTerm ;
    schema:name "AI Thinking Partner"@en ;
    schema:description "An AI grounded in a user's objectives, trusted knowledge, expert perspectives, and reasoning disciplines — rather than internet averages — via Context Engineering and, in this thesis, Reasoning State Engineering."@en ;
    schema:inDefinedTermSet :glossarySection .

:yoda schema:inDefinedTermSet :glossarySection .

:glossContextEngineeringExact a schema:DefinedTerm ;
    schema:name "Context Engineering"@en ;
    schema:description "The discipline of teaching AI what it needs to know — grounding it in durable identity and knowledge inputs, distinct from the ongoing Reasoning State this thesis addresses."@en ;
    skos:exactMatch ace:ContextEngineering ;
    rdfs:seeAlso <https://linkeddata.uriburner.com/DAV/demos/daas/ai-agent-memory-context-engineering-claude_sonnet_4_6-1.ttl> ;
    schema:inDefinedTermSet :glossarySection .

:promptEngineeringLayer schema:inDefinedTermSet :glossarySection .
:identityLayer schema:inDefinedTermSet :glossarySection .
:knowledgeLayer schema:inDefinedTermSet :glossarySection .
:reasoningStateLayer schema:inDefinedTermSet :glossarySection .
:currentPromptLayer schema:inDefinedTermSet :glossarySection .
:continuityQuality schema:inDefinedTermSet :glossarySection .
:consistencyQuality schema:inDefinedTermSet :glossarySection .
:recoverabilityQuality schema:inDefinedTermSet :glossarySection .

:glossAgentRdfMemory a schema:DefinedTerm ;
    schema:name "agent-rdf-memory"@en ;
    schema:description "An RDF-based agent memory harness that implements context engineering through structured Turtle files (core.ttl, preferences.ttl, index.ttl, sessions/, howto/) and a SessionStart hook — the reference implementation this document maps against Schmarzo's Reasoning State Engineering thesis."@en ;
    skos:exactMatch ace:AgentRdfMemoryRepo ;
    rdfs:seeAlso <https://linkeddata.uriburner.com/DAV/demos/daas/ai-agent-memory-context-engineering-claude_sonnet_4_6-1.ttl> ;
    schema:inDefinedTermSet :glossarySection .

