@forwardimpact/schema 0.1.0 → 0.2.0

package/schema/rdf/discipline.ttl

@@ -0,0 +1,336 @@
+@prefix fit: <https://www.forwardimpact.team/schema/rdf/> .
+@prefix sh: <http://www.w3.org/ns/shacl#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+
+# =============================================================================
+# Discipline Schema
+# =============================================================================
+# Engineering specialization that defines T-shaped skill profiles.
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Classes
+# -----------------------------------------------------------------------------
+
+fit:Discipline a rdfs:Class ;
+    rdfs:label "Discipline"@en ;
+    rdfs:comment "Engineering specialization that defines T-shaped skill profiles"@en .
+
+fit:DisciplineHumanSection a rdfs:Class ;
+    rdfs:label "Discipline Human Section"@en ;
+    rdfs:comment "Human-specific content for a discipline"@en .
+
+fit:DisciplineAgentSection a rdfs:Class ;
+    rdfs:label "Discipline Agent Section"@en ;
+    rdfs:comment "Agent-specific content for a discipline"@en .
+
+fit:BehaviourModifier a rdfs:Class ;
+    rdfs:label "Behaviour Modifier"@en ;
+    rdfs:comment "Modifier applied to a behaviour by a discipline or track"@en .
+
+# -----------------------------------------------------------------------------
+# Properties
+# -----------------------------------------------------------------------------
+
+fit:specialization a rdf:Property ;
+    rdfs:label "specialization"@en ;
+    rdfs:comment "Name of the specialization (e.g., Software Engineering)"@en ;
+    rdfs:domain fit:Discipline ;
+    rdfs:range xsd:string .
+
+fit:roleTitle a rdf:Property ;
+    rdfs:label "roleTitle"@en ;
+    rdfs:comment "Base role title (e.g., Software Engineer)"@en ;
+    rdfs:domain fit:Discipline ;
+    rdfs:range xsd:string .
+
+fit:isProfessional a rdf:Property ;
+    rdfs:label "isProfessional"@en ;
+    rdfs:comment "If true, this is an IC/professional discipline (default true)"@en ;
+    rdfs:domain fit:Discipline ;
+    rdfs:range xsd:boolean .
+
+fit:isManagement a rdf:Property ;
+    rdfs:label "isManagement"@en ;
+    rdfs:comment "If true, this is a management discipline (default false)"@en ;
+    rdfs:domain fit:Discipline ;
+    rdfs:range xsd:boolean .
+
+fit:validTracks a rdf:Property ;
+    rdfs:label "validTracks"@en ;
+    rdfs:comment "REQUIRED. Explicit list of valid tracks. Empty array = trackless only."@en ;
+    rdfs:domain fit:Discipline ;
+    rdfs:range fit:Track .
+
+fit:coreSkills a rdf:Property ;
+    rdfs:label "coreSkills"@en ;
+    rdfs:comment "Primary skills for deep expertise (references skill IDs)"@en ;
+    rdfs:domain fit:Discipline ;
+    rdfs:range fit:Skill .
+
+fit:supportingSkills a rdf:Property ;
+    rdfs:label "supportingSkills"@en ;
+    rdfs:comment "Secondary skills for supporting capabilities (references skill IDs)"@en ;
+    rdfs:domain fit:Discipline ;
+    rdfs:range fit:Skill .
+
+fit:broadSkills a rdf:Property ;
+    rdfs:label "broadSkills"@en ;
+    rdfs:comment "Skills for general awareness (references skill IDs)"@en ;
+    rdfs:domain fit:Discipline ;
+    rdfs:range fit:Skill .
+
+fit:behaviourModifiers a rdf:Property ;
+    rdfs:label "behaviourModifiers"@en ;
+    rdfs:comment "Modifiers to behaviour expectations"@en .
+
+fit:professionalRoleSummary a rdf:Property ;
+    rdfs:label "professionalRoleSummary"@en ;
+    rdfs:comment "Role summary for professional/IC track. May use {roleTitle} placeholder."@en ;
+    rdfs:domain fit:DisciplineHumanSection ;
+    rdfs:range xsd:string .
+
+fit:managementRoleSummary a rdf:Property ;
+    rdfs:label "managementRoleSummary"@en ;
+    rdfs:comment "Role summary for management track. May use {specialization} placeholder."@en ;
+    rdfs:domain fit:DisciplineHumanSection ;
+    rdfs:range xsd:string .
+
+# Agent Section Properties
+fit:identity a rdf:Property ;
+    rdfs:label "identity"@en ;
+    rdfs:comment "Core identity statement for the agent"@en ;
+    rdfs:range xsd:string .
+
+fit:priority a rdf:Property ;
+    rdfs:label "priority"@en ;
+    rdfs:comment "Priority guidance for the agent"@en ;
+    rdfs:range xsd:string .
+
+fit:beforeMakingChanges a rdf:Property ;
+    rdfs:label "beforeMakingChanges"@en ;
+    rdfs:comment "Checklist items to consider before making changes"@en ;
+    rdfs:range xsd:string .
+
+fit:delegation a rdf:Property ;
+    rdfs:label "delegation"@en ;
+    rdfs:comment "Guidance on when and how to delegate to subagents"@en ;
+    rdfs:range xsd:string .
+
+# Modifier Properties
+fit:targetBehaviour a rdf:Property ;
+    rdfs:label "targetBehaviour"@en ;
+    rdfs:comment "The behaviour this modifier applies to"@en ;
+    rdfs:domain fit:BehaviourModifier ;
+    rdfs:range fit:Behaviour .
+
+fit:modifierValue a rdf:Property ;
+    rdfs:label "modifierValue"@en ;
+    rdfs:comment "The modifier value (-1, 0, or 1)"@en ;
+    rdfs:range xsd:integer .
+
+# =============================================================================
+# SHACL SHAPES
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Discipline Shape
+# -----------------------------------------------------------------------------
+
+fit:DisciplineShape a sh:NodeShape ;
+    sh:targetClass fit:Discipline ;
+    sh:property [
+        sh:path fit:id ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9_]*$" ;
+        sh:maxCount 1 ;
+        sh:name "id" ;
+        sh:description "Discipline identifier (derived from filename)" ;
+    ] ;
+    sh:property [
+        sh:path fit:specialization ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "specialization" ;
+        sh:description "Name of the specialization (e.g., Software Engineering)" ;
+    ] ;
+    sh:property [
+        sh:path fit:roleTitle ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "roleTitle" ;
+        sh:description "Base role title (e.g., Software Engineer)" ;
+    ] ;
+    sh:property [
+        sh:path fit:isProfessional ;
+        sh:datatype xsd:boolean ;
+        sh:maxCount 1 ;
+        sh:name "isProfessional" ;
+        sh:description "If true, this is an IC/professional discipline (default true)" ;
+    ] ;
+    sh:property [
+        sh:path fit:isManagement ;
+        sh:datatype xsd:boolean ;
+        sh:maxCount 1 ;
+        sh:name "isManagement" ;
+        sh:description "If true, this is a management discipline (default false)" ;
+    ] ;
+    sh:property [
+        sh:path fit:validTracks ;
+        sh:minCount 1 ;
+        sh:name "validTracks" ;
+        sh:description "REQUIRED. Valid track configurations. Use null for trackless (generalist)." ;
+        sh:or (
+            [ sh:datatype xsd:string ; sh:pattern "^[a-z][a-z0-9_]*$" ]
+            [ sh:nodeKind sh:Literal ; sh:hasValue "null" ]
+        ) ;
+    ] ;
+    sh:property [
+        sh:path fit:minGrade ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[A-Z][A-Z0-9]*$" ;
+        sh:maxCount 1 ;
+        sh:name "minGrade" ;
+        sh:description "Minimum grade required for this discipline (grade ID)" ;
+    ] ;
+    sh:property [
+        sh:path fit:description ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "description" ;
+        sh:description "Description of the discipline's focus" ;
+    ] ;
+    sh:property [
+        sh:path fit:coreSkills ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9_]*$" ;
+        sh:minCount 1 ;
+        sh:name "coreSkills" ;
+        sh:description "Primary skills for deep expertise (skill IDs)" ;
+    ] ;
+    sh:property [
+        sh:path fit:supportingSkills ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9_]*$" ;
+        sh:name "supportingSkills" ;
+        sh:description "Secondary skills for supporting capabilities (skill IDs)" ;
+    ] ;
+    sh:property [
+        sh:path fit:broadSkills ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9_]*$" ;
+        sh:name "broadSkills" ;
+        sh:description "Skills for general awareness (skill IDs)" ;
+    ] ;
+    sh:property [
+        sh:path fit:behaviourModifiers ;
+        sh:node fit:BehaviourModifierShape ;
+        sh:name "behaviourModifiers" ;
+        sh:description "Modifiers to behaviour expectations" ;
+    ] ;
+    sh:property [
+        sh:path fit:human ;
+        sh:node fit:DisciplineHumanSectionShape ;
+        sh:maxCount 1 ;
+        sh:name "human" ;
+        sh:description "Human-specific content" ;
+    ] ;
+    sh:property [
+        sh:path fit:agent ;
+        sh:node fit:DisciplineAgentSectionShape ;
+        sh:maxCount 1 ;
+        sh:name "agent" ;
+        sh:description "Agent-specific content" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Discipline Human Section Shape
+# -----------------------------------------------------------------------------
+
+fit:DisciplineHumanSectionShape a sh:NodeShape ;
+    sh:targetClass fit:DisciplineHumanSection ;
+    sh:property [
+        sh:path fit:professionalRoleSummary ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "professionalRoleSummary" ;
+        sh:description "Role summary for professional/IC track" ;
+    ] ;
+    sh:property [
+        sh:path fit:managementRoleSummary ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "managementRoleSummary" ;
+        sh:description "Role summary for management track" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Discipline Agent Section Shape
+# -----------------------------------------------------------------------------
+
+fit:DisciplineAgentSectionShape a sh:NodeShape ;
+    sh:targetClass fit:DisciplineAgentSection ;
+    sh:property [
+        sh:path fit:identity ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "identity" ;
+        sh:description "Core identity statement for the agent" ;
+    ] ;
+    sh:property [
+        sh:path fit:priority ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "priority" ;
+        sh:description "Priority guidance for the agent" ;
+    ] ;
+    sh:property [
+        sh:path fit:beforeMakingChanges ;
+        sh:datatype xsd:string ;
+        sh:name "beforeMakingChanges" ;
+        sh:description "Checklist items to consider before making changes" ;
+    ] ;
+    sh:property [
+        sh:path fit:delegation ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "delegation" ;
+        sh:description "Guidance on when and how to delegate to subagents" ;
+    ] ;
+    sh:property [
+        sh:path fit:constraints ;
+        sh:datatype xsd:string ;
+        sh:name "constraints" ;
+        sh:description "Things the agent should avoid or never do" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Behaviour Modifier Shape
+# -----------------------------------------------------------------------------
+
+fit:BehaviourModifierShape a sh:NodeShape ;
+    sh:targetClass fit:BehaviourModifier ;
+    sh:property [
+        sh:path fit:targetBehaviour ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9_]*$" ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "targetBehaviour" ;
+        sh:description "The behaviour this modifier applies to" ;
+    ] ;
+    sh:property [
+        sh:path fit:modifierValue ;
+        sh:datatype xsd:integer ;
+        sh:minInclusive -1 ;
+        sh:maxInclusive 1 ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "modifierValue" ;
+        sh:description "Modifier value (-1, 0, or 1)" ;
+    ] .

package/schema/rdf/drivers.ttl

@@ -0,0 +1,84 @@
+@prefix fit: <https://www.forwardimpact.team/schema/rdf/> .
+@prefix sh: <http://www.w3.org/ns/shacl#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+
+# =============================================================================
+# Drivers Schema
+# =============================================================================
+# Organizational outcomes that productive teams achieve.
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Classes
+# -----------------------------------------------------------------------------
+
+fit:Driver a rdfs:Class ;
+    rdfs:label "Driver"@en ;
+    rdfs:comment "Organizational outcome that productive teams achieve"@en .
+
+# -----------------------------------------------------------------------------
+# Properties
+# -----------------------------------------------------------------------------
+
+fit:contributingSkills a rdf:Property ;
+    rdfs:label "contributingSkills"@en ;
+    rdfs:comment "Skills that contribute to this driver"@en ;
+    rdfs:domain fit:Driver ;
+    rdfs:range fit:Skill .
+
+fit:contributingBehaviours a rdf:Property ;
+    rdfs:label "contributingBehaviours"@en ;
+    rdfs:comment "Behaviours that contribute to this driver"@en ;
+    rdfs:domain fit:Driver ;
+    rdfs:range fit:Behaviour .
+
+# =============================================================================
+# SHACL SHAPES
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Driver Shape
+# -----------------------------------------------------------------------------
+
+fit:DriverShape a sh:NodeShape ;
+    sh:targetClass fit:Driver ;
+    sh:property [
+        sh:path fit:id ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9_]*$" ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "id" ;
+        sh:description "Unique driver identifier (snake_case)" ;
+    ] ;
+    sh:property [
+        sh:path fit:name ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "name" ;
+        sh:description "Human-readable driver name" ;
+    ] ;
+    sh:property [
+        sh:path fit:description ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "description" ;
+        sh:description "Description of the business outcome" ;
+    ] ;
+    sh:property [
+        sh:path fit:contributingSkills ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9_]*$" ;
+        sh:name "contributingSkills" ;
+        sh:description "Skills that contribute to this driver (skill IDs)" ;
+    ] ;
+    sh:property [
+        sh:path fit:contributingBehaviours ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9_]*$" ;
+        sh:name "contributingBehaviours" ;
+        sh:description "Behaviours that contribute to this driver (behaviour IDs)" ;
+    ] .

package/schema/rdf/framework.ttl

@@ -0,0 +1,128 @@
+@prefix fit: <https://www.forwardimpact.team/schema/rdf/> .
+@prefix sh: <http://www.w3.org/ns/shacl#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+
+# =============================================================================
+# Framework Schema
+# =============================================================================
+# High-level framework configuration.
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Classes
+# -----------------------------------------------------------------------------
+
+fit:Framework a rdfs:Class ;
+    rdfs:label "Framework"@en ;
+    rdfs:comment "High-level framework configuration"@en .
+
+fit:EntityDefinition a rdfs:Class ;
+    rdfs:label "Entity Definition"@en ;
+    rdfs:comment "Definition for an entity type used in pages and chapters"@en .
+
+# -----------------------------------------------------------------------------
+# Properties
+# -----------------------------------------------------------------------------
+
+fit:tag a rdf:Property ;
+    rdfs:label "tag"@en ;
+    rdfs:comment "Organization tag or identifier"@en ;
+    rdfs:domain fit:Framework ;
+    rdfs:range xsd:string .
+
+fit:entityDefinitions a rdf:Property ;
+    rdfs:label "entityDefinitions"@en ;
+    rdfs:comment "Definitions for each entity type"@en ;
+    rdfs:domain fit:Framework ;
+    rdfs:range fit:EntityDefinition .
+
+fit:entityType a rdf:Property ;
+    rdfs:label "entityType"@en ;
+    rdfs:comment "The type of entity this definition describes"@en ;
+    rdfs:domain fit:EntityDefinition ;
+    rdfs:range xsd:string .
+
+# =============================================================================
+# SHACL SHAPES
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Framework Shape
+# -----------------------------------------------------------------------------
+
+fit:FrameworkShape a sh:NodeShape ;
+    sh:targetClass fit:Framework ;
+    sh:property [
+        sh:path fit:title ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "title" ;
+        sh:description "Title of the engineering pathway" ;
+    ] ;
+    sh:property [
+        sh:path fit:emojiIcon ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "emojiIcon" ;
+        sh:description "Emoji for visual representation" ;
+    ] ;
+    sh:property [
+        sh:path fit:tag ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "tag" ;
+        sh:description "Organization tag or identifier" ;
+    ] ;
+    sh:property [
+        sh:path fit:description ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "description" ;
+        sh:description "Description of the framework's purpose" ;
+    ] ;
+    sh:property [
+        sh:path fit:entityDefinitions ;
+        sh:node fit:EntityDefinitionShape ;
+        sh:name "entityDefinitions" ;
+        sh:description "Definitions for each entity type" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Entity Definition Shape
+# -----------------------------------------------------------------------------
+
+fit:EntityDefinitionShape a sh:NodeShape ;
+    sh:targetClass fit:EntityDefinition ;
+    sh:property [
+        sh:path fit:entityType ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "entityType" ;
+        sh:description "The type of entity this definition describes" ;
+    ] ;
+    sh:property [
+        sh:path fit:title ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "title" ;
+        sh:description "Display title for the entity" ;
+    ] ;
+    sh:property [
+        sh:path fit:emojiIcon ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "emojiIcon" ;
+        sh:description "Emoji for visual representation" ;
+    ] ;
+    sh:property [
+        sh:path fit:description ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "description" ;
+        sh:description "Description of the entity type" ;
+    ] .