@forwardimpact/pathway 0.3.0 → 0.5.0

package/app/pages/landing.js

@@ -7,6 +7,7 @@ import { getState } from "../lib/state.js";
 import { createStatCard } from "../components/card.js";
 import { groupSkillsByCapability, getConceptEmoji } from "../model/levels.js";
 import { getStageEmoji } from "../formatters/stage/shared.js";
+import { aggregateTools } from "../formatters/tool/shared.js";
 
 /**
  * Create lifecycle flow visualization for landing page
@@ -43,6 +44,7 @@ export function renderLanding() {
   // Calculate stats using centralized capability ordering
   const skillsByCapability = groupSkillsByCapability(data.skills);
   const capabilityCount = Object.keys(skillsByCapability).length;
+  const tools = aggregateTools(data.skills);
 
   const page = div(
     { className: "landing-page" },
@@ -51,7 +53,7 @@ export function renderLanding() {
       { className: "landing-hero" },
       div(
         { className: "hero-title-wrapper" },
-        h1({}, `${framework.emoji} ${framework.title}`),
+        h1({}, `${framework.emojiIcon} ${framework.title}`),
         span({ className: "brand-tag brand-tag-hero" }, framework.tag),
       ),
       p({}, framework.description.trim()),
@@ -83,7 +85,7 @@ export function renderLanding() {
 
     // Stats grid
     div(
-      { className: "grid grid-6" },
+      { className: "grid grid-4" },
       createStatCard({
         value: data.disciplines.length,
         label: "Disciplines",
@@ -99,28 +101,41 @@ export function renderLanding() {
         label: "Tracks",
         href: "/track",
       }),
+      createStatCard({
+        value: data.behaviours.length,
+        label: "Behaviours",
+        href: "/behaviour",
+      }),
       createStatCard({
         value: data.skills.length,
         label: "Skills",
         href: "/skill",
       }),
       createStatCard({
-        value: data.behaviours.length,
-        label: "Behaviours",
-        href: "/behaviour",
+        value: data.drivers.length,
+        label: "Drivers",
+        href: "/driver",
       }),
       createStatCard({
         value: stages.length,
         label: "Stages",
         href: "/stage",
       }),
+      createStatCard({
+        value: tools.length,
+        label: "Tools",
+        href: "/tool",
+      }),
     ),
 
     // Lifecycle flow visualization
     stages.length > 0
       ? div(
           { className: "section section-detail" },
-          h2({ className: "section-title" }, "🔄 Engineering Lifecycle"),
+          h2(
+            { className: "section-title" },
+            `${getConceptEmoji(framework, "stage")} Engineering Lifecycle`,
+          ),
           p(
             { className: "text-muted", style: "margin-bottom: 1rem" },
             "The three stages of engineering work, from planning through review.",
@@ -134,7 +149,7 @@ export function renderLanding() {
       { className: "section section-detail" },
       h2({ className: "section-title" }, "Explore the Framework"),
       div(
-        { className: "grid grid-3" },
+        { className: "grid grid-4" },
         createQuickLinkCard(
           `${getConceptEmoji(framework, "discipline")} ${framework.entityDefinitions.discipline.title}`,
           `${data.disciplines.length} ${framework.entityDefinitions.discipline.title.toLowerCase()} — ${framework.entityDefinitions.discipline.description.trim().split("\n")[0]}`,
@@ -150,26 +165,31 @@ export function renderLanding() {
           `${data.tracks.length} ${framework.entityDefinitions.track.title.toLowerCase()} — ${framework.entityDefinitions.track.description.trim().split("\n")[0]}`,
           "/track",
         ),
-        createQuickLinkCard(
-          `${getConceptEmoji(framework, "skill")} ${framework.entityDefinitions.skill.title}`,
-          `${data.skills.length} ${framework.entityDefinitions.skill.title.toLowerCase()} across ${capabilityCount} capabilities — ${framework.entityDefinitions.skill.description.trim().split("\n")[0]}`,
-          "/skill",
-        ),
         createQuickLinkCard(
           `${getConceptEmoji(framework, "behaviour")} ${framework.entityDefinitions.behaviour.title}`,
           `${data.behaviours.length} ${framework.entityDefinitions.behaviour.title.toLowerCase()} — ${framework.entityDefinitions.behaviour.description.trim().split("\n")[0]}`,
           "/behaviour",
         ),
         createQuickLinkCard(
-          "🔄 Stages",
-          `${stages.length} stages — The engineering lifecycle from planning through review.`,
-          "/stage",
+          `${getConceptEmoji(framework, "skill")} ${framework.entityDefinitions.skill.title}`,
+          `${data.skills.length} ${framework.entityDefinitions.skill.title.toLowerCase()} across ${capabilityCount} capabilities — ${framework.entityDefinitions.skill.description.trim().split("\n")[0]}`,
+          "/skill",
         ),
         createQuickLinkCard(
           `${getConceptEmoji(framework, "driver")} ${framework.entityDefinitions.driver.title}`,
           `${data.drivers.length} ${framework.entityDefinitions.driver.title.toLowerCase()} — ${framework.entityDefinitions.driver.description.trim().split("\n")[0]}`,
           "/driver",
         ),
+        createQuickLinkCard(
+          `${getConceptEmoji(framework, "stage")} ${framework.entityDefinitions.stage.title}`,
+          `${stages.length} ${framework.entityDefinitions.stage.title.toLowerCase()} — ${framework.entityDefinitions.stage.description.trim().split("\n")[0]}`,
+          "/stage",
+        ),
+        createQuickLinkCard(
+          `${getConceptEmoji(framework, "tool")} ${framework.entityDefinitions.tool.title}`,
+          `${tools.length} ${framework.entityDefinitions.tool.title.toLowerCase()} — ${framework.entityDefinitions.tool.description.trim().split("\n")[0]}`,
+          "/tool",
+        ),
       ),
     ),
 

package/app/pages/self-assessment.js

@@ -82,7 +82,7 @@ function getWizardSteps(data) {
     if (skills && skills.length > 0) {
       steps.push({
         id: `skills-${capability}`,
-        name: formatCapability(capability),
+        name: formatCapability(capability, data.capabilities),
         icon: getCapabilityEmoji(data.capabilities, capability),
         type: "skills",
         capability: capability,
@@ -113,11 +113,13 @@ function getWizardSteps(data) {
 
 /**
  * Format capability name for display
- * @param {string} capability
+ * @param {string} capabilityId
+ * @param {Array} capabilities
  * @returns {string}
  */
-function formatCapability(capability) {
-  return capability.charAt(0).toUpperCase() + capability.slice(1);
+function formatCapability(capabilityId, capabilities) {
+  const capability = capabilities.find((c) => c.id === capabilityId);
+  return capability?.name || capabilityId;
 }
 
 /**
@@ -412,7 +414,7 @@ function renderSkillsStep(step, data) {
       h2(
         {},
         span({ className: "step-header-icon" }, step.icon),
-        ` ${formatCapability(capability)} Skills`,
+        ` ${formatCapability(capability, data.capabilities)} Skills`,
       ),
       span(
         { className: "step-progress" },

package/app/pages/skill.js

@@ -89,25 +89,13 @@ export function renderSkillDetail(params) {
 
 /**
  * Format capability for display
- * @param {string} capability
+ * @param {string} capabilityId
  * @param {Array} capabilities
  * @returns {string}
  */
-function formatCapability(capability, capabilities) {
-  const capabilityLabels = {
-    delivery: "Delivery",
-    scale: "Scale",
-    reliability: "Reliability",
-    data: "Data",
-    ai: "AI",
-    process: "Process",
-    business: "Business",
-    people: "People",
-    documentation: "Documentation",
-  };
-  const label =
-    capabilityLabels[capability] ||
-    capability.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
-  const emoji = getCapabilityEmoji(capabilities, capability);
+function formatCapability(capabilityId, capabilities) {
+  const capability = capabilities.find((c) => c.id === capabilityId);
+  const label = capability?.name || capabilityId;
+  const emoji = getCapabilityEmoji(capabilities, capabilityId);
   return `${emoji} ${label}`;
 }

package/app/pages/stage.js

@@ -7,15 +7,16 @@ import { getState } from "../lib/state.js";
 import { createCardList } from "../components/list.js";
 import { renderNotFound } from "../components/error-page.js";
 import { prepareStagesList, stageToDOM } from "../formatters/stage/index.js";
+import { getConceptEmoji } from "../model/levels.js";
 
 /**
  * Map stage to card configuration
- * @param {Object} stage - Prepared stage item (includes emoji)
+ * @param {Object} stage - Prepared stage item (includes emojiIcon)
  * @returns {Object} Card configuration
  */
 function stageToCardConfig(stage) {
   return {
-    title: `${stage.emoji || "🔄"} ${stage.name}`,
+    title: `${stage.emojiIcon} ${stage.name}`,
     description: stage.truncatedDescription,
     href: `/stage/${stage.id}`,
   };
@@ -23,19 +24,18 @@ function stageToCardConfig(stage) {
 
 /**
  * Create lifecycle flow visualization
- * @param {Array} stages - Array of stage items (each includes emoji)
+ * @param {Array} stages - Array of stage items (each includes emojiIcon)
  * @returns {HTMLElement}
  */
 function createLifecycleFlow(stages) {
   const flowItems = stages.map((stage, index) => {
-    const emoji = stage.emoji || "🔄";
     const isLast = index === stages.length - 1;
 
     return div(
       { className: "lifecycle-flow-item" },
       a(
         { href: `#/stage/${stage.id}`, className: "lifecycle-stage" },
-        span({ className: "lifecycle-emoji" }, emoji),
+        span({ className: "lifecycle-emoji" }, stage.emojiIcon),
         span({ className: "lifecycle-name" }, stage.name),
       ),
       !isLast ? span({ className: "lifecycle-arrow" }, "→") : null,
@@ -50,7 +50,9 @@ function createLifecycleFlow(stages) {
  */
 export function renderStagesList() {
   const { data } = getState();
+  const { framework } = data;
   const stages = data.stages || [];
+  const stageEmoji = getConceptEmoji(framework, "stage");
 
   // Transform data for list view
   const { items } = prepareStagesList(stages);
@@ -60,11 +62,13 @@ export function renderStagesList() {
     // Header
     div(
       { className: "page-header" },
-      h1({ className: "page-title" }, "🔄 Stages"),
+      h1(
+        { className: "page-title" },
+        `${stageEmoji} ${framework.entityDefinitions.stage.title}`,
+      ),
       p(
         { className: "page-description" },
-        "The engineering lifecycle stages. Each stage has specific tools, " +
-          "constraints, and handoffs to guide work from planning through review.",
+        framework.entityDefinitions.stage.description.trim().split("\n")[0],
       ),
     ),
 

package/app/pages/tool.js

@@ -0,0 +1,50 @@
+/**
+ * Tools page
+ *
+ * Displays aggregated tools from all skills with links to skill context.
+ */
+
+import { render, div, h1, p } from "../lib/render.js";
+import { getState } from "../lib/state.js";
+import { prepareToolsList } from "../formatters/tool/shared.js";
+import { createBadge } from "../components/card.js";
+import { createCardList } from "../components/list.js";
+import { toolToCardConfig } from "../lib/card-mappers.js";
+import { getConceptEmoji } from "../model/levels.js";
+
+/**
+ * Render tools list page
+ */
+export function renderToolsList() {
+  const { data } = getState();
+  const { framework } = data;
+  const toolEmoji = getConceptEmoji(framework, "tool");
+
+  const { tools, totalCount } = prepareToolsList(data.skills);
+
+  const page = div(
+    { className: "tools-page" },
+    // Header
+    div(
+      { className: "page-header" },
+      h1(
+        { className: "page-title" },
+        `${toolEmoji} ${framework.entityDefinitions.tool.title}`,
+      ),
+      p(
+        { className: "page-description" },
+        framework.entityDefinitions.tool.description.trim().split("\n")[0],
+      ),
+      createBadge(`${totalCount} tools`, "default"),
+    ),
+
+    // Tools list using standard card grid
+    createCardList(
+      tools,
+      (tool) => toolToCardConfig(tool, data.capabilities),
+      "No tools defined yet.",
+    ),
+  );
+
+  render(page);
+}

package/app/slide-main.js

@@ -346,7 +346,7 @@ function populateBrandHeader(framework) {
   header.appendChild(
     a(
       { className: "brand-title", href: "#/" },
-      `${framework.emoji} ${framework.title}`,
+      `${framework.emojiIcon} ${framework.title}`,
     ),
   );
   header.appendChild(span({ className: "brand-tag" }, framework.tag));

package/app/slides/chapter.js

@@ -20,37 +20,37 @@ export function renderChapterSlide({ render, data, params }) {
   const chapterConfig = {
     driver: {
       title: framework.entityDefinitions.driver.title,
-      emoji: framework.entityDefinitions.driver.emoji,
+      emojiIcon: framework.entityDefinitions.driver.emojiIcon,
       description: framework.entityDefinitions.driver.description,
     },
     skill: {
       title: framework.entityDefinitions.skill.title,
-      emoji: framework.entityDefinitions.skill.emoji,
+      emojiIcon: framework.entityDefinitions.skill.emojiIcon,
       description: framework.entityDefinitions.skill.description,
     },
     behaviour: {
       title: framework.entityDefinitions.behaviour.title,
-      emoji: framework.entityDefinitions.behaviour.emoji,
+      emojiIcon: framework.entityDefinitions.behaviour.emojiIcon,
       description: framework.entityDefinitions.behaviour.description,
     },
     discipline: {
       title: framework.entityDefinitions.discipline.title,
-      emoji: framework.entityDefinitions.discipline.emoji,
+      emojiIcon: framework.entityDefinitions.discipline.emojiIcon,
       description: framework.entityDefinitions.discipline.description,
     },
     grade: {
       title: framework.entityDefinitions.grade.title,
-      emoji: framework.entityDefinitions.grade.emoji,
+      emojiIcon: framework.entityDefinitions.grade.emojiIcon,
       description: framework.entityDefinitions.grade.description,
     },
     track: {
       title: framework.entityDefinitions.track.title,
-      emoji: framework.entityDefinitions.track.emoji,
+      emojiIcon: framework.entityDefinitions.track.emojiIcon,
       description: framework.entityDefinitions.track.description,
     },
     job: {
       title: framework.entityDefinitions.job.title,
-      emoji: framework.entityDefinitions.job.emoji,
+      emojiIcon: framework.entityDefinitions.job.emojiIcon,
       description: framework.entityDefinitions.job.description,
     },
   };
@@ -72,7 +72,7 @@ export function renderChapterSlide({ render, data, params }) {
     { className: "slide chapter-cover" },
     h1(
       { className: "chapter-title" },
-      config.emoji ? `${config.emoji} ` : "",
+      config.emojiIcon ? `${config.emojiIcon} ` : "",
       span({ className: "gradient-text" }, config.title),
     ),
     p({ className: "chapter-description" }, config.description.trim()),

package/app/slides/index.js

@@ -22,7 +22,7 @@ export function renderSlideIndex({ render, data }) {
       { className: "page-header" },
       heading1(
         { className: "page-title" },
-        `${framework.emoji} ${framework.title}`,
+        `${framework.emojiIcon} ${framework.title}`,
       ),
       p(
         { className: "page-description" },
@@ -55,25 +55,6 @@ export function renderSlideIndex({ render, data }) {
       ),
     ),
 
-    // Tracks
-    div(
-      { className: "slide-section" },
-      a(
-        { href: "#/overview/track" },
-        heading2(
-          { className: "slide-section-title" },
-          `${getConceptEmoji(data.framework, "track")} `,
-          span({ className: "gradient-text" }, "Tracks"),
-        ),
-      ),
-      ul(
-        { className: "related-list" },
-        ...data.tracks.map((track) =>
-          li({}, a({ href: `#/track/${track.id}` }, track.name)),
-        ),
-      ),
-    ),
-
     // Grades
     div(
       { className: "slide-section" },
@@ -99,21 +80,21 @@ export function renderSlideIndex({ render, data }) {
       ),
     ),
 
-    // Skills
+    // Tracks
     div(
       { className: "slide-section" },
       a(
-        { href: "#/overview/skill" },
+        { href: "#/overview/track" },
         heading2(
           { className: "slide-section-title" },
-          `${getConceptEmoji(data.framework, "skill")} `,
-          span({ className: "gradient-text" }, "Skills"),
+          `${getConceptEmoji(data.framework, "track")} `,
+          span({ className: "gradient-text" }, "Tracks"),
         ),
       ),
       ul(
         { className: "related-list" },
-        ...data.skills.map((skill) =>
-          li({}, a({ href: `#/skill/${skill.id}` }, skill.name)),
+        ...data.tracks.map((track) =>
+          li({}, a({ href: `#/track/${track.id}` }, track.name)),
         ),
       ),
     ),
@@ -137,6 +118,25 @@ export function renderSlideIndex({ render, data }) {
       ),
     ),
 
+    // Skills
+    div(
+      { className: "slide-section" },
+      a(
+        { href: "#/overview/skill" },
+        heading2(
+          { className: "slide-section-title" },
+          `${getConceptEmoji(data.framework, "skill")} `,
+          span({ className: "gradient-text" }, "Skills"),
+        ),
+      ),
+      ul(
+        { className: "related-list" },
+        ...data.skills.map((skill) =>
+          li({}, a({ href: `#/skill/${skill.id}` }, skill.name)),
+        ),
+      ),
+    ),
+
     // Drivers
     div(
       { className: "slide-section" },

package/app/slides/overview.js

@@ -63,14 +63,14 @@ export function renderOverviewSlide({ render, data, params }) {
   const chapterConfig = {
     driver: {
       title: framework.entityDefinitions.driver.title,
-      emoji: framework.entityDefinitions.driver.emoji,
+      emojiIcon: framework.entityDefinitions.driver.emojiIcon,
       description: framework.entityDefinitions.driver.description,
       entities: prepareDriversList(data.drivers).items,
       mapper: driverToCardConfig,
     },
     skill: {
       title: framework.entityDefinitions.skill.title,
-      emoji: framework.entityDefinitions.skill.emoji,
+      emojiIcon: framework.entityDefinitions.skill.emojiIcon,
       description: framework.entityDefinitions.skill.description,
       entities: Object.values(
         prepareSkillsList(data.skills, data.capabilities).groups,
@@ -79,14 +79,14 @@ export function renderOverviewSlide({ render, data, params }) {
     },
     behaviour: {
       title: framework.entityDefinitions.behaviour.title,
-      emoji: framework.entityDefinitions.behaviour.emoji,
+      emojiIcon: framework.entityDefinitions.behaviour.emojiIcon,
       description: framework.entityDefinitions.behaviour.description,
       entities: prepareBehavioursList(data.behaviours).items,
       mapper: behaviourToCardConfig,
     },
     discipline: {
       title: framework.entityDefinitions.discipline.title,
-      emoji: framework.entityDefinitions.discipline.emoji,
+      emojiIcon: framework.entityDefinitions.discipline.emojiIcon,
       description: framework.entityDefinitions.discipline.description,
       groups: prepareDisciplinesList(data.disciplines).groups,
       mapper: disciplineToCardConfig,
@@ -94,21 +94,21 @@ export function renderOverviewSlide({ render, data, params }) {
     },
     grade: {
       title: framework.entityDefinitions.grade.title,
-      emoji: framework.entityDefinitions.grade.emoji,
+      emojiIcon: framework.entityDefinitions.grade.emojiIcon,
       description: framework.entityDefinitions.grade.description,
       entities: prepareGradesList(data.grades).items,
       mapper: gradeToCardConfig,
     },
     track: {
       title: framework.entityDefinitions.track.title,
-      emoji: framework.entityDefinitions.track.emoji,
+      emojiIcon: framework.entityDefinitions.track.emojiIcon,
       description: framework.entityDefinitions.track.description,
       entities: prepareTracksList(data.tracks).items,
       mapper: trackToCardConfig,
     },
     job: {
       title: framework.entityDefinitions.job.title,
-      emoji: framework.entityDefinitions.job.emoji,
+      emojiIcon: framework.entityDefinitions.job.emojiIcon,
       description: framework.entityDefinitions.job.description,
       entities: generateAllJobs({
         disciplines: data.disciplines,
@@ -150,7 +150,7 @@ export function renderOverviewSlide({ render, data, params }) {
       { className: "overview-header" },
       h1(
         { className: "overview-title" },
-        config.emoji ? `${config.emoji} ` : "",
+        config.emojiIcon ? `${config.emojiIcon} ` : "",
         span({ className: "gradient-text" }, config.title),
       ),
       p({ className: "overview-description" }, config.description.trim()),

package/app/slides/skill.js

@@ -35,6 +35,7 @@ export function renderSkillSlide({ render, data, params }) {
       drivers: data.drivers,
       capabilities: data.capabilities,
       showBackLink: false,
+      showToolsAndPatterns: false,
     }),
   );
 }

package/bin/pathway.js

@@ -9,15 +9,17 @@
  *   npx pathway <command> [options]
  *
  * Commands:
- *   skill [<id>]                Show skills (summary, --list, or detail)
- *   behaviour [<id>]            Show behaviours
  *   discipline [<id>]           Show disciplines
  *   grade [<id>]                Show grades
  *   track [<id>]                Show tracks
+ *   behaviour [<id>]            Show behaviours
+ *   skill [<id>]                Show skills (summary, --list, or detail)
  *   driver [<id>]               Show drivers
- *   job [<discipline> <track> <grade>]  Generate job definition
- *   interview <discipline> <track> <grade> [--type=TYPE]  Generate interview
- *   progress <discipline> <track> <grade> [--compare=GRADE]  Career progression
+ *   stage [<id>]                Show stages
+ *   tool [<name>]               Show tools
+ *   job [<discipline> <grade>] [--track=TRACK]  Generate job definition
+ *   interview <discipline> <grade> [--track=TRACK] [--type=TYPE]  Generate interview
+ *   progress <discipline> <grade> [--track=TRACK] [--compare=GRADE]  Career progression
  *   questions [options]         Browse interview questions
  *   agent [<discipline> <track>] [--output=PATH]  Generate AI agent
  *
@@ -37,13 +39,14 @@ import { formatError } from "../app/lib/cli-output.js";
 import { runSchemaValidation } from "../app/model/schema-validation.js";
 
 // Import command handlers
-import { runSkillCommand } from "../app/commands/skill.js";
-import { runBehaviourCommand } from "../app/commands/behaviour.js";
 import { runDisciplineCommand } from "../app/commands/discipline.js";
 import { runGradeCommand } from "../app/commands/grade.js";
 import { runTrackCommand } from "../app/commands/track.js";
+import { runBehaviourCommand } from "../app/commands/behaviour.js";
+import { runSkillCommand } from "../app/commands/skill.js";
 import { runDriverCommand } from "../app/commands/driver.js";
 import { runStageCommand } from "../app/commands/stage.js";
+import { runToolCommand } from "../app/commands/tool.js";
 import { runJobCommand } from "../app/commands/job.js";
 import { runInterviewCommand } from "../app/commands/interview.js";
 import { runProgressCommand } from "../app/commands/progress.js";
@@ -58,13 +61,14 @@ const __dirname = dirname(__filename);
 const rootDir = join(__dirname, "..");
 
 const COMMANDS = {
-  skill: runSkillCommand,
-  behaviour: runBehaviourCommand,
   discipline: runDisciplineCommand,
   grade: runGradeCommand,
   track: runTrackCommand,
+  behaviour: runBehaviourCommand,
+  skill: runSkillCommand,
   driver: runDriverCommand,
   stage: runStageCommand,
+  tool: runToolCommand,
   job: runJobCommand,
   interview: runInterviewCommand,
   progress: runProgressCommand,
@@ -86,19 +90,21 @@ Getting Started:
   site [--output=PATH]                Generate static site to ./site/
 
 Entity Commands (summary by default, --list for IDs, <id> for detail):
-  skill [<id>]                        Browse skills
-  behaviour [<id>]                    Browse behaviours  
   discipline [<id>]                   Browse disciplines
   grade [<id>]                        Browse grades
   track [<id>]                        Browse tracks
+  behaviour [<id>]                    Browse behaviours  
+  skill [<id>]                        Browse skills
+    --agent                           Output as agent SKILL.md format
   driver [<id>]                       Browse drivers
   stage [<id>]                        Browse lifecycle stages
+  tool [<name>]                       Browse recommended tools
 
 Composite Commands:
-  job [<discipline> <track> <grade>]  Generate job definition
-  interview <discipline> <track> <grade> [--type=TYPE]
+  job [<discipline> <grade>] [--track=TRACK]  Generate job definition
+  interview <discipline> <grade> [--track=TRACK] [--type=TYPE]
                                       Generate interview questions
-  progress <discipline> <track> <grade> [--compare=GRADE]
+  progress <discipline> <grade> [--track=TRACK] [--compare=GRADE]
                                       Show career progression
   questions [filters]                 Browse interview questions
   agent <discipline> [--track=<track>] Generate AI coding agent
@@ -130,11 +136,17 @@ Examples:
   npx pathway skill                    # Summary of all skills
   npx pathway skill --list             # Skill IDs for piping
   npx pathway skill ai_evaluation      # Detail view
+  npx pathway skill architecture_design --agent  # Agent SKILL.md output
+
+  npx pathway tool                     # Summary of all tools
+  npx pathway tool --list              # Tool names for piping
+  npx pathway tool DuckDB              # Tool detail with skill usages
 
   npx pathway job                      # Summary of valid combinations
   npx pathway job --list               # All combinations for piping
-  npx pathway job software_engineering platform L4
-  npx pathway job se platform L3 --checklist=code_to_review
+  npx pathway job software_engineering L4
+  npx pathway job software_engineering L4 --track=platform
+  npx pathway job se L3 --track=platform --checklist=code
 
   npx pathway questions --level=practitioner
   npx pathway questions --stats
@@ -176,6 +188,7 @@ function parseArgs(args) {
     output: null,
     stage: null,
     "all-stages": false,
+    agent: false,
     // Serve command options
     port: null,
     // Init command options
@@ -227,6 +240,8 @@ function parseArgs(args) {
       result.stage = arg.slice(8);
     } else if (arg === "--all-stages") {
       result["all-stages"] = true;
+    } else if (arg === "--agent") {
+      result.agent = true;
     } else if (arg.startsWith("--checklist=")) {
       result.checklist = arg.slice(12);
     } else if (arg.startsWith("--port=")) {