@forwardimpact/map 0.11.0

package/schema/json/framework.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.forwardimpact.team/schema/json/framework.schema.json",
+  "title": "Framework",
+  "description": "High-level framework configuration and entity definitions",
+  "type": "object",
+  "required": ["title"],
+  "properties": {
+    "title": {
+      "type": "string",
+      "description": "Title of the engineering pathway"
+    },
+    "emojiIcon": {
+      "type": "string",
+      "description": "Emoji for visual representation"
+    },
+    "tag": {
+      "type": "string",
+      "description": "Organization tag or identifier"
+    },
+    "description": {
+      "type": "string",
+      "description": "Description of the framework's purpose"
+    },
+    "entityDefinitions": {
+      "type": "object",
+      "description": "Definitions for each entity type used in pages and chapters",
+      "additionalProperties": {
+        "$ref": "#/$defs/entityDefinition"
+      }
+    },
+    "distribution": {
+      "type": "object",
+      "description": "Distribution configuration for publishing and installing the framework",
+      "properties": {
+        "siteUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "Base URL for the published static site (e.g. https://pathway.myorg.com)"
+        }
+      },
+      "required": ["siteUrl"],
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "entityDefinition": {
+      "type": "object",
+      "required": ["title"],
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "Display title for the entity"
+        },
+        "emojiIcon": {
+          "type": "string",
+          "description": "Emoji for visual representation"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of the entity type"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schema/json/levels.schema.json

@@ -0,0 +1,121 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.forwardimpact.team/schema/json/levels.schema.json",
+  "title": "Levels",
+  "description": "Career levels defining expectations for skill proficiency, behaviour maturity, and scope of impact",
+  "type": "array",
+  "items": {
+    "$ref": "#/$defs/level"
+  },
+  "$defs": {
+    "level": {
+      "type": "object",
+      "required": [
+        "id",
+        "professionalTitle",
+        "managementTitle",
+        "ordinalRank",
+        "baseSkillProficiencies",
+        "baseBehaviourMaturity"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[A-Z][A-Z0-9]*$",
+          "description": "Unique level identifier (e.g., L1, L2, L3)"
+        },
+        "professionalTitle": {
+          "type": "string",
+          "description": "Title for professional/IC track (e.g., Engineer I, Senior Engineer)"
+        },
+        "managementTitle": {
+          "type": "string",
+          "description": "Title for management track (e.g., Manager, Senior Manager)"
+        },
+        "typicalExperienceRange": {
+          "type": "string",
+          "description": "Expected years of experience range (e.g., '0-2', '5-8', '12+')"
+        },
+        "ordinalRank": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Numeric rank for ordering levels (1 = lowest)"
+        },
+        "qualificationSummary": {
+          "type": "string",
+          "description": "Summary of qualifications expected at this level. May use {typicalExperienceRange} placeholder."
+        },
+        "baseSkillProficiencies": {
+          "type": "object",
+          "description": "Base skill proficiencys by skill tier for this level",
+          "required": ["primary", "secondary", "broad"],
+          "properties": {
+            "primary": {
+              "$ref": "#/$defs/skillProficiency",
+              "description": "Level for core/primary skills"
+            },
+            "secondary": {
+              "$ref": "#/$defs/skillProficiency",
+              "description": "Level for supporting/secondary skills"
+            },
+            "broad": {
+              "$ref": "#/$defs/skillProficiency",
+              "description": "Level for broad skills"
+            }
+          },
+          "additionalProperties": false
+        },
+        "baseBehaviourMaturity": {
+          "$ref": "#/$defs/behaviourMaturity",
+          "description": "Base behaviour maturity for this level"
+        },
+        "breadthCriteria": {
+          "type": "object",
+          "description": "Minimum number of skills at each level for breadth (senior levels only)",
+          "additionalProperties": {
+            "type": "integer",
+            "minimum": 1
+          }
+        },
+        "expectations": {
+          "type": "object",
+          "description": "Expectations for impact, autonomy, influence, and complexity",
+          "properties": {
+            "impactScope": {
+              "type": "string",
+              "description": "Scope of impact expected at this level"
+            },
+            "autonomyExpectation": {
+              "type": "string",
+              "description": "Level of autonomy expected"
+            },
+            "influenceScope": {
+              "type": "string",
+              "description": "Scope of influence"
+            },
+            "complexityHandled": {
+              "type": "string",
+              "description": "Complexity level the level should handle"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "skillProficiency": {
+      "type": "string",
+      "enum": ["awareness", "foundational", "working", "practitioner", "expert"]
+    },
+    "behaviourMaturity": {
+      "type": "string",
+      "enum": [
+        "emerging",
+        "developing",
+        "practicing",
+        "role_modeling",
+        "exemplifying"
+      ]
+    }
+  }
+}

package/schema/json/self-assessments.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.forwardimpact.team/schema/json/self-assessments.schema.json",
+  "title": "Self Assessments",
+  "description": "Example candidate profiles for testing candidate matching",
+  "type": "array",
+  "items": {
+    "$ref": "#/$defs/selfAssessment"
+  },
+  "$defs": {
+    "selfAssessment": {
+      "type": "object",
+      "required": ["id"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Unique assessment identifier"
+        },
+        "skillProficiencies": {
+          "type": "object",
+          "description": "Skill assessments (skill ID → level)",
+          "additionalProperties": {
+            "$ref": "#/$defs/skillProficiency"
+          }
+        },
+        "behaviourMaturities": {
+          "type": "object",
+          "description": "Behaviour assessments (behaviour ID → maturity)",
+          "additionalProperties": {
+            "$ref": "#/$defs/behaviourMaturity"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "skillProficiency": {
+      "type": "string",
+      "enum": ["awareness", "foundational", "working", "practitioner", "expert"]
+    },
+    "behaviourMaturity": {
+      "type": "string",
+      "enum": [
+        "emerging",
+        "developing",
+        "practicing",
+        "role_modeling",
+        "exemplifying"
+      ]
+    }
+  }
+}

package/schema/json/skill-questions.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.forwardimpact.team/schema/json/skill-questions.schema.json",
+  "title": "Skill Interview Questions",
+  "description": "Interview questions for a skill, organized by role type (professional/management) and level",
+  "type": "object",
+  "properties": {
+    "professionalQuestions": {
+      "description": "Questions for professional/IC roles (e.g., engineers)",
+      "$ref": "#/$defs/levelQuestions"
+    },
+    "managementQuestions": {
+      "description": "Questions for management roles (e.g., engineering managers, product managers)",
+      "$ref": "#/$defs/levelQuestions"
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "levelQuestions": {
+      "type": "object",
+      "description": "Questions organized by skill proficiency",
+      "properties": {
+        "awareness": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/question" }
+        },
+        "foundational": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/question" }
+        },
+        "working": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/question" }
+        },
+        "practitioner": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/question" }
+        },
+        "expert": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/question" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "question": {
+      "type": "object",
+      "required": ["id", "text", "lookingFor"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Unique question identifier (format: {abbrev}_{level_abbrev}_{number})"
+        },
+        "text": {
+          "type": "string",
+          "maxLength": 150,
+          "description": "The question text (second person, under 150 characters)"
+        },
+        "lookingFor": {
+          "type": "array",
+          "description": "2-4 bullet points of good answer indicators",
+          "minItems": 1,
+          "maxItems": 4,
+          "items": { "type": "string" }
+        },
+        "expectedDurationMinutes": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Expected duration in minutes (default: 5 for awareness/foundational, 8-10 for higher)"
+        },
+        "followUps": {
+          "type": "array",
+          "description": "1-3 probing questions for deeper exploration",
+          "minItems": 1,
+          "maxItems": 3,
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schema/json/stages.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.forwardimpact.team/schema/json/stages.schema.json",
+  "title": "Stages",
+  "description": "Engineering lifecycle stages with their tools, handoffs, and constraints",
+  "type": "array",
+  "items": {
+    "$ref": "#/$defs/stage"
+  },
+  "$defs": {
+    "stage": {
+      "type": "object",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "enum": ["specify", "plan", "onboard", "code", "review", "deploy"],
+          "description": "Stage identifier"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable stage name"
+        },
+        "emojiIcon": {
+          "type": "string",
+          "description": "Emoji for visual representation"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of the stage's purpose (second-person, for agent body)"
+        },
+        "summary": {
+          "type": "string",
+          "description": "Third-person summary for metadata, listings, and sub-agent descriptions"
+        },
+        "handoffs": {
+          "type": "array",
+          "description": "Transitions to other stages",
+          "items": {
+            "$ref": "#/$defs/handoff"
+          }
+        },
+        "constraints": {
+          "type": "array",
+          "description": "Restrictions on behaviour in this stage",
+          "items": {
+            "type": "string"
+          }
+        },
+        "readChecklist": {
+          "type": "array",
+          "description": "Read-Then-Do Checklist: steps to follow in order during this stage",
+          "items": {
+            "type": "string"
+          }
+        },
+        "confirmChecklist": {
+          "type": "array",
+          "description": "Do-Then-Confirm Checklist: items to verify before handing off to next stage",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "handoff": {
+      "type": "object",
+      "required": ["targetStage", "label", "prompt"],
+      "properties": {
+        "targetStage": {
+          "type": "string",
+          "enum": ["specify", "plan", "onboard", "code", "review", "deploy"],
+          "description": "The stage to transition to"
+        },
+        "label": {
+          "type": "string",
+          "description": "Button label for the handoff action"
+        },
+        "prompt": {
+          "type": "string",
+          "description": "Instructions for the next stage"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schema/json/track.schema.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.forwardimpact.team/schema/json/track.schema.json",
+  "title": "Track",
+  "description": "Work context that modifies skill and behaviour expectations",
+  "type": "object",
+  "required": ["name"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Human-readable track name"
+    },
+    "description": {
+      "type": "string",
+      "description": "Description of the track's focus"
+    },
+    "roleContext": {
+      "type": "string",
+      "description": "Contextual description for job listings"
+    },
+    "skillModifiers": {
+      "type": "object",
+      "description": "Modifiers by capability ID (not individual skill IDs)",
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_]*$",
+        "description": "Must be a capability ID (e.g., delivery, scale, reliability)"
+      },
+      "additionalProperties": {
+        "type": "integer",
+        "description": "Level modifier to apply to all skills in this capability"
+      }
+    },
+    "behaviourModifiers": {
+      "type": "object",
+      "description": "Modifiers to behaviour expectations (behaviour ID → modifier)",
+      "additionalProperties": {
+        "type": "integer"
+      }
+    },
+    "assessmentWeights": {
+      "$ref": "#/$defs/assessmentWeights",
+      "description": "Custom weights for skill vs behaviour assessment"
+    },
+    "minLevel": {
+      "type": "string",
+      "description": "Minimum level required for this track (references level ID)"
+    },
+    "agent": {
+      "$ref": "#/$defs/trackAgentSection",
+      "description": "Agent-specific content"
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "assessmentWeights": {
+      "type": "object",
+      "required": ["skillWeight", "behaviourWeight"],
+      "properties": {
+        "skillWeight": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Weight for skills in assessment (must sum to 1 with behaviourWeight)"
+        },
+        "behaviourWeight": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Weight for behaviours in assessment (must sum to 1 with skillWeight)"
+        }
+      },
+      "additionalProperties": false
+    },
+    "trackAgentSection": {
+      "type": "object",
+      "properties": {
+        "identity": {
+          "type": "string",
+          "description": "Identity override for the agent (replaces discipline identity). May use {roleTitle} placeholder."
+        },
+        "priority": {
+          "type": "string",
+          "description": "Priority guidance specific to this track"
+        },
+        "constraints": {
+          "type": "array",
+          "description": "Additional constraints specific to this track",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schema/rdf/behaviour-questions.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#> .
+
+# =============================================================================
+# Behaviour Questions Schema
+# =============================================================================
+# Stakeholder simulation interview questions for assessing behaviours,
+# organized by role type (professional/management) and maturity level.
+# Each question presents a realistic stakeholder scenario with simulation
+# prompts to guide the interview panel.
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Properties
+# -----------------------------------------------------------------------------
+
+fit:forBehaviour a rdf:Property ;
+    rdfs:label "forBehaviour"@en ;
+    rdfs:comment "The behaviour this question assesses"@en ;
+    rdfs:domain fit:Question ;
+    rdfs:range fit:Behaviour .
+
+fit:atMaturity a rdf:Property ;
+    rdfs:label "atMaturity"@en ;
+    rdfs:comment "The behaviour maturity this question is for"@en ;
+    rdfs:domain fit:Question ;
+    rdfs:range fit:BehaviourMaturity .
+
+fit:simulationPrompts a rdf:Property ;
+    rdfs:label "simulationPrompts"@en ;
+    rdfs:comment "Guiding prompts to steer the stakeholder simulation and probe the candidate's behaviour"@en ;
+    rdfs:domain fit:Question ;
+    rdfs:range xsd:string .
+
+# =============================================================================
+# SHACL SHAPES
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Behaviour Question Shape
+# -----------------------------------------------------------------------------
+
+fit:BehaviourQuestionShape a sh:NodeShape ;
+    sh:targetClass fit:Question ;
+    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 question identifier" ;
+    ] ;
+    sh:property [
+        sh:path fit:text ;
+        sh:datatype xsd:string ;
+        sh:maxLength 300 ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "text" ;
+        sh:description "The stakeholder scenario (under 300 characters)" ;
+    ] ;
+    sh:property [
+        sh:path fit:context ;
+        sh:datatype xsd:string ;
+        sh:maxCount 1 ;
+        sh:name "context" ;
+        sh:description "Additional context to set up the simulation scenario" ;
+    ] ;
+    sh:property [
+        sh:path fit:simulationPrompts ;
+        sh:datatype xsd:string ;
+        sh:minCount 2 ;
+        sh:maxCount 5 ;
+        sh:name "simulationPrompts" ;
+        sh:description "3-5 guiding prompts to steer the simulation" ;
+    ] ;
+    sh:property [
+        sh:path fit:lookingFor ;
+        sh:datatype xsd:string ;
+        sh:minCount 2 ;
+        sh:maxCount 4 ;
+        sh:name "lookingFor" ;
+        sh:description "2-4 indicators of strong behavioural response" ;
+    ] ;
+    sh:property [
+        sh:path fit:expectedDurationMinutes ;
+        sh:datatype xsd:integer ;
+        sh:minInclusive 10 ;
+        sh:maxCount 1 ;
+        sh:name "expectedDurationMinutes" ;
+        sh:description "Expected duration in minutes (default: 20)" ;
+    ] ;
+    sh:property [
+        sh:path fit:followUps ;
+        sh:datatype xsd:string ;
+        sh:maxCount 3 ;
+        sh:name "followUps" ;
+        sh:description "1-3 probing questions for deeper exploration" ;
+    ] ;
+    sh:property [
+        sh:path fit:forBehaviour ;
+        sh:datatype xsd:string ;
+        sh:pattern "^[a-z][a-z0-9_]*$" ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "forBehaviour" ;
+        sh:description "The behaviour this question assesses (behaviour ID)" ;
+    ] ;
+    sh:property [
+        sh:path fit:atMaturity ;
+        sh:in ( fit:emerging fit:developing fit:practicing fit:role_modeling fit:exemplifying ) ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "atMaturity" ;
+        sh:description "The behaviour maturity this question is for" ;
+    ] ;
+    sh:property [
+        sh:path fit:forRoleType ;
+        sh:in ( fit:professional fit:management ) ;
+        sh:minCount 1 ;
+        sh:maxCount 1 ;
+        sh:name "forRoleType" ;
+        sh:description "The role type this question is for" ;
+    ] .