@forwardimpact/pathway 0.14.1 → 0.16.0

package/README.md

@@ -1,12 +1,13 @@
 # @forwardimpact/pathway
 
-Career progression web app and CLI for exploring roles and generating agents.
+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 AI agent profiles, and preparing interviews—all from a unified web
+creating agent team profiles, and preparing interviews—all from a unified web
 experience and command line.
 
 ## What It Does

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@forwardimpact/pathway",
-  "version": "0.14.1",
-  "description": "Career progression web app and CLI for exploring roles and generating agents",
+  "version": "0.16.0",
+  "description": "Career progression web app and CLI for exploring roles and generating agent teams",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -40,8 +40,8 @@
     "./commands": "./src/commands/index.js"
   },
   "dependencies": {
-    "@forwardimpact/schema": "^0.7.0",
-    "@forwardimpact/model": "^0.8.0",
+    "@forwardimpact/schema": "^0.8.0",
+    "@forwardimpact/model": "^1.0.0",
     "mustache": "^4.2.0",
     "simple-icons": "^16.7.0",
     "yaml": "^2.3.4"

package/src/commands/job.js

@@ -182,14 +182,14 @@ export async function runJobCommand({ data, args, options, dataDir }) {
       process.exit(1);
     }
 
-    const checklist = deriveChecklist({
+    const { readChecklist, confirmChecklist } = deriveChecklist({
       stageId: options.checklist,
       skillMatrix: view.skillMatrix,
       skills: data.skills,
       capabilities: data.capabilities,
     });
 
-    if (checklist.length === 0) {
+    if (readChecklist.length === 0 && confirmChecklist.length === 0) {
       console.log(`\nNo checklist items for ${options.checklist} stage\n`);
       return;
     }
@@ -197,8 +197,16 @@ export async function runJobCommand({ data, args, options, dataDir }) {
     const stageLabel =
       options.checklist.charAt(0).toUpperCase() + options.checklist.slice(1);
     console.log(`\n# ${view.title} — ${stageLabel} Stage Checklist\n`);
-    console.log(formatChecklistMarkdown(checklist));
-    console.log("");
+    if (readChecklist.length > 0) {
+      console.log("## Read-Then-Do\n");
+      console.log(formatChecklistMarkdown(readChecklist));
+      console.log("");
+    }
+    if (confirmChecklist.length > 0) {
+      console.log("## Do-Then-Confirm\n");
+      console.log(formatChecklistMarkdown(confirmChecklist));
+      console.log("");
+    }
     return;
   }
 

package/src/css/components/surfaces.css

@@ -324,4 +324,24 @@
     color: var(--color-primary);
     text-decoration: underline;
   }
+
+  .footer-quote {
+    margin: var(--space-lg) auto 0;
+    max-width: 50em;
+    font-style: italic;
+    color: var(--color-text-muted);
+    border: none;
+    padding: 0;
+  }
+
+  .footer-quote p {
+    margin: 0 0 var(--space-xs) 0;
+    font-size: var(--font-size-sm);
+    line-height: 1.5;
+  }
+
+  .footer-quote cite {
+    font-size: var(--font-size-xs);
+    font-style: normal;
+  }
 }

package/src/formatters/agent/dom.js

@@ -192,7 +192,6 @@ function createRoleAgentCard(agent) {
   );
 }
 
-
 /**
  * Download all agent files as a ZIP
  * @param {Object} profile - Agent profile

package/src/formatters/agent/profile.js

@@ -23,7 +23,7 @@ import {
  */
 
 /**
- * @typedef {Object} ConfirmChecklistEntry
+ * @typedef {Object} ChecklistEntry
  * @property {{id: string, name: string}} skill - Skill info
  * @property {{id: string, name: string, emojiIcon: string}} capability - Capability info
  * @property {string[]} items - Checklist items
@@ -49,7 +49,8 @@ import {
  * @param {Array<{name: string, dirname: string, useWhen: string}>} params.bodyData.skillIndex - Skill index entries
  * @param {string} params.bodyData.roleContext - Role context text
  * @param {WorkingStyleEntry[]} params.bodyData.workingStyles - Working style entries
- * @param {ConfirmChecklistEntry[]} [params.bodyData.confirmChecklist] - Confirm Checklist entries
+ * @param {ChecklistEntry[]} [params.bodyData.readChecklist] - Read-Then-Do Checklist entries
+ * @param {ChecklistEntry[]} [params.bodyData.confirmChecklist] - Do-Then-Confirm Checklist entries
  * @param {string[]} params.bodyData.constraints - List of constraints
  * @param {Array<{id: string, name: string, description: string}>} [params.bodyData.agentIndex] - List of all available agents
  * @param {boolean} [params.bodyData.hasAgentIndex] - Whether agent index is available
@@ -80,6 +81,13 @@ function prepareAgentProfileData({ frontmatter, bodyData }) {
     content: "required",
   });
 
+  // Process readChecklist: trim items in each entry
+  const readChecklist = (bodyData.readChecklist || []).map((entry) => ({
+    skill: entry.skill,
+    capability: entry.capability,
+    items: (entry.items || []).map((item) => trimRequired(item)),
+  }));
+
   // Process confirmChecklist: trim items in each entry
   const confirmChecklist = (bodyData.confirmChecklist || []).map((entry) => ({
     skill: entry.skill,
@@ -107,6 +115,8 @@ function prepareAgentProfileData({ frontmatter, bodyData }) {
     roleContext: trimValue(bodyData.roleContext),
     workingStyles,
     hasWorkingStyles: workingStyles.length > 0,
+    readChecklist,
+    hasReadChecklist: readChecklist.length > 0,
     confirmChecklist,
     hasConfirmChecklist: confirmChecklist.length > 0,
     constraints,
@@ -133,7 +143,8 @@ function prepareAgentProfileData({ frontmatter, bodyData }) {
  * @param {Array<{name: string, dirname: string, useWhen: string}>} profile.bodyData.skillIndex - Skill index entries
  * @param {string} profile.bodyData.roleContext - Role context text
  * @param {WorkingStyleEntry[]} profile.bodyData.workingStyles - Working style entries
- * @param {ConfirmChecklistEntry[]} [profile.bodyData.confirmChecklist] - Confirm Checklist entries (optional)
+ * @param {ChecklistEntry[]} [profile.bodyData.readChecklist] - Read-Then-Do Checklist entries (optional)
+ * @param {ChecklistEntry[]} [profile.bodyData.confirmChecklist] - Do-Then-Confirm Checklist entries (optional)
  * @param {string[]} profile.bodyData.constraints - List of constraints
  * @param {string} template - Mustache template string
  * @returns {string} Complete .agent.md file content

package/src/index.html

@@ -94,7 +94,7 @@
           <div class="drawer-section">
             <span class="drawer-section-label">Work</span>
             <a href="#/job-builder" class="drawer-cta">Build a Job</a>
-            <a href="#/agent-builder" class="drawer-cta">Build an Agent</a>
+            <a href="#/agent-builder" class="drawer-cta">Build an Agent Team</a>
             <a href="#/interview-prep" class="drawer-cta">Interview Prep</a>
             <a href="#/career-progress" class="drawer-cta">Career Progress</a>
             <a href="#/self-assessment" class="drawer-cta">Self-Assessment</a>
@@ -116,6 +116,14 @@
             <a href="slides.html">Slides</a>
             <a href="handout.html">Handouts</a>
           </nav>
+          <blockquote class="footer-quote">
+            <p>
+              “The aim of leadership should be to improve the performance of man
+              and machine, to improve quality, to increase output, and
+              simultaneously to bring pride of workmanship to people.”
+            </p>
+            <cite>— W. Edwards Deming</cite>
+          </blockquote>
         </footer>
       </div>
     </div>

package/src/pages/agent-builder.js

@@ -305,10 +305,10 @@ export async function renderAgentBuilder() {
     // Header
     div(
       { className: "page-header" },
-      h1({ className: "page-title" }, "🤖 Agent Builder"),
+      h1({ className: "page-title" }, "🤖 Agent Team Builder"),
       p(
         { className: "page-description" },
-        "Generate AI coding agents from discipline × track × stage combinations. " +
+        "Generate coding agent teams from discipline × track × stage combinations. " +
           "Export complete agent profiles and skill files for GitHub Copilot.",
       ),
     ),
@@ -930,8 +930,6 @@ async function importJSZip() {
   return module.default;
 }
 
-
-
 /**
  * Create help section explaining how agent builder works
  * @returns {HTMLElement}

package/src/pages/landing.js

@@ -79,7 +79,7 @@ export function renderLanding() {
         ),
         a(
           { href: "#/agent-builder", className: "btn btn-primary btn-lg" },
-          "Build an Agent",
+          "Build an Agent Team",
         ),
         a(
           { href: "#/interview-prep", className: "btn btn-secondary btn-lg" },
@@ -295,17 +295,17 @@ export function renderLanding() {
         // Agent builder CTA
         div(
           { className: "card", style: "text-align: center" },
-          h2({}, "🤖 Build an AI Agent"),
+          h2({}, "🤖 Build an Agent Team"),
           p(
             {},
-            "Generate AI coding agent configurations from discipline × track combinations " +
+            "Generate coding agent team configurations from discipline × track combinations " +
               "for GitHub Copilot custom agents.",
           ),
           div(
             { className: "page-actions", style: "justify-content: center" },
             a(
               { href: "#/agent-builder", className: "btn btn-primary btn-lg" },
-              "Build Agent →",
+              "Build Agent Team →",
             ),
           ),
         ),

package/templates/agent.template.md

@@ -59,8 +59,12 @@ override general knowledge.
 
 Each skill file contains XML-tagged sections for precise navigation:
 
-- **`<{{stageId}}_stage_checklist>`** — Your stage-specific checklist. Follow
-  the Read-Then-Do and Do-Then-Confirm items for the {{stageName}} stage.
+- **`<{{stageId}}_read_then_do>`** — Read-Then-Do checklist for the
+  {{stageName}} stage. Read and understand these items BEFORE starting work.
+  These are prerequisites and context you must absorb first.
+- **`<{{stageId}}_do_then_confirm>`** — Do-Then-Confirm checklist for the
+  {{stageName}} stage. Complete your work, then verify each item. These are
+  quality gates to check AFTER implementation.
 - **`<required_tools>`** — Mandatory tools for this skill. You MUST use these
   organizational standards that override general knowledge or personal
   preferences.
@@ -95,6 +99,22 @@ and (3) the compromised approach with acknowledged limitations.
 | `{{id}}` | {{{name}}} | {{{description}}} |
 {{/agentIndex}}
 {{/hasAgentIndex}}
+{{#hasReadChecklist}}
+
+## Read-Then-Do Checklist
+
+Before starting work, read and understand these items. They are prerequisites
+and context that must be absorbed before implementation begins:
+
+{{#readChecklist}}
+### {{{capability.emojiIcon}}} {{{skill.name}}}
+
+{{#items}}
+- [ ] {{{.}}}
+{{/items}}
+
+{{/readChecklist}}
+{{/hasReadChecklist}}
 {{#hasConfirmChecklist}}
 
 ## Do-Then-Confirm Checklist

package/templates/skill.template.md

@@ -13,23 +13,27 @@ description: {{{description}}}{{#hasUseWhen}} Use When: {{{useWhen}}}{{/hasUseWh
 ## Stage Guidance
 {{#stages}}
 
-<{{stageId}}_stage_checklist>
-
 ### {{stageName}} Stage
 
 **Focus:** {{{focus}}}
 
+<{{stageId}}_read_then_do>
+
 **Read-Then-Do Checklist:**
 {{#readChecklist}}
 - [ ] {{{.}}}
 {{/readChecklist}}
 
+</{{stageId}}_read_then_do>
+
+<{{stageId}}_do_then_confirm>
+
 **Do-Then-Confirm Checklist:**
 {{#confirmChecklist}}
 - [ ] {{{.}}}
 {{/confirmChecklist}}
 
-</{{stageId}}_stage_checklist>
+</{{stageId}}_do_then_confirm>
 {{/stages}}
 {{/hasStages}}
 {{#hasToolReferences}}