@forwardimpact/pathway

Career progression web app and CLI for exploring roles and generating agent teams.

Role in the Vision

Pathway is the primary interface for interacting with engineering competency data. It provides tools for browsing career paths, generating job descriptions, generating agent teams and skills, and preparing interviews—all from a unified web experience and command line.

What It Does

Web application — Interactive browser for jobs, skills, and career paths
CLI tools — Command-line access to all functionality
Agent teams — Generate Claude Code agent teams (.claude/agents/) and skills (.claude/skills/)
Interview prep — Build interview question sets by role
Static site — Export everything as a static site

Quick Start

# Start the web app
npx fit-pathway serve

# Browse entities
npx fit-pathway skill --list
npx fit-pathway job software_engineering senior --track=platform

# Generate agent teams and skills
npx fit-pathway agent software_engineering --track=platform --output=.

CLI Commands

Command	Description
`serve`	Start web server
`site`	Generate static site
`init`	Create data directory
`skill`	Browse skills
`behaviour`	Browse behaviours
`job`	Generate job definitions
`agent`	Generate agent teams and skills
`interview`	Generate interview questions
`progress`	Analyze career progression
`questions`	Browse interview questions

Use --help with any command for full options.

Web App Features

Job Builder — Select discipline, track, and level to explore roles
Skill Browser — View all skills with proficiency descriptions
Career Progression — Compare levels and identify growth areas
Interview Prep — Generate role-specific question sets
Agent Preview — Preview generated agent teams and skills

Package Exports

import { formatSkillForMarkdown } from "@forwardimpact/pathway/formatters";
import { runCommand } from "@forwardimpact/pathway/commands";

See the documentation for usage details.