@forwardimpact/pathway 0.25.7 → 0.25.9

package/starter/disciplines/software_engineering.yaml

@@ -0,0 +1,46 @@
+# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/discipline.schema.json
+
+specialization: Software Engineering
+roleTitle: Software Engineer
+isProfessional: true
+
+# null = allow trackless (generalist)
+validTracks:
+  - null
+  - forward_deployed
+  - platform
+
+description:
+  Builds and maintains software systems, focusing on code quality, architecture,
+  and reliable delivery of business value.
+
+# Derivation inputs — one skill per tier
+coreSkills:
+  - task_completion
+supportingSkills:
+  - planning
+broadSkills:
+  - incident_response
+behaviourModifiers:
+  systems_thinking: 1
+
+# Human-specific content
+human:
+  professionalRoleSummary:
+    As a {roleTitle}, you build and maintain software systems that deliver
+    business value reliably.
+  managementRoleSummary:
+    As a {specialization} manager, you lead teams that build and maintain
+    software systems delivering business value.
+
+# Agent-specific content
+agent:
+  identity: |
+    You are a {roleTitle} agent focused on building reliable software.
+  priority: |
+    Write clean, tested code that meets requirements and follows established
+    patterns.
+  constraints:
+    - Follow existing code conventions
+    - Write tests for new functionality
+    - Document non-obvious decisions

package/starter/drivers.yaml

@@ -0,0 +1,10 @@
+# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/drivers.schema.json
+
+- id: quality
+  name: Quality
+  description: Deliver work that meets expectations consistently.
+  contributingSkills:
+    - task_completion
+    - planning
+  contributingBehaviours:
+    - systems_thinking

package/starter/framework.yaml

@@ -0,0 +1,49 @@
+# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/framework.schema.json
+
+title: Engineering Pathway
+emojiIcon: "\U0001F9ED"
+description: |
+  Define what good engineering looks like for your organization.
+  Edit these files to match your skills, levels, and expectations.
+
+entityDefinitions:
+  driver:
+    title: Drivers
+    emojiIcon: "\U0001F3AF"
+    description: Organizational outcomes that productive teams achieve.
+  skill:
+    title: Skills
+    emojiIcon: "\U0001F4A1"
+    description: Capabilities required to perform work effectively.
+  behaviour:
+    title: Behaviours
+    emojiIcon: "\U0001F9E0"
+    description: Mindsets and ways of working.
+  discipline:
+    title: Disciplines
+    emojiIcon: "\U0001F52C"
+    description: Engineering specializations that define skill profiles.
+  level:
+    title: Levels
+    emojiIcon: "\U0001F4CA"
+    description: Career levels that define expectations.
+  track:
+    title: Tracks
+    emojiIcon: "\U0001F6E4\uFE0F"
+    description: Work contexts that modify expectations.
+  job:
+    title: Jobs
+    emojiIcon: "\U0001F4CB"
+    description: Role specifications combining discipline, track, and level.
+  agent:
+    title: Agents
+    emojiIcon: "\U0001F916"
+    description: AI agent configurations generated from the framework.
+  stage:
+    title: Stages
+    emojiIcon: "\U0001F504"
+    description: Phases of the engineering lifecycle.
+  tool:
+    title: Tools
+    emojiIcon: "\U0001F527"
+    description: Recommended tools referenced by skills.

package/starter/levels.yaml

@@ -0,0 +1,39 @@
+# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/levels.schema.json
+
+- id: J040
+  professionalTitle: Level I
+  managementTitle: Associate
+  typicalExperienceRange: "0-2 years"
+  ordinalRank: 1
+  qualificationSummary:
+    Entry-level position suitable for recent graduates or those transitioning
+    into the field ({typicalExperienceRange}).
+  baseSkillProficiencies:
+    primary: foundational
+    secondary: awareness
+    broad: awareness
+  baseBehaviourMaturity: emerging
+  expectations:
+    impactScope: Individual tasks with guidance
+    autonomyExpectation: Work with supervision
+    influenceScope: Contribute to team discussions
+    complexityHandled: Standard tasks with established patterns
+
+- id: J060
+  professionalTitle: Level II
+  managementTitle: Senior Associate
+  typicalExperienceRange: "2-5 years"
+  ordinalRank: 2
+  qualificationSummary:
+    Mid-level position with demonstrated ability to complete tasks independently
+    ({typicalExperienceRange}).
+  baseSkillProficiencies:
+    primary: working
+    secondary: foundational
+    broad: awareness
+  baseBehaviourMaturity: developing
+  expectations:
+    impactScope: Features and small projects
+    autonomyExpectation: Work independently on familiar problems
+    influenceScope: Mentor junior team members
+    complexityHandled: Moderate complexity with some ambiguity

package/starter/stages.yaml

@@ -0,0 +1,21 @@
+# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/stages.schema.json
+
+- id: code
+  name: Code
+  emojiIcon: "\U0001F4BB"
+  summary: Build the solution
+  description:
+    Your primary task is to implement the solution according to the plan.
+  returnFormat:
+    - "Working code that meets acceptance criteria"
+  handoffs:
+    - targetStage: code
+      label: Continue Coding
+      prompt: Continue implementing the solution.
+  constraints:
+    - Follow the plan and spec requirements
+  readChecklist:
+    - Review the plan and acceptance criteria
+  confirmChecklist:
+    - Code compiles and passes tests
+    - Acceptance criteria are met

package/starter/tracks/forward_deployed.yaml

@@ -0,0 +1,33 @@
+# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/track.schema.json
+
+name: Forward Deployed
+
+description:
+  Customer-facing engineering embedded with business units. Emphasizes rapid
+  solution delivery and domain expertise. Discovers patterns in the field that
+  Platform Engineers generalize into enterprise capabilities.
+roleContext:
+  In this forward-deployed role, you are embedded directly with business units.
+  You operate like a startup CTO—bridging the gap between building products and
+  solving real business problems through rapid delivery.
+
+skillModifiers:
+  delivery: 1
+  reliability: -1
+behaviourModifiers:
+  systems_thinking: -1
+assessmentWeights:
+  skillWeight: 0.4
+  behaviourWeight: 0.6
+
+agent:
+  identity: |
+    You are a Forward Deployed {roleTitle} agent focused on rapid problem
+    discovery and solution delivery.
+  priority: |
+    Speed matters more than perfection. Deliver working solutions quickly.
+    Discover requirements through immersion, not documentation.
+  constraints:
+    - Deliver working solutions in days, not weeks
+    - Document trade-offs explicitly
+    - Identify candidates for platform generalization

package/starter/tracks/platform.yaml

@@ -0,0 +1,33 @@
+# yaml-language-server: $schema=https://www.forwardimpact.team/schema/json/track.schema.json
+
+name: Platform
+
+description:
+  Internal tooling and infrastructure focus. Builds shared capabilities that
+  enable other engineering teams. Treats the platform as a product with
+  developers as customers.
+roleContext:
+  In this platform-focused role, you build internal tooling and shared
+  infrastructure. You treat the platform as a product—building golden paths and
+  optimizing for developer experience.
+
+skillModifiers:
+  reliability: 1
+  delivery: -1
+behaviourModifiers:
+  systems_thinking: 1
+assessmentWeights:
+  skillWeight: 0.6
+  behaviourWeight: 0.4
+
+agent:
+  identity: |
+    You are a Platform {roleTitle} agent focused on building self-service
+    capabilities that enable other engineers.
+  priority: |
+    Developer experience is paramount. Design golden paths, maintain backward
+    compatibility, and document everything.
+  constraints:
+    - Maintain backward compatibility
+    - Document breaking changes with migration guides
+    - Test changes against consumer use cases

package/templates/install.template.sh

@@ -2,7 +2,7 @@
 # {{{frameworkTitle}}} — Local Install
 # Generated by @forwardimpact/pathway v{{{version}}}
 #
-# Installs fit-pathway globally via npm and downloads organization data
+# Installs fit-pathway globally via bun and downloads organization data
 # to ~/.fit/pathway/data/.
 #
 # Usage:
@@ -13,12 +13,11 @@ set -euo pipefail
 SITE_URL="{{{siteUrl}}}"
 INSTALL_DIR="${HOME}/.fit/pathway"
 
-command -v node >/dev/null 2>&1 || { echo "Error: Node.js 18+ is required. https://nodejs.org"; exit 1; }
-command -v npm  >/dev/null 2>&1 || { echo "Error: npm is required."; exit 1; }
+command -v bun >/dev/null 2>&1 || { echo "Error: Bun 1.2+ is required. https://bun.sh"; exit 1; }
 
 # Install fit-pathway globally (provides the fit-pathway binary on PATH)
 echo "Installing @forwardimpact/pathway globally..."
-npm install -g @forwardimpact/pathway@{{{version}}}
+bun install -g @forwardimpact/pathway@{{{version}}}
 
 # Download organization data to ~/.fit/pathway/data/
 echo "Downloading organization data to ${INSTALL_DIR}/data/..."