@forwardimpact/map 0.11.0

package/schema/json/capability-questions.schema.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.forwardimpact.team/schema/json/capability-questions.schema.json",
+  "title": "Capability Decomposition Questions",
+  "description": "Decomposition interview questions for a capability, organized by role type (professional/management) and level. Inspired by Palantir's decomposition interview technique.",
+  "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 capability level",
+      "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", "decompositionPrompts"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Unique question identifier (format: {capability_abbrev}_{level_abbrev}_{number})"
+        },
+        "text": {
+          "type": "string",
+          "maxLength": 200,
+          "description": "The problem statement or scenario (second person, open-ended)"
+        },
+        "context": {
+          "type": "string",
+          "description": "Optional additional context to set up the scenario"
+        },
+        "decompositionPrompts": {
+          "type": "array",
+          "description": "3-5 guiding questions to help the candidate structure their thinking",
+          "minItems": 2,
+          "maxItems": 5,
+          "items": { "type": "string" }
+        },
+        "lookingFor": {
+          "type": "array",
+          "description": "2-4 indicators of a strong decomposition approach",
+          "minItems": 2,
+          "maxItems": 4,
+          "items": { "type": "string" }
+        },
+        "expectedDurationMinutes": {
+          "type": "integer",
+          "minimum": 5,
+          "default": 15,
+          "description": "Expected duration in minutes (default: 15 for decomposition)"
+        },
+        "followUps": {
+          "type": "array",
+          "description": "1-3 probing questions for deeper exploration",
+          "minItems": 1,
+          "maxItems": 3,
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schema/json/capability.schema.json

@@ -0,0 +1,229 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.forwardimpact.team/schema/json/capability.schema.json",
+  "title": "Capability",
+  "description": "Capability area that groups related skills with responsibilities and checklists",
+  "type": "object",
+  "required": ["name"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "Capability identifier (derived from filename if not specified)"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable capability name"
+    },
+    "emojiIcon": {
+      "type": "string",
+      "description": "Emoji for visual representation"
+    },
+    "ordinalRank": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Numeric rank for ordering capabilities (1 = first)"
+    },
+    "description": {
+      "type": "string",
+      "description": "Description of the capability area"
+    },
+    "professionalResponsibilities": {
+      "$ref": "#/$defs/responsibilitiesByLevel",
+      "description": "Responsibilities for professional/IC track by level"
+    },
+    "managementResponsibilities": {
+      "$ref": "#/$defs/responsibilitiesByLevel",
+      "description": "Responsibilities for management track by level"
+    },
+    "skills": {
+      "type": "array",
+      "description": "Skills within this capability",
+      "items": {
+        "$ref": "#/$defs/skill"
+      }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "responsibilitiesByLevel": {
+      "type": "object",
+      "properties": {
+        "awareness": { "type": "string" },
+        "foundational": { "type": "string" },
+        "working": { "type": "string" },
+        "practitioner": { "type": "string" },
+        "expert": { "type": "string" }
+      },
+      "required": [
+        "awareness",
+        "foundational",
+        "working",
+        "practitioner",
+        "expert"
+      ],
+      "additionalProperties": false
+    },
+    "skill": {
+      "type": "object",
+      "required": ["id", "name", "human"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]*$",
+          "description": "Unique skill identifier (snake_case)"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable skill name"
+        },
+        "isHumanOnly": {
+          "type": "boolean",
+          "description": "If true, this skill is excluded from agent profiles"
+        },
+        "human": {
+          "$ref": "#/$defs/skillHumanSection",
+          "description": "Human-specific content for the skill"
+        },
+        "agent": {
+          "$ref": "#/$defs/skillAgentSection",
+          "description": "Agent-specific content for the skill"
+        },
+        "toolReferences": {
+          "type": "array",
+          "description": "Required tools for this skill",
+          "items": { "$ref": "#/$defs/toolReference" }
+        },
+        "instructions": {
+          "type": "string",
+          "description": "Step-by-step workflow guidance for the main SKILL.md body"
+        },
+        "installScript": {
+          "type": "string",
+          "description": "Shell commands for environment setup, exported to scripts/install.sh"
+        },
+        "implementationReference": {
+          "type": "string",
+          "description": "Code examples and detailed reference material, exported to references/REFERENCE.md"
+        }
+      },
+      "additionalProperties": false
+    },
+    "toolReference": {
+      "type": "object",
+      "required": ["name", "description", "useWhen"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Tool name"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Link to tool documentation"
+        },
+        "simpleIcon": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+$",
+          "description": "Simple Icons slug for the tool icon (e.g., 'terraform', 'docker')"
+        },
+        "description": {
+          "type": "string",
+          "description": "What this tool does"
+        },
+        "useWhen": {
+          "type": "string",
+          "description": "When to use this tool"
+        }
+      },
+      "additionalProperties": false
+    },
+    "skillHumanSection": {
+      "type": "object",
+      "required": ["description", "proficiencyDescriptions"],
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "Description of the skill"
+        },
+        "proficiencyDescriptions": {
+          "$ref": "#/$defs/proficiencyDescriptions",
+          "description": "Description of expectations at each level"
+        }
+      },
+      "additionalProperties": false
+    },
+    "proficiencyDescriptions": {
+      "type": "object",
+      "properties": {
+        "awareness": { "type": "string" },
+        "foundational": { "type": "string" },
+        "working": { "type": "string" },
+        "practitioner": { "type": "string" },
+        "expert": { "type": "string" }
+      },
+      "required": [
+        "awareness",
+        "foundational",
+        "working",
+        "practitioner",
+        "expert"
+      ],
+      "additionalProperties": false
+    },
+    "skillAgentSection": {
+      "type": "object",
+      "required": ["name", "description", "useWhen", "stages"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "Agent skill name (kebab-case)"
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief description of what this skill provides"
+        },
+        "useWhen": {
+          "type": "string",
+          "description": "Triggering conditions - when agents should use this skill"
+        },
+        "stages": {
+          "type": "object",
+          "description": "Stage-specific guidance for applying the skill",
+          "properties": {
+            "specify": { "$ref": "#/$defs/skillStage" },
+            "plan": { "$ref": "#/$defs/skillStage" },
+            "onboard": { "$ref": "#/$defs/skillStage" },
+            "code": { "$ref": "#/$defs/skillStage" },
+            "review": { "$ref": "#/$defs/skillStage" },
+            "deploy": { "$ref": "#/$defs/skillStage" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "skillStage": {
+      "type": "object",
+      "required": ["focus", "readChecklist", "confirmChecklist"],
+      "properties": {
+        "focus": {
+          "type": "string",
+          "description": "Primary focus for this stage"
+        },
+        "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 moving to next stage",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schema/json/defs.schema.json

@@ -0,0 +1,132 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.forwardimpact.team/schema/json/defs.schema.json",
+  "title": "Engineering Pathway Common Definitions",
+  "description": "Shared definitions for all pathway schemas",
+  "$defs": {
+    "skillProficiency": {
+      "type": "string",
+      "enum": [
+        "awareness",
+        "foundational",
+        "working",
+        "practitioner",
+        "expert"
+      ],
+      "description": "Skill proficiency level from lowest to highest"
+    },
+    "behaviourMaturity": {
+      "type": "string",
+      "enum": [
+        "emerging",
+        "developing",
+        "practicing",
+        "role_modeling",
+        "exemplifying"
+      ],
+      "description": "Behaviour maturity level from lowest to highest"
+    },
+    "stageId": {
+      "type": "string",
+      "enum": ["plan", "code", "review"],
+      "description": "Lifecycle stage identifier"
+    },
+    "proficiencyDescriptions": {
+      "type": "object",
+      "description": "Description of expectations at each skill proficiency",
+      "properties": {
+        "awareness": { "type": "string" },
+        "foundational": { "type": "string" },
+        "working": { "type": "string" },
+        "practitioner": { "type": "string" },
+        "expert": { "type": "string" }
+      },
+      "required": [
+        "awareness",
+        "foundational",
+        "working",
+        "practitioner",
+        "expert"
+      ],
+      "additionalProperties": false
+    },
+    "maturityDescriptions": {
+      "type": "object",
+      "description": "Description of expectations at each behaviour maturity level",
+      "properties": {
+        "emerging": { "type": "string" },
+        "developing": { "type": "string" },
+        "practicing": { "type": "string" },
+        "role_modeling": { "type": "string" },
+        "exemplifying": { "type": "string" }
+      },
+      "required": [
+        "emerging",
+        "developing",
+        "practicing",
+        "role_modeling",
+        "exemplifying"
+      ],
+      "additionalProperties": false
+    },
+    "responsibilitiesByLevel": {
+      "type": "object",
+      "description": "Responsibility descriptions by skill proficiency",
+      "properties": {
+        "awareness": { "type": "string" },
+        "foundational": { "type": "string" },
+        "working": { "type": "string" },
+        "practitioner": { "type": "string" },
+        "expert": { "type": "string" }
+      },
+      "required": [
+        "awareness",
+        "foundational",
+        "working",
+        "practitioner",
+        "expert"
+      ],
+      "additionalProperties": false
+    },
+    "skillId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "Skill identifier (snake_case)"
+    },
+    "behaviourId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "Behaviour identifier (snake_case)"
+    },
+    "capabilityId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "Capability identifier (snake_case)"
+    },
+    "levelId": {
+      "type": "string",
+      "pattern": "^[A-Z][A-Z0-9]*$",
+      "description": "Level identifier (uppercase)"
+    },
+    "disciplineId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "Discipline identifier (snake_case)"
+    },
+    "trackId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "Track identifier (snake_case)"
+    },
+    "modifier": {
+      "type": "integer",
+      "description": "Modifier value for adjusting levels"
+    },
+    "normalizedModifier": {
+      "type": "integer",
+      "minimum": -1,
+      "maximum": 1,
+      "description": "Modifier value restricted to -1, 0, or 1"
+    }
+  }
+}

package/schema/json/discipline.schema.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.forwardimpact.team/schema/json/discipline.schema.json",
+  "title": "Discipline",
+  "description": "Engineering specialization that defines T-shaped skill profiles",
+  "type": "object",
+  "required": ["specialization", "roleTitle", "coreSkills", "validTracks"],
+  "properties": {
+    "specialization": {
+      "type": "string",
+      "description": "Name of the specialization (e.g., Software Engineering)"
+    },
+    "roleTitle": {
+      "type": "string",
+      "description": "Base role title (e.g., Software Engineer)"
+    },
+    "isProfessional": {
+      "type": "boolean",
+      "description": "If true, this is an IC/professional discipline (default true)"
+    },
+    "isManagement": {
+      "type": "boolean",
+      "description": "If true, this is a management discipline (default false)"
+    },
+    "validTracks": {
+      "type": "array",
+      "description": "REQUIRED. Explicit list of valid tracks. Use null to allow trackless (generalist). Empty array = no valid combinations.",
+      "items": {
+        "oneOf": [
+          { "type": "null" },
+          { "type": "string", "pattern": "^[a-z][a-z0-9_]*$" }
+        ]
+      }
+    },
+    "minLevel": {
+      "type": "string",
+      "description": "Minimum level required for this discipline"
+    },
+    "description": {
+      "type": "string",
+      "description": "Description of the discipline's focus"
+    },
+    "coreSkills": {
+      "type": "array",
+      "description": "Primary skills for deep expertise (references skill IDs)",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_]*$"
+      }
+    },
+    "supportingSkills": {
+      "type": "array",
+      "description": "Secondary skills for supporting capabilities (references skill IDs)",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_]*$"
+      }
+    },
+    "broadSkills": {
+      "type": "array",
+      "description": "Skills for general awareness (references skill IDs)",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9_]*$"
+      }
+    },
+    "behaviourModifiers": {
+      "type": "object",
+      "description": "Modifiers to behaviour expectations (behaviour ID → modifier)",
+      "additionalProperties": {
+        "type": "integer",
+        "minimum": -1,
+        "maximum": 1
+      }
+    },
+    "human": {
+      "$ref": "#/$defs/disciplineHumanSection",
+      "description": "Human-specific content"
+    },
+    "agent": {
+      "$ref": "#/$defs/disciplineAgentSection",
+      "description": "Agent-specific content"
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "disciplineHumanSection": {
+      "type": "object",
+      "properties": {
+        "professionalRoleSummary": {
+          "type": "string",
+          "description": "Role summary for professional/IC track. May use {roleTitle} placeholder."
+        },
+        "managementRoleSummary": {
+          "type": "string",
+          "description": "Role summary for management track. May use {specialization} placeholder."
+        }
+      },
+      "additionalProperties": false
+    },
+    "disciplineAgentSection": {
+      "type": "object",
+      "required": ["identity"],
+      "properties": {
+        "identity": {
+          "type": "string",
+          "description": "Core identity statement for the agent. May use {roleTitle} or {roleName} placeholder."
+        },
+        "priority": {
+          "type": "string",
+          "description": "Priority guidance for the agent"
+        },
+        "constraints": {
+          "type": "array",
+          "description": "Things the agent should avoid or never do",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schema/json/drivers.schema.json

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