@forwardimpact/pathway 0.16.0 → 0.17.0

package/templates/agent.template.md

@@ -25,7 +25,7 @@ handoffs:
 
 {{{stageDescription}}}
 
-## Core Identity
+## Core identity
 
 {{{identity}}}
 {{#priority}}
@@ -34,13 +34,13 @@ handoffs:
 {{/priority}}
 {{#roleContext}}
 
-## Role Context
+## Role context
 
 {{{roleContext}}}
 {{/roleContext}}
 {{#hasWorkingStyles}}
 
-## Working Style
+## Working style
 {{#workingStyles}}
 
 ### {{title}}
@@ -50,31 +50,34 @@ handoffs:
 {{/hasWorkingStyles}}
 {{#hasSkills}}
 
-## Required Skills
+## Required skills
 
 **MANDATORY:** Before starting work, you MUST read the relevant skill files for
 project-specific guidance, required tools, and technology standards. Pre-training
 knowledge alone is insufficient—skills contain organizational standards that
 override general knowledge.
 
-Each skill file contains XML-tagged sections for precise navigation:
+Each skill contains marked-up sections and references for precise navigation:
 
-- **`<{{stageId}}_read_then_do>`** — Read-Then-Do checklist for the
+- `<read_then_do_{{stageId}}>` — 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
+- `<do_then_confirm_{{stageId}}>` — 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
+- `<required_tools>` — Mandatory tools for this skill. You MUST use these
   organizational standards that override general knowledge or personal
   preferences.
 {{#isOnboard}}
-- **`<onboarding_steps>`** — Step-by-step environment setup instructions.
-  Follow these to install prerequisites and configure the development
+- `scripts/install.sh` — Self-contained install script for environment setup.
+  Run this script to install prerequisites and configure the development
   environment. Focus on setup only — do not begin feature implementation.
+- `references/REFERENCE.md` — Detailed code examples and reference material.
+  Consult this for implementation patterns, common pitfalls, and verification
+  steps.
 {{/isOnboard}}
 
-| Skill | Location | Use When |
+| Skill | Location | Use when |
 | ----- | -------- | -------- |
 {{#skillIndex}}
 | {{{name}}} | `.claude/skills/{{dirname}}/SKILL.md` | {{{useWhen}}} |
@@ -82,7 +85,7 @@ Each skill file contains XML-tagged sections for precise navigation:
 {{/hasSkills}}
 {{#hasAgentIndex}}
 
-## Required Sub-Agent Delegations
+## Required subagent delegations
 
 **MANDATORY:** You MUST delegate work outside your speciality using the
 `runSubagent` tool. Do not attempt work that another agent is better suited for.
@@ -93,52 +96,19 @@ cannot delegate due to a blocking constraint, document in your output: (1) the
 specialized work required, (2) the specific constraint preventing delegation,
 and (3) the compromised approach with acknowledged limitations.
 
-| Agent Name | Speciality | Description |
+| Agent name | Speciality | Description |
 | ---------- | ---------- | ----------- |
 {{#agentIndex}}
 | `{{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
-
-Before offering a handoff, verify and summarize completion of these items:
-
-{{#confirmChecklist}}
-### {{{capability.emojiIcon}}} {{{skill.name}}}
-
-{{#items}}
-- [ ] {{{.}}}
-{{/items}}
-
-{{/confirmChecklist}}
-When verified, summarize what was accomplished then offer the handoff. If items
-are incomplete, explain what remains.
-{{/hasConfirmChecklist}}
-
-## Return Format
+## Return format
 
 When completing work (for handoff or as a subagent), provide:
 
 1. **Work completed**: What was accomplished
-2. **Checklist status**: Items verified from Before Handoff section
+2. **Checklist status**: Items verified from skill Do-Then-Confirm checklists
 3. **Recommendation**: Ready for next stage, or needs more work
 
 {{#hasConstraints}}

package/templates/skill-install.template.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+# Install script for {{name}}
+# Generated by @forwardimpact/pathway
+{{{installScript}}}

package/templates/skill-reference.template.md

@@ -0,0 +1,3 @@
+# {{{title}}} — Reference
+
+{{{implementationReference}}}

package/templates/skill.template.md

@@ -1,6 +1,6 @@
 ---
 name: {{name}}
-description: {{{description}}}{{#hasUseWhen}} Use When: {{{useWhen}}}{{/hasUseWhen}}
+description: {{{description}}}{{#hasUseWhen}} Use when {{{useWhen}}}{{/hasUseWhen}}
 ---
 
 # {{{title}}}
@@ -8,40 +8,28 @@ description: {{{description}}}{{#hasUseWhen}} Use When: {{{useWhen}}}{{/hasUseWh
 {{#descriptionLines}}
 {{{.}}}
 {{/descriptionLines}}
-{{#hasStages}}
-
-## Stage Guidance
-{{#stages}}
-
-### {{stageName}} Stage
-
-**Focus:** {{{focus}}}
-
-<{{stageId}}_read_then_do>
 
-**Read-Then-Do Checklist:**
-{{#readChecklist}}
-- [ ] {{{.}}}
-{{/readChecklist}}
+{{#hasInstallScript}}
+Run this to install prerequisites: `scripts/install.sh`
+{{/hasInstallScript}}
+{{#hasReference}}
+See [implementation reference](references/REFERENCE.md) for code examples.
+{{/hasReference}}
+{{#hasUseWhen}}
 
-</{{stageId}}_read_then_do>
+## When to use this skill
 
-<{{stageId}}_do_then_confirm>
+Use this skill when {{{useWhen}}}
+{{/hasUseWhen}}
+{{#hasInstructions}}
 
-**Do-Then-Confirm Checklist:**
-{{#confirmChecklist}}
-- [ ] {{{.}}}
-{{/confirmChecklist}}
-
-</{{stageId}}_do_then_confirm>
-{{/stages}}
-{{/hasStages}}
+{{{instructions}}}
+{{/hasInstructions}}
 {{#hasToolReferences}}
 
-<required_tools>
-
-## Required Tools
+# Required tools
 
+<required_tools>
 **MANDATORY:** You MUST use these tools when applying this skill. These are
 organizational standards that override general knowledge or personal preferences.
 
@@ -50,17 +38,32 @@ output: (1) which tool requirement you cannot meet, (2) the specific constraint
 preventing compliance, and (3) the alternative approach with acknowledged
 trade-offs.
 
-| Tool | Use When |
+| Tool | Use when |
 | ---- | -------- |
 {{#toolReferences}}
 | {{#url}}[{{{name}}}]({{{url}}}){{/url}}{{^url}}{{{name}}}{{/url}} | {{{useWhen}}} |
 {{/toolReferences}}
-
 </required_tools>
 {{/hasToolReferences}}
-{{#hasReference}}
+{{#hasStages}}
 
-# Reference
+# Stage checklists
+{{#stages}}
 
-{{{reference}}}
-{{/hasReference}}
+## {{stageName}} stage
+
+**Focus:** {{{focus}}}
+
+<read_then_do_{{stageId}}>
+{{#readChecklist}}
+- [ ] {{{.}}}
+{{/readChecklist}}
+</read_then_do_{{stageId}}>
+
+<do_then_confirm_{{stageId}}>
+{{#confirmChecklist}}
+- [ ] {{{.}}}
+{{/confirmChecklist}}
+</do_then_confirm_{{stageId}}>
+{{/stages}}
+{{/hasStages}}

package/src/components/markdown-textarea.js

@@ -1,153 +0,0 @@
-/**
- * Code Display Component
- *
- * Reusable read-only code block with copy buttons and syntax highlighting.
- * Used for markdown content, agent profiles, skills, and code snippets.
- */
-
-/* global Prism */
-import { div, p, span, button } from "../lib/render.js";
-
-const COPY_LABEL = "📋 Copy";
-const COPY_HTML_LABEL = "Copy as HTML";
-
-/**
- * Create a copy button that copies content to clipboard
- * @param {string} content - The text content to copy
- * @returns {HTMLElement}
- */
-export function createCopyButton(content) {
-  const btn = button(
-    {
-      className: "btn btn-sm copy-btn",
-      onClick: async () => {
-        try {
-          await navigator.clipboard.writeText(content);
-          btn.textContent = "✓ Copied!";
-          btn.classList.add("copied");
-          setTimeout(() => {
-            btn.textContent = COPY_LABEL;
-            btn.classList.remove("copied");
-          }, 2000);
-        } catch (err) {
-          console.error("Failed to copy:", err);
-          btn.textContent = "Copy failed";
-          setTimeout(() => {
-            btn.textContent = COPY_LABEL;
-          }, 2000);
-        }
-      },
-    },
-    COPY_LABEL,
-  );
-  return btn;
-}
-
-/**
- * Create a copy button that copies HTML to clipboard (for rich text pasting)
- * @param {string} html - The HTML content to copy
- * @returns {HTMLElement}
- */
-function createCopyHtmlButton(html) {
-  const btn = button(
-    {
-      className: "btn btn-sm btn-secondary copy-btn",
-      onClick: async () => {
-        try {
-          const blob = new Blob([html], { type: "text/html" });
-          const clipboardItem = new ClipboardItem({ "text/html": blob });
-          await navigator.clipboard.write([clipboardItem]);
-          btn.textContent = "✓ Copied!";
-          btn.classList.add("copied");
-          setTimeout(() => {
-            btn.textContent = COPY_HTML_LABEL;
-            btn.classList.remove("copied");
-          }, 2000);
-        } catch (err) {
-          console.error("Failed to copy:", err);
-          btn.textContent = "Copy failed";
-          setTimeout(() => {
-            btn.textContent = COPY_HTML_LABEL;
-          }, 2000);
-        }
-      },
-    },
-    COPY_HTML_LABEL,
-  );
-  return btn;
-}
-
-/**
- * Create a code display component with syntax highlighting and copy button
- * @param {Object} options
- * @param {string} options.content - The code content to display
- * @param {string} [options.language="markdown"] - Language for syntax highlighting
- * @param {string} [options.filename] - Optional filename to display in header
- * @param {string} [options.description] - Optional description text
- * @param {Function} [options.toHtml] - Function to convert content to HTML (enables "Copy as HTML" button)
- * @param {number} [options.minHeight] - Optional minimum height in pixels
- * @param {number} [options.maxHeight] - Optional maximum height in pixels
- * @returns {HTMLElement}
- */
-export function createCodeDisplay({
-  content,
-  language = "markdown",
-  filename,
-  description,
-  toHtml,
-  minHeight,
-  maxHeight,
-}) {
-  // Create highlighted code block
-  const pre = document.createElement("pre");
-  pre.className = "code-display";
-  if (minHeight) pre.style.minHeight = `${minHeight}px`;
-  if (maxHeight) {
-    pre.style.maxHeight = `${maxHeight}px`;
-    pre.style.overflowY = "auto";
-  }
-
-  const code = document.createElement("code");
-  if (language) {
-    code.className = `language-${language}`;
-  }
-  code.textContent = content;
-  pre.appendChild(code);
-
-  // Apply Prism highlighting if available and language specified
-  if (language && typeof Prism !== "undefined") {
-    Prism.highlightElement(code);
-  }
-
-  // Build header content
-  const headerLeft = [];
-  if (filename) {
-    headerLeft.push(span({ className: "code-display-filename" }, filename));
-  }
-  if (description) {
-    headerLeft.push(p({ className: "text-muted" }, description));
-  }
-
-  // Build buttons
-  const buttons = [createCopyButton(content)];
-  if (toHtml) {
-    buttons.push(createCopyHtmlButton(toHtml(content)));
-  }
-
-  // Only show header if there's content for it
-  const hasHeader = headerLeft.length > 0 || buttons.length > 0;
-
-  return div(
-    { className: "code-display-container" },
-    hasHeader
-      ? div(
-          { className: "code-display-header" },
-          headerLeft.length > 0
-            ? div({ className: "code-display-info" }, ...headerLeft)
-            : null,
-          div({ className: "button-group" }, ...buttons),
-        )
-      : null,
-    pre,
-  );
-}