@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, creating agent team profiles, 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 generation — Create VS Code Custom Agent profiles (.agent.md)
• Skill generation — Generate Agent Skills files (SKILL.md)
• 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 profiles
npx fit-pathway agent software_engineering --track=platform --output=./.github/agents

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 profiles | | 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 profiles

Package Exports

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

See the documentation for usage details.