@forwardimpact/schema 0.1.0

package/schema/json/drivers.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schema.forwardimpact.team/json/drivers.schema.json",
+  "title": "Drivers",
+  "description": "Organizational outcomes that productive teams achieve",
+  "type": "array",
+  "items": {
+    "$ref": "#/$defs/driver"
+  },
+  "$defs": {
+    "driver": {
+      "type": "object",
+      "required": ["id", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Unique driver identifier (snake_case)"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable driver name"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of the business outcome"
+        },
+        "contributingSkills": {
+          "type": "array",
+          "description": "Skills that contribute to this driver (references skill IDs)",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9_]*$"
+          }
+        },
+        "contributingBehaviours": {
+          "type": "array",
+          "description": "Behaviours that contribute to this driver (references behaviour IDs)",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9_]*$"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schema/json/framework.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schema.forwardimpact.team/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"
+      }
+    }
+  },
+  "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/grades.schema.json

@@ -0,0 +1,121 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schema.forwardimpact.team/json/grades.schema.json",
+  "title": "Grades",
+  "description": "Career levels defining expectations for skill proficiency, behaviour maturity, and scope of impact",
+  "type": "array",
+  "items": {
+    "$ref": "#/$defs/grade"
+  },
+  "$defs": {
+    "grade": {
+      "type": "object",
+      "required": [
+        "id",
+        "professionalTitle",
+        "managementTitle",
+        "ordinalRank",
+        "baseSkillLevels",
+        "baseBehaviourMaturity"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[A-Z][A-Z0-9]*$",
+          "description": "Unique grade 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 grades (1 = lowest)"
+        },
+        "qualificationSummary": {
+          "type": "string",
+          "description": "Summary of qualifications expected at this grade. May use {typicalExperienceRange} placeholder."
+        },
+        "baseSkillLevels": {
+          "type": "object",
+          "description": "Base skill levels by skill tier for this grade",
+          "required": ["primary", "secondary", "broad"],
+          "properties": {
+            "primary": {
+              "$ref": "#/$defs/skillLevel",
+              "description": "Level for core/primary skills"
+            },
+            "secondary": {
+              "$ref": "#/$defs/skillLevel",
+              "description": "Level for supporting/secondary skills"
+            },
+            "broad": {
+              "$ref": "#/$defs/skillLevel",
+              "description": "Level for broad skills"
+            }
+          },
+          "additionalProperties": false
+        },
+        "baseBehaviourMaturity": {
+          "$ref": "#/$defs/behaviourMaturity",
+          "description": "Base behaviour maturity for this grade"
+        },
+        "breadthCriteria": {
+          "type": "object",
+          "description": "Minimum number of skills at each level for breadth (senior grades 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 grade"
+            },
+            "autonomyExpectation": {
+              "type": "string",
+              "description": "Level of autonomy expected"
+            },
+            "influenceScope": {
+              "type": "string",
+              "description": "Scope of influence"
+            },
+            "complexityHandled": {
+              "type": "string",
+              "description": "Complexity level the grade should handle"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "skillLevel": {
+      "type": "string",
+      "enum": ["awareness", "foundational", "working", "practitioner", "expert"]
+    },
+    "behaviourMaturity": {
+      "type": "string",
+      "enum": [
+        "emerging",
+        "developing",
+        "practicing",
+        "role_modeling",
+        "exemplifying"
+      ]
+    }
+  }
+}

package/schema/json/index.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schema.forwardimpact.team/json/index.schema.json",
+  "title": "Auto-generated Index",
+  "description": "Index file for browser loading, generated by npx pathway --generate-index",
+  "type": "object",
+  "required": ["files"],
+  "properties": {
+    "files": {
+      "type": "array",
+      "description": "List of file basenames (without extension) in the directory",
+      "items": {
+        "type": "string"
+      }
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,52 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schema.forwardimpact.team/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"
+        },
+        "skillLevels": {
+          "type": "object",
+          "description": "Skill assessments (skill ID → level)",
+          "additionalProperties": {
+            "$ref": "#/$defs/skillLevel"
+          }
+        },
+        "behaviourMaturities": {
+          "type": "object",
+          "description": "Behaviour assessments (behaviour ID → maturity)",
+          "additionalProperties": {
+            "$ref": "#/$defs/behaviourMaturity"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "skillLevel": {
+      "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,68 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schema.forwardimpact.team/json/skill-questions.schema.json",
+  "title": "Skill Interview Questions",
+  "description": "Interview questions for a skill, organized by level",
+  "type": "object",
+  "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,
+  "$defs": {
+    "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,84 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schema.forwardimpact.team/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", "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"
+        },
+        "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"
+          }
+        },
+        "entryCriteria": {
+          "type": "array",
+          "description": "Conditions that must be met before entering this stage",
+          "items": {
+            "type": "string"
+          }
+        },
+        "exitCriteria": {
+          "type": "array",
+          "description": "Conditions that must be met before leaving this stage",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "handoff": {
+      "type": "object",
+      "required": ["targetStage", "label", "prompt"],
+      "properties": {
+        "targetStage": {
+          "type": "string",
+          "enum": ["specify", "plan", "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,100 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://schema.forwardimpact.team/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"
+    },
+    "minGrade": {
+      "type": "string",
+      "description": "Minimum grade required for this track (references grade 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"
+        },
+        "beforeMakingChanges": {
+          "type": "array",
+          "description": "Additional checklist items to consider",
+          "items": { "type": "string" }
+        },
+        "constraints": {
+          "type": "array",
+          "description": "Additional constraints specific to this track",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}