@forwardimpact/map 0.11.0

package/schema/rdf/behaviour.ttl

@@ -0,0 +1,130 @@
+@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#> .
+
+# =============================================================================
+# Behaviour Schema
+# =============================================================================
+# Mindset and way of working that underpins effective application of skills.
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Classes
+# -----------------------------------------------------------------------------
+
+fit:Behaviour a rdfs:Class ;
+    rdfs:label "Behaviour"@en ;
+    rdfs:comment "Mindset and way of working that underpins effective application of skills"@en .
+
+fit:BehaviourHumanSection a rdfs:Class ;
+    rdfs:label "Behaviour Human Section"@en ;
+    rdfs:comment "Human-specific content for a behaviour"@en .
+
+fit:BehaviourAgentSection a rdfs:Class ;
+    rdfs:label "Behaviour Agent Section"@en ;
+    rdfs:comment "Agent-specific content for a behaviour"@en .
+
+# -----------------------------------------------------------------------------
+# Properties
+# -----------------------------------------------------------------------------
+
+fit:maturityDescriptions a rdf:Property ;
+    rdfs:label "maturityDescriptions"@en ;
+    rdfs:comment "Description of expectations at each maturity level"@en ;
+    rdfs:range fit:MaturityDescriptions .
+
+fit:workingStyle a rdf:Property ;
+    rdfs:label "workingStyle"@en ;
+    rdfs:comment "How the agent should apply this behaviour"@en ;
+    rdfs:domain fit:BehaviourAgentSection ;
+    rdfs:range xsd:string .
+
+# =============================================================================
+# SHACL SHAPES
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Behaviour Shape
+# -----------------------------------------------------------------------------
+
+fit:BehaviourShape a sh:NodeShape ;
+    sh:targetClass fit:Behaviour ;
+    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 "Behaviour identifier (derived from filename)" ;
+    ] ;
+    sh:property [
+        sh:path fit:name ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "name" ;
+        sh:description "Human-readable behaviour name" ;
+    ] ;
+    sh:property [
+        sh:path fit:human ;
+        sh:node fit:BehaviourHumanSectionShape ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "human" ;
+        sh:description "Human-specific content" ;
+    ] ;
+    sh:property [
+        sh:path fit:agent ;
+        sh:node fit:BehaviourAgentSectionShape ;
+        sh:maxCount 1 ;
+        sh:name "agent" ;
+        sh:description "Agent-specific content" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Behaviour Human Section Shape
+# -----------------------------------------------------------------------------
+
+fit:BehaviourHumanSectionShape a sh:NodeShape ;
+    sh:targetClass fit:BehaviourHumanSection ;
+    sh:property [
+        sh:path fit:description ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "description" ;
+        sh:description "Description of the behaviour" ;
+    ] ;
+    sh:property [
+        sh:path fit:maturityDescriptions ;
+        sh:node fit:MaturityDescriptionsShape ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "maturityDescriptions" ;
+        sh:description "Description of expectations at each maturity level" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Behaviour Agent Section Shape
+# -----------------------------------------------------------------------------
+
+fit:BehaviourAgentSectionShape a sh:NodeShape ;
+    sh:targetClass fit:BehaviourAgentSection ;
+    sh:property [
+        sh:path fit:title ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "title" ;
+        sh:description "Short title for the behaviour's agent application" ;
+    ] ;
+    sh:property [
+        sh:path fit:workingStyle ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "workingStyle" ;
+        sh:description "How the agent should apply this behaviour" ;
+    ] .

package/schema/rdf/capability.ttl

@@ -0,0 +1,466 @@
+@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#> .
+
+# =============================================================================
+# Capability Schema
+# =============================================================================
+# Capability area that groups related skills with responsibilities and checklists.
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Classes
+# -----------------------------------------------------------------------------
+
+fit:Capability a rdfs:Class ;
+    rdfs:label "Capability"@en ;
+    rdfs:comment "Capability area that groups related skills with responsibilities and checklists"@en .
+
+fit:Skill a rdfs:Class ;
+    rdfs:label "Skill"@en ;
+    rdfs:comment "Technical or professional capability that can be measured across proficiency levels"@en .
+
+fit:SkillHumanSection a rdfs:Class ;
+    rdfs:label "Skill Human Section"@en ;
+    rdfs:comment "Human-specific content for a skill"@en .
+
+fit:SkillAgentSection a rdfs:Class ;
+    rdfs:label "Skill Agent Section"@en ;
+    rdfs:comment "Agent-specific content for a skill"@en .
+
+fit:SkillStage a rdfs:Class ;
+    rdfs:label "Skill Stage"@en ;
+    rdfs:comment "Stage-specific guidance for applying a skill"@en .
+
+fit:ToolReference a rdfs:Class ;
+    rdfs:label "Tool Reference"@en ;
+    rdfs:comment "Reference to an external tool with usage guidance"@en .
+
+# -----------------------------------------------------------------------------
+# Properties
+# -----------------------------------------------------------------------------
+
+fit:professionalResponsibilities a rdf:Property ;
+    rdfs:label "professionalResponsibilities"@en ;
+    rdfs:comment "Responsibilities for professional/IC track by level"@en ;
+    rdfs:domain fit:Capability ;
+    rdfs:range fit:ResponsibilitiesByLevel .
+
+fit:managementResponsibilities a rdf:Property ;
+    rdfs:label "managementResponsibilities"@en ;
+    rdfs:comment "Responsibilities for management track by level"@en ;
+    rdfs:domain fit:Capability ;
+    rdfs:range fit:ResponsibilitiesByLevel .
+
+fit:skills a rdf:Property ;
+    rdfs:label "skills"@en ;
+    rdfs:comment "Skills within this capability"@en ;
+    rdfs:domain fit:Capability ;
+    rdfs:range fit:Skill .
+
+fit:capability a rdf:Property ;
+    rdfs:label "capability"@en ;
+    rdfs:comment "The capability this skill belongs to"@en ;
+    rdfs:domain fit:Skill ;
+    rdfs:range fit:Capability .
+
+fit:isHumanOnly a rdf:Property ;
+    rdfs:label "isHumanOnly"@en ;
+    rdfs:comment "If true, this skill is excluded from agent profiles"@en ;
+    rdfs:domain fit:Skill ;
+    rdfs:range xsd:boolean .
+
+fit:proficiencyDescriptions a rdf:Property ;
+    rdfs:label "proficiencyDescriptions"@en ;
+    rdfs:comment "Description of expectations at each level"@en ;
+    rdfs:range fit:ProficiencyDescriptions .
+
+fit:instructions a rdf:Property ;
+    rdfs:label "instructions"@en ;
+    rdfs:comment "Step-by-step workflow guidance for the main SKILL.md body"@en ;
+    rdfs:domain fit:Skill ;
+    rdfs:range xsd:string .
+
+fit:installScript a rdf:Property ;
+    rdfs:label "installScript"@en ;
+    rdfs:comment "Shell commands for environment setup, exported to scripts/install.sh"@en ;
+    rdfs:domain fit:Skill ;
+    rdfs:range xsd:string .
+
+fit:implementationReference a rdf:Property ;
+    rdfs:label "implementationReference"@en ;
+    rdfs:comment "Code examples and detailed reference material, exported to references/REFERENCE.md"@en ;
+    rdfs:domain fit:Skill ;
+    rdfs:range xsd:string .
+
+fit:toolReferences a rdf:Property ;
+    rdfs:label "toolReferences"@en ;
+    rdfs:comment "Required tools for this skill"@en ;
+    rdfs:domain fit:Skill ;
+    rdfs:range fit:ToolReference .
+
+# Tool Reference Properties
+fit:toolName a rdf:Property ;
+    rdfs:label "toolName"@en ;
+    rdfs:comment "Name of the tool"@en ;
+    rdfs:domain fit:ToolReference ;
+    rdfs:range xsd:string .
+
+fit:toolUrl a rdf:Property ;
+    rdfs:label "toolUrl"@en ;
+    rdfs:comment "URL to tool documentation"@en ;
+    rdfs:domain fit:ToolReference ;
+    rdfs:range xsd:anyURI .
+
+fit:simpleIcon a rdf:Property ;
+    rdfs:label "simpleIcon"@en ;
+    rdfs:comment "Simple Icons slug for the tool icon"@en ;
+    rdfs:domain fit:ToolReference ;
+    rdfs:range xsd:string .
+
+fit:toolDescription a rdf:Property ;
+    rdfs:label "toolDescription"@en ;
+    rdfs:comment "What this tool does"@en ;
+    rdfs:domain fit:ToolReference ;
+    rdfs:range xsd:string .
+
+fit:toolUseWhen a rdf:Property ;
+    rdfs:label "toolUseWhen"@en ;
+    rdfs:comment "When to use this tool"@en ;
+    rdfs:domain fit:ToolReference ;
+    rdfs:range xsd:string .
+
+# Skill Agent Section Properties
+fit:useWhen a rdf:Property ;
+    rdfs:label "useWhen"@en ;
+    rdfs:comment "Triggering conditions - when agents should use this skill"@en ;
+    rdfs:domain fit:SkillAgentSection ;
+    rdfs:range xsd:string .
+
+fit:stages a rdf:Property ;
+    rdfs:label "stages"@en ;
+    rdfs:comment "Stage-specific guidance for applying the skill"@en ;
+    rdfs:domain fit:SkillAgentSection .
+
+fit:planStage a rdf:Property ;
+    rdfs:label "planStage"@en ;
+    rdfs:comment "Guidance for the plan stage"@en ;
+    rdfs:range fit:SkillStage .
+
+fit:codeStage a rdf:Property ;
+    rdfs:label "codeStage"@en ;
+    rdfs:comment "Guidance for the code stage"@en ;
+    rdfs:range fit:SkillStage .
+
+fit:reviewStage a rdf:Property ;
+    rdfs:label "reviewStage"@en ;
+    rdfs:comment "Guidance for the review stage"@en ;
+    rdfs:range fit:SkillStage .
+
+# Skill Stage Properties
+fit:focus a rdf:Property ;
+    rdfs:label "focus"@en ;
+    rdfs:comment "Primary focus for this stage"@en ;
+    rdfs:range xsd:string .
+
+fit:readChecklist a rdf:Property ;
+    rdfs:label "readChecklist"@en ;
+    rdfs:comment "Read-Then-Do Checklist: steps to follow in order during this stage"@en ;
+    rdfs:range xsd:string .
+
+fit:confirmChecklist a rdf:Property ;
+    rdfs:label "confirmChecklist"@en ;
+    rdfs:comment "Do-Then-Confirm Checklist: items to verify before moving to next stage"@en ;
+    rdfs:range xsd:string .
+
+# =============================================================================
+# SHACL SHAPES
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Capability Shape
+# -----------------------------------------------------------------------------
+
+fit:CapabilityShape a sh:NodeShape ;
+    sh:targetClass fit:Capability ;
+    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 "Capability identifier (derived from filename if not specified)" ;
+    ] ;
+    sh:property [
+        sh:path fit:name ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "name" ;
+        sh:description "Human-readable capability name" ;
+    ] ;
+    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:ordinalRank ;
+        sh:datatype xsd:integer ;
+        sh:minInclusive 1 ;
+        sh:maxCount 1 ;
+        sh:name "ordinalRank" ;
+        sh:description "Numeric rank for ordering capabilities (1 = first)" ;
+    ] ;
+    sh:property [
+        sh:path fit:description ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "description" ;
+        sh:description "Description of the capability area" ;
+    ] ;
+    sh:property [
+        sh:path fit:professionalResponsibilities ;
+        sh:node fit:ResponsibilitiesByLevelShape ;
+        sh:maxCount 1 ;
+        sh:name "professionalResponsibilities" ;
+        sh:description "Responsibilities for professional/IC track by level" ;
+    ] ;
+    sh:property [
+        sh:path fit:managementResponsibilities ;
+        sh:node fit:ResponsibilitiesByLevelShape ;
+        sh:maxCount 1 ;
+        sh:name "managementResponsibilities" ;
+        sh:description "Responsibilities for management track by level" ;
+    ] ;
+    sh:property [
+        sh:path fit:skills ;
+        sh:node fit:SkillShape ;
+        sh:name "skills" ;
+        sh:description "Skills within this capability" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Skill Shape
+# -----------------------------------------------------------------------------
+
+fit:SkillShape a sh:NodeShape ;
+    sh:targetClass fit:Skill ;
+    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 skill 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 skill name" ;
+    ] ;
+    sh:property [
+        sh:path fit:isHumanOnly ;
+        sh:datatype xsd:boolean ;
+        sh:maxCount 1 ;
+        sh:name "isHumanOnly" ;
+        sh:description "If true, this skill is excluded from agent profiles" ;
+    ] ;
+    sh:property [
+        sh:path fit:human ;
+        sh:node fit:SkillHumanSectionShape ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "human" ;
+        sh:description "Human-specific content for the skill" ;
+    ] ;
+    sh:property [
+        sh:path fit:agent ;
+        sh:node fit:SkillAgentSectionShape ;
+        sh:maxCount 1 ;
+        sh:name "agent" ;
+        sh:description "Agent-specific content for the skill" ;
+    ] ;
+    sh:property [
+        sh:path fit:toolReferences ;
+        sh:node fit:ToolReferenceShape ;
+        sh:name "toolReferences" ;
+        sh:description "Required tools for this skill" ;
+    ] ;
+    sh:property [
+        sh:path fit:instructions ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "instructions" ;
+        sh:description "Step-by-step workflow guidance for the main SKILL.md body" ;
+    ] ;
+    sh:property [
+        sh:path fit:installScript ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "installScript" ;
+        sh:description "Shell commands for environment setup, exported to scripts/install.sh" ;
+    ] ;
+    sh:property [
+        sh:path fit:implementationReference ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "implementationReference" ;
+        sh:description "Code examples and detailed reference material, exported to references/REFERENCE.md" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Tool Reference Shape
+# -----------------------------------------------------------------------------
+
+fit:ToolReferenceShape a sh:NodeShape ;
+    sh:targetClass fit:ToolReference ;
+    sh:property [
+        sh:path fit:toolName ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "name" ;
+        sh:description "Tool name" ;
+    ] ;
+    sh:property [
+        sh:path fit:toolUrl ;
+        sh:datatype xsd:anyURI ;
+        sh:maxCount 1 ;
+        sh:name "url" ;
+        sh:description "Link to tool documentation" ;
+    ] ;
+    sh:property [
+        sh:path fit:simpleIcon ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z0-9]+$" ;
+        sh:maxCount 1 ;
+        sh:name "simpleIcon" ;
+        sh:description "Simple Icons slug for the tool icon" ;
+    ] ;
+    sh:property [
+        sh:path fit:toolDescription ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "description" ;
+        sh:description "What this tool does" ;
+    ] ;
+    sh:property [
+        sh:path fit:toolUseWhen ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "useWhen" ;
+        sh:description "When to use this tool" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Skill Human Section Shape
+# -----------------------------------------------------------------------------
+
+fit:SkillHumanSectionShape a sh:NodeShape ;
+    sh:targetClass fit:SkillHumanSection ;
+    sh:property [
+        sh:path fit:description ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "description" ;
+        sh:description "Description of the skill" ;
+    ] ;
+    sh:property [
+        sh:path fit:proficiencyDescriptions ;
+        sh:node fit:ProficiencyDescriptionsShape ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "proficiencyDescriptions" ;
+        sh:description "Description of expectations at each level" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Skill Agent Section Shape
+# -----------------------------------------------------------------------------
+
+fit:SkillAgentSectionShape a sh:NodeShape ;
+    sh:targetClass fit:SkillAgentSection ;
+    sh:property [
+        sh:path fit:name ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9-]*$" ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "name" ;
+        sh:description "Agent skill name (kebab-case)" ;
+    ] ;
+    sh:property [
+        sh:path fit:description ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "description" ;
+        sh:description "Brief description of what this skill provides" ;
+    ] ;
+    sh:property [
+        sh:path fit:useWhen ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "useWhen" ;
+        sh:description "Triggering conditions - when agents should use this skill" ;
+    ] ;
+    sh:property [
+        sh:path fit:planStage ;
+        sh:node fit:SkillStageShape ;
+        sh:maxCount 1 ;
+        sh:name "plan" ;
+    ] ;
+    sh:property [
+        sh:path fit:codeStage ;
+        sh:node fit:SkillStageShape ;
+        sh:maxCount 1 ;
+        sh:name "code" ;
+    ] ;
+    sh:property [
+        sh:path fit:reviewStage ;
+        sh:node fit:SkillStageShape ;
+        sh:maxCount 1 ;
+        sh:name "review" ;
+    ] .
+
+# -----------------------------------------------------------------------------
+# Skill Stage Shape
+# -----------------------------------------------------------------------------
+
+fit:SkillStageShape a sh:NodeShape ;
+    sh:targetClass fit:SkillStage ;
+    sh:property [
+        sh:path fit:focus ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "focus" ;
+        sh:description "Primary focus for this stage" ;
+    ] ;
+    sh:property [
+        sh:path fit:readChecklist ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:name "readChecklist" ;
+        sh:description "Read-Then-Do Checklist: steps to follow in order during this stage" ;
+    ] ;
+    sh:property [
+        sh:path fit:confirmChecklist ;
+        sh:datatype xsd:string ;
+        sh:minCount 1 ;
+        sh:name "confirmChecklist" ;
+        sh:description "Do-Then-Confirm Checklist: items to verify before moving to next stage" ;
+    ] .