From 2a25ac57c9ab7e145599263be42f6ff39c2c46f5 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 27 Aug 2026 15:17:33 +0000
Subject: [PATCH 1/6] Add wizard JSON configuration

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 src/js/main.js          |   2 +-
 src/js/wizard-config.js |  25 +++++
 src/wizard.json         | 207 ++++++++++++++++++++++++++++++++++++++++
 vite.config.js          |   6 ++
 4 files changed, 239 insertions(+), 1 deletion(-)
 create mode 100644 src/js/wizard-config.js
 create mode 100644 src/wizard.json

diff --git a/src/js/main.js b/src/js/main.js
index 82b6a22..8fe941f 100644
--- a/src/js/main.js
+++ b/src/js/main.js
@@ -2,4 +2,4 @@
 
 import { initWizard } from './ui.js';
 
-document.addEventListener('DOMContentLoaded', initWizard);
+document.addEventListener('DOMContentLoaded', () => initWizard());
diff --git a/src/js/wizard-config.js b/src/js/wizard-config.js
new file mode 100644
index 0000000..d6117ab
--- /dev/null
+++ b/src/js/wizard-config.js
@@ -0,0 +1,25 @@
+export const WIZARD_CONFIG_URL = 'wizard.json';
+
+export function loadWizardConfig(configUrl, fetchImpl) {
+  const url = configUrl || WIZARD_CONFIG_URL;
+  const request = fetchImpl || fetch;
+  return request(url).then((response) => {
+    if (!response.ok) throw new Error('Unable to load wizard configuration');
+    return response.json();
+  });
+}
+
+export function resolveWizardAssetUrl(assetUrl, configUrl) {
+  if (!assetUrl) return null;
+  const base = configUrl || WIZARD_CONFIG_URL;
+  return new URL(assetUrl, new URL(base, document.baseURI)).href;
+}
+
+export function wizardStep(config, id) {
+  return config && config.steps && config.steps[id] ? config.steps[id] : {};
+}
+
+export function wizardOptions(config, id) {
+  const step = wizardStep(config, id);
+  return Array.isArray(step.options) ? step.options : [];
+}
diff --git a/src/wizard.json b/src/wizard.json
new file mode 100644
index 0000000..54c15c2
--- /dev/null
+++ b/src/wizard.json
@@ -0,0 +1,207 @@
+{
+  "patterns_url": "patterns/manifest.json",
+  "engines_url": "https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/engines.json",
+  "archetypes": {
+    "pinned": [
+      "skill-pr-reviewer",
+      "code-improvement",
+      "daily-test-improver",
+      "documentation-updater"
+    ],
+    "aliases": {
+      "pr reviewer": "skill-pr-reviewer",
+      "daily code improver": "code-improvement",
+      "daily test generator": "daily-test-improver",
+      "documentation updater": "documentation-updater"
+    },
+    "custom": {
+      "id": "custom",
+      "label": "Custom",
+      "description": "Describe your own workflow — start from scratch",
+      "icon": "tools",
+      "full_width": true
+    }
+  },
+  "steps": {
+    "trigger": {
+      "placeholder": "choose when it runs",
+      "options": [
+        {
+          "id": "issues",
+          "label": "New issue opened",
+          "description": "Runs when an issue is created",
+          "icon": "issue-opened",
+          "summary": "a new issue is opened"
+        },
+        {
+          "id": "pull_request",
+          "label": "Pull request opened",
+          "description": "Runs when a PR is created",
+          "icon": "git-pull-request",
+          "summary": "a pull request is opened"
+        },
+        {
+          "id": "pull_request_ready_for_review",
+          "label": "PR ready for review",
+          "description": "Runs when a draft PR is marked ready for review",
+          "icon": "git-pull-request",
+          "summary": "a pull request is ready for review"
+        },
+        {
+          "id": "schedule",
+          "label": "On a schedule (daily/weekly)",
+          "description": "Runs on a cron schedule",
+          "icon": "calendar",
+          "summary": "the schedule runs"
+        },
+        {
+          "id": "slash_command",
+          "label": "Slash command (/slash-command in comments)",
+          "description": "Runs when a matching slash command is posted",
+          "icon": "terminal",
+          "summary": "a slash command is posted (not recommended)"
+        },
+        {
+          "id": "label_command",
+          "label": "Label command (/label-command)",
+          "description": "Runs when a matching label is added",
+          "icon": "tag",
+          "summary": "a matching label is added"
+        },
+        {
+          "id": "push",
+          "label": "Push to branch",
+          "description": "Runs when code is pushed",
+          "icon": "git-commit",
+          "summary": "code is pushed to main"
+        }
+      ]
+    },
+    "output": {
+      "placeholder": "choose what it can write",
+      "options": [
+        {
+          "id": "create-issue",
+          "label": "Create issue",
+          "description": "Create new issues for tracking or reporting",
+          "icon": "issue-opened",
+          "summary": "create issue"
+        },
+        {
+          "id": "add-comment",
+          "label": "Add comment",
+          "description": "Post comments with analysis, feedback, or results",
+          "icon": "comment-discussion",
+          "summary": "add comment"
+        },
+        {
+          "id": "add-labels",
+          "label": "Add label",
+          "description": "Add labels on issues",
+          "icon": "tag",
+          "summary": "add label"
+        },
+        {
+          "id": "create-pull-request",
+          "label": "Create pull request",
+          "description": "Open pull requests with code changes",
+          "icon": "git-pull-request",
+          "summary": "create pull request"
+        },
+        {
+          "id": "create-pull-request-review-comment",
+          "label": "Add review comment",
+          "description": "Leave review comments on pull request diffs",
+          "icon": "eye",
+          "summary": "add review comment"
+        }
+      ]
+    },
+    "extra": {
+      "placeholder": "choose optional capabilities",
+      "options": [
+        {
+          "id": "memory",
+          "label": "Remember across runs",
+          "description": "Track trends and context between workflow executions",
+          "icon": "cache",
+          "summary": "memory between runs"
+        },
+        {
+          "id": "charts",
+          "label": "Generate charts",
+          "description": "Upload generated charts and other visual assets",
+          "icon": "graph",
+          "summary": "chart generation"
+        },
+        {
+          "id": "browser",
+          "label": "Use browser",
+          "description": "Enable Playwright CLI for browser automation",
+          "icon": "device-desktop",
+          "summary": "browser access"
+        }
+      ]
+    },
+    "engine": {
+      "placeholder": "choose an agent",
+      "options": [
+        {
+          "id": "copilot",
+          "label": "Copilot",
+          "company": "GitHub",
+          "icon": "vendor-github"
+        },
+        {
+          "id": "claude",
+          "label": "Claude",
+          "company": "Anthropic",
+          "icon": "vendor-anthropic"
+        },
+        {
+          "id": "codex",
+          "label": "Codex",
+          "company": "OpenAI",
+          "icon": "vendor-openai"
+        },
+        {
+          "id": "gemini",
+          "label": "Gemini",
+          "company": "Google",
+          "icon": "vendor-google"
+        },
+        {
+          "id": "pi",
+          "label": "Pi",
+          "company": "Inflection",
+          "icon": "vendor-pi"
+        }
+      ]
+    },
+    "purpose": {
+      "placeholder": "choose what the agent should do"
+    }
+  },
+  "recommendations": {
+    "triggers": [
+      "issues",
+      "pull_request",
+      "schedule",
+      "slash_command",
+      "label_command",
+      "push"
+    ],
+    "safe_outputs": {
+      "add-comment": ["add-comment"],
+      "add-label": ["add-labels"],
+      "add-labels": ["add-labels"],
+      "create-issue": ["create-issue"],
+      "create-pull-request": ["create-pull-request"],
+      "create-pull-request-review-comment": ["create-pull-request-review-comment"],
+      "commit-files": ["create-pull-request"],
+      "issues": ["add-comment", "add-labels", "create-issue"],
+      "pull-requests": ["create-pull-request", "add-comment", "create-pull-request-review-comment"],
+      "contents": ["create-pull-request"]
+    }
+  }
+}
diff --git a/vite.config.js b/vite.config.js
index 7f87a9d..e8e7830 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -4,6 +4,7 @@ import { join, posix } from 'node:path';
 import { defineConfig } from 'vite';
 
 const patternsDir = fileURLToPath(new URL('./patterns', import.meta.url));
+const wizardConfig = fileURLToPath(new URL('./src/wizard.json', import.meta.url));
 
 // patterns/ lives at the repo root (it is regenerated by the deep research
 // workflow) as one manifest plus one file per archetype, so its contents are
@@ -33,6 +34,11 @@ function patternsPlugin() {
       });
     },
     generateBundle() {
+      this.emitFile({
+        type: 'asset',
+        fileName: 'wizard.json',
+        source: readFileSync(wizardConfig, 'utf8')
+      });
       listPatternsFiles().forEach((relativePath) => {
         this.emitFile({
           type: 'asset',

From f2e661e9846808629c5da08d57f6033e79927e5f Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 27 Aug 2026 15:20:57 +0000
Subject: [PATCH 2/6] Render wizard from JSON data

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 README.md                  |  32 +++++++
 src/index.html             | 148 ++----------------------------
 src/js/engines.js          |  11 ++-
 src/js/patterns.js         |  40 +++------
 src/js/summary.js          |  71 +++++----------
 src/js/ui.js               | 179 ++++++++++++++++++++++++++-----------
 src/wizard.json            |   7 ++
 test/a11y.test.js          |  76 ++++++++--------
 test/patterns.test.js      |  13 ++-
 test/summary.test.js       |  23 +++--
 test/ui.test.js            |  63 ++++++++++++-
 test/wizard-config.test.js |  46 ++++++++++
 12 files changed, 385 insertions(+), 324 deletions(-)
 create mode 100644 test/wizard-config.test.js

diff --git a/README.md b/README.md
index 6e8400f..f8db743 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,38 @@
 
 A wizard interface to create GitHub Agentic Workflows. Create ready-to-use [GitHub Agentic Workflows](https://github.github.com/gh-aw/) in minutes — just answer a few questions and get a workflow file you can drop into your repo.
 
+## Customize the wizard
+
+The dashboard is rendered at runtime from [`src/wizard.json`](src/wizard.json). The file defines the
+archetype ordering, trigger/output/extra/engine cards, summary text, recommendation mappings, and
+the URLs of the pattern library and engine catalog.
+
+To host a customized wizard in another repository:
+
+1. Run `npm run build` and publish the contents of `dist/`.
+2. Edit the published `wizard.json` without rebuilding the JavaScript bundle.
+3. Point `patterns_url` at a compatible pattern manifest. Relative URLs are resolved from the
+   location of `wizard.json`, so the configuration and its pattern library can be hosted together.
+
+The default page reads the configuration URL from:
+
+```html
+<meta name="gh-aw-wizard-config" content="wizard.json">
+```
+
+An embedding application can instead call `initWizard({ configUrl })`. Cross-origin configuration,
+pattern, and engine endpoints must allow the embedding origin with CORS headers. Option IDs should
+match definitions in the configured pattern library's `workflow-generation.json`.
+
+## Development
+
+```bash
+npm install
+npm run dev
+npm test
+npm run build
+```
+
 ## License
 
 MIT
diff --git a/src/index.html b/src/index.html
index d25da6f..aa1c9ca 100644
--- a/src/index.html
+++ b/src/index.html
@@ -3,6 +3,7 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <meta name="gh-aw-wizard-config" content="wizard.json">
   <title>GitHub Agentic Workflow Generator</title>
   <link rel="icon" type="image/svg+xml" href="./favicon.svg">
   <script>
@@ -146,57 +147,7 @@ <h2 class="visually-hidden" id="workflow-recipe-title">Agentic workflow wizard</
             <span class="recipe-value" id="summary-trigger">choose when it runs</span>
           </button>
           <section class="wizard-step" id="step-2">
-            <div class="option-group" id="trigger-options">
-              <label class="option-card">
-                <input type="checkbox" name="trigger" value="issues">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-issue-opened"></use></svg>New issue opened</div>
-                  <div class="option-desc">Runs when an issue is created</div>
-                </div>
-              </label>
-              <label class="option-card">
-                <input type="checkbox" name="trigger" value="pull_request">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-git-pull-request"></use></svg>Pull request opened</div>
-                  <div class="option-desc">Runs when a PR is created</div>
-                </div>
-              </label>
-              <label class="option-card">
-                <input type="checkbox" name="trigger" value="pull_request_ready_for_review">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-git-pull-request"></use></svg>PR ready for review</div>
-                  <div class="option-desc">Runs when a draft PR is marked ready for review</div>
-                </div>
-              </label>
-              <label class="option-card">
-                <input type="checkbox" name="trigger" value="schedule">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-calendar"></use></svg>On a schedule (daily/weekly)</div>
-                  <div class="option-desc">Runs on a cron schedule</div>
-                </div>
-              </label>
-              <label class="option-card">
-                <input type="checkbox" name="trigger" value="slash_command">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-terminal"></use></svg>Slash command (/slash-command in comments)</div>
-                  <div class="option-desc">Runs when a matching slash command is posted</div>
-                </div>
-              </label>
-              <label class="option-card">
-                <input type="checkbox" name="trigger" value="label_command">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-tag"></use></svg>Label command (/label-command)</div>
-                  <div class="option-desc">Runs when a matching label is added</div>
-                </div>
-              </label>
-              <label class="option-card">
-                <input type="checkbox" name="trigger" value="push">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-git-commit"></use></svg>Push to branch</div>
-                  <div class="option-desc">Runs when code is pushed</div>
-                </div>
-              </label>
-            </div>
+            <div class="option-group" id="trigger-options"></div>
           </section>
         </div>
 
@@ -208,43 +159,7 @@ <h2 class="visually-hidden" id="workflow-recipe-title">Agentic workflow wizard</
             <span class="recipe-value" id="summary-output">choose what it can write</span>
           </button>
           <section class="wizard-step" id="step-3">
-            <div class="option-group" id="output-options">
-              <label class="option-card">
-                <input type="checkbox" name="output" value="create-issue">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-issue-opened"></use></svg>Create issue</div>
-                  <div class="option-desc">Create new issues for tracking or reporting</div>
-                </div>
-              </label>
-              <label class="option-card">
-                <input type="checkbox" name="output" value="add-comment">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-comment-discussion"></use></svg>Add comment</div>
-                  <div class="option-desc">Post comments with analysis, feedback, or results</div>
-                </div>
-              </label>
-              <label class="option-card">
-                <input type="checkbox" name="output" value="add-labels">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-tag"></use></svg>Add label</div>
-                  <div class="option-desc">Add labels on issues</div>
-                </div>
-              </label>
-              <label class="option-card">
-                <input type="checkbox" name="output" value="create-pull-request">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-git-pull-request"></use></svg>Create pull request</div>
-                  <div class="option-desc">Open pull requests with code changes</div>
-                </div>
-              </label>
-              <label class="option-card">
-                <input type="checkbox" name="output" value="create-pull-request-review-comment">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-eye"></use></svg>Add review comment</div>
-                  <div class="option-desc">Leave review comments on pull request diffs</div>
-                </div>
-              </label>
-            </div>
+            <div class="option-group" id="output-options"></div>
           </section>
         </div>
 
@@ -256,29 +171,7 @@ <h2 class="visually-hidden" id="workflow-recipe-title">Agentic workflow wizard</
             <span class="recipe-value" id="summary-extras">choose optional capabilities</span>
           </button>
           <section class="wizard-step" id="step-4">
-            <div class="option-group" id="extras-options">
-              <label class="option-card">
-                <input type="checkbox" name="extra" value="memory">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-cache"></use></svg>Remember across runs</div>
-                  <div class="option-desc">Track trends and context between workflow executions</div>
-                </div>
-              </label>
-              <label class="option-card">
-                <input type="checkbox" name="extra" value="charts">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-graph"></use></svg>Generate charts</div>
-                  <div class="option-desc">Upload generated charts and other visual assets</div>
-                </div>
-              </label>
-              <label class="option-card">
-                <input type="checkbox" name="extra" value="browser">
-                <div class="option-info">
-                  <div class="option-label option-label-with-icon"><svg class="octicon" aria-hidden="true"><use href="#octicon-device-desktop"></use></svg>Use browser</div>
-                  <div class="option-desc">Enable Playwright CLI for browser automation</div>
-                </div>
-              </label>
-            </div>
+            <div class="option-group" id="extras-options"></div>
           </section>
         </div>
 
@@ -291,38 +184,7 @@ <h2 class="visually-hidden" id="workflow-recipe-title">Agentic workflow wizard</
           </button>
           <section class="wizard-step" id="step-5">
             <div class="engine-selector">
-              <div class="option-group" id="engine-options">
-                <label class="option-card">
-                  <input type="radio" name="engine" value="copilot">
-                  <div class="option-info">
-                    <div class="option-label option-label-with-icon option-label-with-engine-icon"><span class="engine-vendor-icon" aria-hidden="true"><svg class="vendor-icon" focusable="false"><use href="#vendor-github"></use></svg></span>Copilot (GitHub)</div>
-                  </div>
-                </label>
-                <label class="option-card">
-                  <input type="radio" name="engine" value="claude">
-                  <div class="option-info">
-                    <div class="option-label option-label-with-icon option-label-with-engine-icon"><span class="engine-vendor-icon" aria-hidden="true"><svg class="vendor-icon" focusable="false"><use href="#vendor-anthropic"></use></svg></span>Claude (Anthropic)</div>
-                  </div>
-                </label>
-                <label class="option-card">
-                  <input type="radio" name="engine" value="codex">
-                  <div class="option-info">
-                    <div class="option-label option-label-with-icon option-label-with-engine-icon"><span class="engine-vendor-icon" aria-hidden="true"><svg class="vendor-icon" focusable="false"><use href="#vendor-openai"></use></svg></span>Codex (OpenAI)</div>
-                  </div>
-                </label>
-                <label class="option-card">
-                  <input type="radio" name="engine" value="gemini">
-                  <div class="option-info">
-                    <div class="option-label option-label-with-icon option-label-with-engine-icon"><span class="engine-vendor-icon" aria-hidden="true"><svg class="vendor-icon" focusable="false"><use href="#vendor-google"></use></svg></span>Gemini (Google)</div>
-                  </div>
-                </label>
-                <label class="option-card">
-                  <input type="radio" name="engine" value="pi">
-                  <div class="option-info">
-                    <div class="option-label option-label-with-icon option-label-with-engine-icon"><span class="engine-vendor-icon" aria-hidden="true"><svg class="vendor-icon" focusable="false"><use href="#vendor-pi"></use></svg></span>Pi (Inflection)</div>
-                  </div>
-                </label>
-              </div>
+              <div class="option-group" id="engine-options"></div>
             </div>
           </section>
         </div>
diff --git a/src/js/engines.js b/src/js/engines.js
index efd6e4f..9c50eab 100644
--- a/src/js/engines.js
+++ b/src/js/engines.js
@@ -84,13 +84,20 @@ export function registerDefinitionEngines(engines) {
   });
 }
 
+export function registerBuiltInEngines(engines) {
+  builtInEngineIds.clear();
+  engines.forEach((engine) => {
+    if (engine && ENGINE_ID_PATTERN.test(engine.id)) builtInEngineIds.add(engine.id);
+  });
+}
+
 export function isKnownEngine(engine) {
   return builtInEngineIds.has(engine) || definitionEngineIds.has(engine);
 }
 
-export function loadDefinitionEngines(fetchImpl) {
+export function loadDefinitionEngines(fetchImpl, url) {
   fetchImpl = fetchImpl || fetch;
-  return fetchImpl(ENGINES_URL).then((response) => {
+  return fetchImpl(url || ENGINES_URL).then((response) => {
     if (!response.ok) throw new Error('Unable to load gh-aw engines');
     return response.json();
   }).then(parseDefinitionEngines).catch(() => {
diff --git a/src/js/patterns.js b/src/js/patterns.js
index 6e59584..1dc7aca 100644
--- a/src/js/patterns.js
+++ b/src/js/patterns.js
@@ -71,49 +71,35 @@ export function getArchetype(patterns, id) {
   return null;
 }
 
-const SAFE_OUTPUT_MAP = {
-  'add-comment': ['add-comment'],
-  'add-label': ['add-labels'],
-  'add-labels': ['add-labels'],
-  'create-issue': ['create-issue'],
-  'create-pull-request': ['create-pull-request'],
-  'create-pull-request-review-comment': ['create-pull-request-review-comment'],
-  'commit-files': ['create-pull-request'],
-  'issues': ['add-comment', 'add-labels', 'create-issue'],
-  'pull-requests': ['create-pull-request', 'add-comment', 'create-pull-request-review-comment'],
-  'contents': ['create-pull-request']
-};
-const RECOMMENDABLE_TRIGGERS = [
-  'issues',
-  'pull_request',
-  'schedule',
-  'slash_command',
-  'label_command',
-  'push'
-];
-
-function wizardOutputs(safeOutputs) {
+function wizardOutputs(safeOutputs, safeOutputMap) {
   const outputs = [];
   (safeOutputs || []).forEach((safeOutput) => {
-    (SAFE_OUTPUT_MAP[safeOutput] || []).forEach((output) => {
+    (safeOutputMap[safeOutput] || []).forEach((output) => {
       if (outputs.indexOf(output) === -1) outputs.push(output);
     });
   });
   return outputs;
 }
 
-export function getRecommendedConfiguration(patterns, id) {
+export function getRecommendedConfiguration(patterns, id, wizardConfig) {
   const archetype = getArchetype(patterns, id);
   if (!archetype) return { triggers: [], outputs: [], profile: null };
+  const recommendations = wizardConfig && wizardConfig.recommendations
+    ? wizardConfig.recommendations
+    : {};
+  const recommendableTriggers = Array.isArray(recommendations.triggers)
+    ? recommendations.triggers
+    : [];
+  const safeOutputMap = recommendations.safe_outputs || {};
 
   const profiles = (patterns.configuration_profiles || [])
     .filter((profile) => {
       return profile.archetype === id &&
         Array.isArray(profile.triggers) &&
-        profile.triggers.every((trigger) => { return RECOMMENDABLE_TRIGGERS.indexOf(trigger) !== -1; }) &&
+        profile.triggers.every((trigger) => { return recommendableTriggers.indexOf(trigger) !== -1; }) &&
         Array.isArray(profile.safe_outputs) &&
         profile.safe_outputs.length > 0 &&
-        profile.safe_outputs.every((safeOutput) => { return SAFE_OUTPUT_MAP[safeOutput]; });
+        profile.safe_outputs.every((safeOutput) => { return safeOutputMap[safeOutput]; });
     })
     .slice()
     .sort((a, b) => {
@@ -136,7 +122,7 @@ export function getRecommendedConfiguration(patterns, id) {
 
   return {
     triggers,
-    outputs: wizardOutputs(safeOutputs),
+    outputs: wizardOutputs(safeOutputs, safeOutputMap),
     profile
   };
 }
diff --git a/src/js/summary.js b/src/js/summary.js
index 2074018..0f44963 100644
--- a/src/js/summary.js
+++ b/src/js/summary.js
@@ -2,43 +2,7 @@
 
 import { getArchetype } from './patterns.js';
 import { formatEngineLabel } from './engines.js';
-
-const triggerLabels = {
-  issues: 'a new issue is opened',
-  pull_request: 'a pull request is opened',
-  pull_request_ready_for_review: 'a pull request is ready for review',
-  schedule: 'the schedule runs',
-  slash_command: 'a slash command is posted (not recommended)',
-  label_command: 'a matching label is added',
-  push: 'code is pushed to main'
-};
-
-const outputLabels = {
-  'add-comment': 'add comment',
-  'add-labels': 'add label',
-  'create-issue': 'create issue',
-  'create-pull-request': 'create pull request',
-  'create-pull-request-review-comment': 'add review comment',
-  comments: 'add comment',
-  labels: 'add label',
-  'new-issues': 'create issue',
-  'pull-requests': 'create pull request',
-  commits: 'commit changes'
-};
-
-const engineLabels = {
-  copilot: 'Copilot',
-  claude: 'Claude',
-  codex: 'Codex',
-  gemini: 'Gemini',
-  pi: 'Pi'
-};
-
-const extraLabels = {
-  memory: 'memory between runs',
-  charts: 'chart generation',
-  browser: 'browser access'
-};
+import { wizardOptions, wizardStep } from './wizard-config.js';
 
 function readableList(values, conjunction) {
   conjunction = conjunction || 'and';
@@ -51,8 +15,22 @@ function mapLabels(values, labels) {
   return readableList(values.map((value) => { return labels[value] || value; }));
 }
 
-export function buildWorkflowSummary(answers, patterns) {
+function optionLabels(config, stepId) {
+  return Object.fromEntries(wizardOptions(config, stepId).map((option) => {
+    return [option.id, option.summary || option.label || option.id];
+  }));
+}
+
+export function buildWorkflowSummary(answers, patterns, wizardConfig) {
   const archetype = getArchetype(patterns, answers.archetype);
+  const triggerLabels = optionLabels(wizardConfig, 'trigger');
+  const outputLabels = optionLabels(wizardConfig, 'output');
+  const engineLabels = optionLabels(wizardConfig, 'engine');
+  const extraLabels = optionLabels(wizardConfig, 'extra');
+  const summaryOverrides = wizardConfig && wizardConfig.summary_overrides &&
+    wizardConfig.summary_overrides[answers.archetype]
+    ? wizardConfig.summary_overrides[answers.archetype]
+    : {};
   const purpose = answers.archetype === 'custom'
     ? answers.customDescription
     : archetype && archetype.description;
@@ -63,30 +41,29 @@ export function buildWorkflowSummary(answers, patterns) {
     trigger: {
       value: answers.triggers.length
         ? readableList(answers.triggers.map((trigger) => {
-          if (trigger === 'pull_request' && answers.archetype === 'pr-review') {
-            return 'a pull request is ready for review';
-          }
-          return triggerLabels[trigger] || trigger;
+          return (summaryOverrides.trigger || {})[trigger] || triggerLabels[trigger] || trigger;
         }), 'or')
-        : 'choose when it runs',
+        : wizardStep(wizardConfig, 'trigger').placeholder || '',
       complete: answers.triggers.length > 0
     },
     purpose: {
-      value: purpose || 'choose what the agent should do',
+      value: purpose || wizardStep(wizardConfig, 'purpose').placeholder || '',
       complete: Boolean(purpose)
     },
     output: {
       value: answers.outputs.length
         ? mapLabels(answers.outputs, outputLabels)
-        : 'choose what it can write',
+        : wizardStep(wizardConfig, 'output').placeholder || '',
       complete: answers.outputs.length > 0
     },
     extras: {
-      value: capabilities.length ? readableList(capabilities) : 'choose optional capabilities',
+      value: capabilities.length
+        ? readableList(capabilities)
+        : wizardStep(wizardConfig, 'extra').placeholder || '',
       complete: capabilities.length > 0
     },
     engine: {
-      value: engine || 'choose an agent',
+      value: engine || wizardStep(wizardConfig, 'engine').placeholder || '',
       complete: Boolean(engine)
     }
   };
diff --git a/src/js/ui.js b/src/js/ui.js
index f3ce437..4a788e8 100644
--- a/src/js/ui.js
+++ b/src/js/ui.js
@@ -13,9 +13,22 @@ import { highlightMarkdown } from './highlight.js';
 import { initTheme } from './theme.js';
 import { initLanding } from './landing.js';
 import { buildWorkflowSummary } from './summary.js';
-import { engineIconMarkup, formatEngineOptionLabel, loadDefinitionEngines, registerDefinitionEngines } from './engines.js';
+import {
+  engineIconMarkup,
+  formatEngineOptionLabel,
+  loadDefinitionEngines,
+  registerBuiltInEngines,
+  registerDefinitionEngines
+} from './engines.js';
+import {
+  WIZARD_CONFIG_URL,
+  loadWizardConfig,
+  resolveWizardAssetUrl,
+  wizardOptions
+} from './wizard-config.js';
 
 let patterns = null;
+let wizardConfig = null;
 let currentStep = 1;
 let generatedPrompt = '';
 let copyFeedbackTimer = null;
@@ -23,25 +36,37 @@ const TOTAL_STEPS = 6;
 const ACCORDION_OPEN_ANIMATION = 'accordionOpen 0.3s ease';
 const ACCORDION_OPEN_REVERSE_ANIMATION = 'accordionOpenReverse 0.3s ease';
 
-export function initWizard() {
+function configuredUrl() {
+  const element = document.querySelector('meta[name="gh-aw-wizard-config"]');
+  return element && element.content ? element.content : WIZARD_CONFIG_URL;
+}
+
+export function initWizard(options) {
+  options = options || {};
   initTheme();
-  loadPatterns().then((data) => {
+  const configUrl = options.configUrl || configuredUrl();
+  const ready = loadWizardConfig(configUrl).then((config) => {
+    wizardConfig = config;
+    const patternsUrl = resolveWizardAssetUrl(config.patterns_url, configUrl);
+    const enginesUrl = resolveWizardAssetUrl(config.engines_url, configUrl);
+    return Promise.all([
+      loadPatterns(patternsUrl),
+      loadDefinitionEngines(options.fetch, enginesUrl)
+    ]);
+  }).then(([data, engines]) => {
     patterns = data;
-    renderArchetypeOptions(data);
-  }).catch(() => {
-    patterns = null;
-    renderArchetypeOptions(null);
-  }).finally(() => {
+    renderArchetypeOptions(data, wizardConfig);
+    renderConfiguredOptions(wizardConfig);
+    registerBuiltInEngines(wizardOptions(wizardConfig, 'engine'));
+    registerDefinitionEngines(engines);
+    addDefinitionEngineOptions(engines);
     bindFormEvents();
     renderWorkflowSummary();
   });
   bindNavigation();
-  loadDefinitionEngines().then((engines) => {
-    registerDefinitionEngines(engines);
-    addDefinitionEngineOptions(engines);
-  });
   initNavigationHistory();
   initLanding(revealWhatPane);
+  return ready;
 }
 
 function archetypeIconId(archetypeId, data) {
@@ -49,40 +74,25 @@ function archetypeIconId(archetypeId, data) {
   return definition && definition.icon ? definition.icon : 'tools';
 }
 
-const PINNED_ARCHETYPE_ORDER = [
-  'skill-pr-reviewer',
-  'code-improvement',
-  'daily-test-improver',
-  'documentation-updater'
-];
-
-const PINNED_ARCHETYPE_INDEX = new Map(
-  PINNED_ARCHETYPE_ORDER.map((id, index) => [id, index])
-);
-
-const PINNED_ARCHETYPE_ALIASES = new Map([
-  ['pr reviewer', 'skill-pr-reviewer'],
-  ['daily code improver', 'code-improvement'],
-  ['daily test generator', 'daily-test-improver'],
-  ['documentation updater', 'documentation-updater']
-]);
-
-function pinnedArchetypeOrder(archetype) {
+function pinnedArchetypeOrder(archetype, config) {
+  const archetypeConfig = config && config.archetypes ? config.archetypes : {};
+  const pinned = Array.isArray(archetypeConfig.pinned) ? archetypeConfig.pinned : [];
   const id = archetype && typeof archetype.id === 'string' ? archetype.id : '';
-  if (PINNED_ARCHETYPE_INDEX.has(id)) return PINNED_ARCHETYPE_INDEX.get(id);
+  const directIndex = pinned.indexOf(id);
+  if (directIndex !== -1) return directIndex;
   const label = archetype && typeof archetype.label === 'string'
     ? archetype.label.trim().toLowerCase()
     : '';
-  const canonicalId = PINNED_ARCHETYPE_ALIASES.get(label);
+  const canonicalId = (archetypeConfig.aliases || {})[label];
   if (!canonicalId) return -1;
-  return PINNED_ARCHETYPE_INDEX.get(canonicalId) ?? -1;
+  return pinned.indexOf(canonicalId);
 }
 
-function archetypeSort(a, b) {
+function archetypeSort(a, b, config) {
   if (a.id === 'custom' && b.id !== 'custom') return 1;
   if (b.id === 'custom' && a.id !== 'custom') return -1;
-  const aPinnedOrder = pinnedArchetypeOrder(a);
-  const bPinnedOrder = pinnedArchetypeOrder(b);
+  const aPinnedOrder = pinnedArchetypeOrder(a, config);
+  const bPinnedOrder = pinnedArchetypeOrder(b, config);
   const aPinned = aPinnedOrder !== -1;
   const bPinned = bPinnedOrder !== -1;
   if (aPinned && bPinned) return aPinnedOrder - bPinnedOrder;
@@ -91,31 +101,26 @@ function archetypeSort(a, b) {
   return 0;
 }
 
-export function renderArchetypeOptions(data) {
+export function renderArchetypeOptions(data, config) {
   const container = document.getElementById('archetype-options');
   if (!container) return;
 
   const source = data && Array.isArray(data.archetypes) ? data.archetypes : [];
+  const custom = config && config.archetypes ? config.archetypes.custom : null;
   const withCustom = source.some((archetype) => archetype.id === 'custom')
     ? source
-    : source.concat({
-      id: 'custom',
-      label: 'Custom',
-      description: 'Describe your own workflow — start from scratch'
-    });
-  const archetypes = (withCustom.length ? withCustom : [{
-    id: 'custom',
-    label: 'Custom',
-    description: 'Describe your own workflow — start from scratch'
-  }]).slice().sort(archetypeSort);
+    : source.concat(custom || []);
+  const archetypes = (withCustom.length ? withCustom : (custom ? [custom] : []))
+    .slice()
+    .sort((a, b) => archetypeSort(a, b, config));
   container.innerHTML = '';
 
   archetypes.forEach((archetype) => {
     const card = document.createElement('label');
     card.className = 'option-card';
     card.dataset.value = archetype.id;
-    if (pinnedArchetypeOrder(archetype) !== -1) card.classList.add('priority-archetype');
-    if (archetype.id === 'custom') card.style.gridColumn = '1 / -1';
+    if (pinnedArchetypeOrder(archetype, config) !== -1) card.classList.add('priority-archetype');
+    if (archetype.full_width || archetype.id === 'custom') card.style.gridColumn = '1 / -1';
 
     const input = document.createElement('input');
     input.type = 'radio';
@@ -149,6 +154,76 @@ export function renderArchetypeOptions(data) {
   });
 }
 
+function iconElement(iconId) {
+  const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+  svg.setAttribute('class', 'octicon');
+  svg.setAttribute('aria-hidden', 'true');
+  const use = document.createElementNS('http://www.w3.org/2000/svg', 'use');
+  use.setAttribute('href', `#octicon-${iconId}`);
+  svg.appendChild(use);
+  return svg;
+}
+
+function engineIconElement(iconId) {
+  const wrapper = document.createElement('span');
+  wrapper.className = 'engine-vendor-icon';
+  wrapper.setAttribute('aria-hidden', 'true');
+  const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+  svg.setAttribute('class', 'vendor-icon');
+  svg.setAttribute('focusable', 'false');
+  const use = document.createElementNS('http://www.w3.org/2000/svg', 'use');
+  use.setAttribute('href', `#${iconId}`);
+  svg.appendChild(use);
+  wrapper.appendChild(svg);
+  return wrapper;
+}
+
+export function renderChoiceOptions(config, stepId) {
+  const containerId = stepId === 'extra' ? 'extras-options' : `${stepId}-options`;
+  const container = document.getElementById(containerId);
+  if (!container) return;
+  container.innerHTML = '';
+
+  wizardOptions(config, stepId).forEach((option) => {
+    const card = document.createElement('label');
+    card.className = 'option-card';
+    const input = document.createElement('input');
+    input.type = stepId === 'engine' ? 'radio' : 'checkbox';
+    input.name = stepId;
+    input.value = option.id;
+    const info = document.createElement('div');
+    info.className = 'option-info';
+    const label = document.createElement('div');
+    label.className = 'option-label option-label-with-icon';
+
+    if (stepId === 'engine') {
+      label.classList.add('option-label-with-engine-icon');
+      if (option.icon) label.appendChild(engineIconElement(option.icon));
+      label.appendChild(document.createTextNode(
+        option.label + (option.company ? ` (${option.company})` : '')
+      ));
+    } else {
+      if (option.icon) label.appendChild(iconElement(option.icon));
+      label.appendChild(document.createTextNode(option.label || option.id));
+    }
+    info.appendChild(label);
+    if (option.description) {
+      const description = document.createElement('div');
+      description.className = 'option-desc';
+      description.textContent = option.description;
+      info.appendChild(description);
+    }
+    card.append(input, info);
+    container.appendChild(card);
+  });
+}
+
+function renderConfiguredOptions(config) {
+  ['trigger', 'output', 'extra', 'engine'].forEach((stepId) => {
+    renderChoiceOptions(config, stepId);
+  });
+}
+
 function revealWhatPane() {
   resetNavigationPane();
   focusFirstArchetype();
@@ -590,7 +665,7 @@ function hasChecked(name) {
 }
 
 function prefillFromArchetype(id) {
-  const recommendation = getRecommendedConfiguration(patterns, id);
+  const recommendation = getRecommendedConfiguration(patterns, id, wizardConfig);
   if (!recommendation.triggers.length && !recommendation.outputs.length) return;
 
   // Pre-check recommended triggers
@@ -637,7 +712,7 @@ function gatherAnswers() {
 }
 
 function renderWorkflowSummary() {
-  const summary = buildWorkflowSummary(gatherAnswers(), patterns);
+  const summary = buildWorkflowSummary(gatherAnswers(), patterns, wizardConfig);
   updateSummaryClause('summary-purpose', summary.purpose);
   updateSummaryClause('summary-trigger', summary.trigger);
   updateSummaryClause('summary-output', summary.output);
diff --git a/src/wizard.json b/src/wizard.json
index 54c15c2..14b7fe3 100644
--- a/src/wizard.json
+++ b/src/wizard.json
@@ -203,5 +203,12 @@
       "pull-requests": ["create-pull-request", "add-comment", "create-pull-request-review-comment"],
       "contents": ["create-pull-request"]
     }
+  },
+  "summary_overrides": {
+    "pr-review": {
+      "trigger": {
+        "pull_request": "a pull request is ready for review"
+      }
+    }
   }
 }
diff --git a/test/a11y.test.js b/test/a11y.test.js
index 3f189cd..1367589 100644
--- a/test/a11y.test.js
+++ b/test/a11y.test.js
@@ -6,6 +6,9 @@ import { describe, expect, it } from 'vitest';
 const css = readFileSync(fileURLToPath(new URL('../src/styles/style.css', import.meta.url)), 'utf8');
 const html = readFileSync(fileURLToPath(new URL('../src/index.html', import.meta.url)), 'utf8');
 const ui = readFileSync(fileURLToPath(new URL('../src/js/ui.js', import.meta.url)), 'utf8');
+const wizard = JSON.parse(
+  readFileSync(fileURLToPath(new URL('../src/wizard.json', import.meta.url)), 'utf8')
+);
 
 function ruleBody(selector) {
   const start = css.indexOf(`${selector  } {`);
@@ -144,7 +147,7 @@ describe('Archetype radiogroup arrow-key focus', () => {
 describe('Primer iconography', () => {
   it('uses hidden Octicons instead of emoji for decorative interface icons', () => {
     expect(html).toContain('id="octicon-eye"');
-    expect(html).toContain('<use href="#octicon-eye"></use>');
+    expect(wizard.steps.output.options.some((option) => option.icon === 'eye')).toBe(true);
     expect(html).not.toMatch(/\p{Extended_Pictographic}/u);
   });
 
@@ -157,41 +160,40 @@ describe('Primer iconography', () => {
     expect(reducedMotionRules).toMatch(/\.octicon:hover\s*\{\s*transform:\s*none;/);
   });
 
-  it('adds decorative Octicons to every output option', () => {
-    const outputOptions = html.slice(html.indexOf('id="output-options"'), html.indexOf('</section>', html.indexOf('id="output-options"')));
-    expect(outputOptions.match(/<svg class="octicon" aria-hidden="true">/g)).toHaveLength(5);
-    expect(outputOptions).toContain('<use href="#octicon-comment-discussion"></use>');
-    expect(outputOptions).toContain('<use href="#octicon-tag"></use>');
-    expect(outputOptions).toContain('<use href="#octicon-issue-opened"></use>');
-    expect(outputOptions).toContain('<use href="#octicon-git-pull-request"></use>');
-    expect(outputOptions).toContain('<use href="#octicon-eye"></use>');
-  });
-
-  it('uses Octicons for every extras option', () => {
-    const extrasOptions = html.slice(html.indexOf('id="extras-options"'), html.indexOf('</section>', html.indexOf('id="extras-options"')));
-    expect(extrasOptions.match(/<svg class="octicon" aria-hidden="true">/g)).toHaveLength(3);
-    expect(extrasOptions).toContain('<use href="#octicon-cache"></use>');
-    expect(extrasOptions).toContain('<use href="#octicon-graph"></use>');
-    expect(extrasOptions).toContain('<use href="#octicon-device-desktop"></use>');
-  });
-
-  it('adds decorative Octicons to every trigger option', () => {
-    const triggerOptions = html.slice(html.indexOf('id="trigger-options"'), html.indexOf('</section>', html.indexOf('id="trigger-options"')));
-    expect(triggerOptions.match(/<svg class="octicon" aria-hidden="true">/g)).toHaveLength(7);
-    expect(triggerOptions).toContain('<use href="#octicon-issue-opened"></use>');
-    expect(triggerOptions).toContain('<use href="#octicon-git-pull-request"></use>');
-    expect(triggerOptions).toContain('name="trigger" value="pull_request_ready_for_review"');
-    expect(triggerOptions).toContain('PR ready for review');
-    expect(triggerOptions).toContain('<use href="#octicon-calendar"></use>');
-    expect(triggerOptions).toContain('<use href="#octicon-terminal"></use>');
-    expect(triggerOptions).toContain('<use href="#octicon-tag"></use>');
-    expect(triggerOptions).toContain('<use href="#octicon-git-commit"></use>');
-  });
-
-  it('keeps engine options to engine and company only', () => {
-    const engineOptions = html.slice(html.indexOf('id="engine-options"'), html.indexOf('</section>', html.indexOf('id="engine-options"')));
-    expect(engineOptions).toContain('Copilot (GitHub)');
-    expect(engineOptions).not.toContain('option-desc');
-    expect(engineOptions).not.toContain('default)');
+  it('configures decorative Octicons for every output option', () => {
+    expect(wizard.steps.output.options.map((option) => option.icon)).toEqual([
+      'issue-opened',
+      'comment-discussion',
+      'tag',
+      'git-pull-request',
+      'eye'
+    ]);
+  });
+
+  it('configures Octicons for every extras option', () => {
+    expect(wizard.steps.extra.options.map((option) => option.icon)).toEqual([
+      'cache',
+      'graph',
+      'device-desktop'
+    ]);
+  });
+
+  it('configures decorative Octicons for every trigger option', () => {
+    expect(wizard.steps.trigger.options).toHaveLength(7);
+    expect(wizard.steps.trigger.options).toContainEqual(expect.objectContaining({
+      id: 'pull_request_ready_for_review',
+      label: 'PR ready for review',
+      icon: 'git-pull-request'
+    }));
+  });
+
+  it('keeps configured engine options to engine and company only', () => {
+    expect(wizard.steps.engine.options[0]).toEqual({
+      id: 'copilot',
+      label: 'Copilot',
+      company: 'GitHub',
+      icon: 'vendor-github'
+    });
+    expect(wizard.steps.engine.options.every((option) => !option.description)).toBe(true);
   });
 });
diff --git a/test/patterns.test.js b/test/patterns.test.js
index 1252221..ab90858 100644
--- a/test/patterns.test.js
+++ b/test/patterns.test.js
@@ -12,6 +12,11 @@ import { loadPatternsFromDir } from '../src/js/patterns-node.js';
 import { nextStepsHtml } from '../src/js/next-steps.js';
 
 const generatedPatterns = await loadPatternsFromDir(fileURLToPath(new URL('../patterns', import.meta.url)));
+const wizardConfig = JSON.parse(
+  await import('node:fs/promises').then(({ readFile }) => {
+    return readFile(fileURLToPath(new URL('../src/wizard.json', import.meta.url)), 'utf8');
+  })
+);
 
 describe('getArchetype', () => {
   const patterns = { archetypes: [{ id: 'pr-review', label: 'PR Review' }] };
@@ -150,7 +155,7 @@ describe('getRecommendedConfiguration', () => {
       ]
     };
 
-    expect(getRecommendedConfiguration(patterns, 'status-report')).toEqual({
+    expect(getRecommendedConfiguration(patterns, 'status-report', wizardConfig)).toEqual({
       triggers: ['schedule'],
       outputs: ['create-issue', 'add-comment'],
       profile: patterns.configuration_profiles[3]
@@ -169,7 +174,7 @@ describe('getRecommendedConfiguration', () => {
       }]
     };
 
-    expect(getRecommendedConfiguration(patterns, 'issue-triage')).toEqual({
+    expect(getRecommendedConfiguration(patterns, 'issue-triage', wizardConfig)).toEqual({
       triggers: ['slash_command'],
       outputs: ['add-comment'],
       profile: patterns.configuration_profiles[0]
@@ -185,7 +190,7 @@ describe('getRecommendedConfiguration', () => {
       }]
     };
 
-    expect(getRecommendedConfiguration(patterns, 'issue-triage')).toEqual({
+    expect(getRecommendedConfiguration(patterns, 'issue-triage', wizardConfig)).toEqual({
       triggers: ['issues'],
       outputs: ['add-labels', 'add-comment'],
       profile: null
@@ -193,7 +198,7 @@ describe('getRecommendedConfiguration', () => {
   });
 
   it('returns an empty recommendation for an unknown archetype', () => {
-    expect(getRecommendedConfiguration({ archetypes: [] }, 'unknown')).toEqual({
+    expect(getRecommendedConfiguration({ archetypes: [] }, 'unknown', wizardConfig)).toEqual({
       triggers: [],
       outputs: [],
       profile: null
diff --git a/test/summary.test.js b/test/summary.test.js
index b4802c3..2c274b3 100644
--- a/test/summary.test.js
+++ b/test/summary.test.js
@@ -1,4 +1,6 @@
 import { describe, expect, it } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
 
 import { buildWorkflowSummary } from '../src/js/summary.js';
 
@@ -10,6 +12,9 @@ const patterns = {
     }
   ]
 };
+const wizardConfig = JSON.parse(
+  readFileSync(fileURLToPath(new URL('../src/wizard.json', import.meta.url)), 'utf8')
+);
 
 function answers(overrides = {}) {
   return {
@@ -26,7 +31,7 @@ function answers(overrides = {}) {
 
 describe('buildWorkflowSummary', () => {
   it('starts with prompts for choices that have not been made', () => {
-    const summary = buildWorkflowSummary(answers(), patterns);
+    const summary = buildWorkflowSummary(answers(), patterns, wizardConfig);
 
     expect(summary.trigger).toEqual({ value: 'choose when it runs', complete: false });
     expect(summary.purpose).toEqual({ value: 'choose what the agent should do', complete: false });
@@ -40,7 +45,7 @@ describe('buildWorkflowSummary', () => {
       triggers: ['issues', 'schedule'],
       outputs: ['add-labels', 'add-comment'],
       engine: 'claude'
-    }), patterns);
+    }), patterns, wizardConfig);
 
     expect(summary.trigger.value).toBe('a new issue is opened or the schedule runs');
     expect(summary.purpose).toEqual({ value: 'Classify and label new issues', complete: true });
@@ -52,7 +57,7 @@ describe('buildWorkflowSummary', () => {
     const summary = buildWorkflowSummary(answers({
       engine: 'copilot',
       extras: ['memory', 'charts', 'browser']
-    }), patterns);
+    }), patterns, wizardConfig);
 
     expect(summary.extras.value).toBe('memory between runs, chart generation, and browser access');
     expect(summary.extras.complete).toBe(true);
@@ -60,7 +65,7 @@ describe('buildWorkflowSummary', () => {
   });
 
   it('shows a placeholder for extras when none are selected', () => {
-    const summary = buildWorkflowSummary(answers({ engine: 'copilot', extras: [] }), patterns);
+    const summary = buildWorkflowSummary(answers({ engine: 'copilot', extras: [] }), patterns, wizardConfig);
 
     expect(summary.extras).toEqual({ value: 'choose optional capabilities', complete: false });
   });
@@ -69,7 +74,7 @@ describe('buildWorkflowSummary', () => {
     const summary = buildWorkflowSummary(answers({
       archetype: 'pr-review',
       triggers: ['pull_request']
-    }), patterns);
+    }), patterns, wizardConfig);
 
     expect(summary.trigger.value).toBe('a pull request is ready for review');
   });
@@ -77,7 +82,7 @@ describe('buildWorkflowSummary', () => {
   it('describes the explicit ready-for-review trigger accurately', () => {
     const summary = buildWorkflowSummary(answers({
       triggers: ['pull_request_ready_for_review']
-    }), patterns);
+    }), patterns, wizardConfig);
 
     expect(summary.trigger.value).toBe('a pull request is ready for review');
   });
@@ -85,7 +90,7 @@ describe('buildWorkflowSummary', () => {
   it('joins three trigger conditions with OR', () => {
     const summary = buildWorkflowSummary(answers({
       triggers: ['issues', 'schedule', 'push']
-    }), patterns);
+    }), patterns, wizardConfig);
 
     expect(summary.trigger.value).toBe(
       'a new issue is opened, the schedule runs, or code is pushed to main'
@@ -95,7 +100,7 @@ describe('buildWorkflowSummary', () => {
   it('uses custom descriptions as they are entered', () => {
     const summary = buildWorkflowSummary(answers({
       customDescription: 'Check release notes for breaking changes'
-    }), patterns);
+    }), patterns, wizardConfig);
 
     expect(summary.purpose).toEqual({
       value: 'Check release notes for breaking changes',
@@ -112,7 +117,7 @@ describe('buildWorkflowSummary', () => {
         'create-pull-request',
         'create-pull-request-review-comment'
       ]
-    }), patterns);
+    }), patterns, wizardConfig);
 
     expect(summary.output.value).toBe(
       'create issue, add comment, add label, create pull request, and add review comment'
diff --git a/test/ui.test.js b/test/ui.test.js
index 279d88f..3185436 100644
--- a/test/ui.test.js
+++ b/test/ui.test.js
@@ -1,6 +1,25 @@
 import { afterEach, describe, expect, it } from 'vitest';
 
-import { maxReachableStep, renderArchetypeOptions, resetNavigationPane, showCopySuccess } from '../src/js/ui.js';
+import {
+  maxReachableStep,
+  renderArchetypeOptions,
+  renderChoiceOptions,
+  resetNavigationPane,
+  showCopySuccess
+} from '../src/js/ui.js';
+
+const archetypeConfig = {
+  archetypes: {
+    pinned: ['skill-pr-reviewer', 'code-improvement', 'daily-test-improver', 'documentation-updater'],
+    aliases: {},
+    custom: {
+      id: 'custom',
+      label: 'Custom',
+      description: 'Describe your own workflow — start from scratch',
+      full_width: true
+    }
+  }
+};
 
 const originalDocument = globalThis.document;
 
@@ -34,7 +53,7 @@ describe('wizard navigation', () => {
         archetypes: [
           { id: 'status-report', label: 'Status Report', description: 'Periodic status/activity reports' }
         ]
-      });
+      }, archetypeConfig);
 
       expect(container.children).toHaveLength(2);
       const values = container.children.map((card) => card.dataset.value);
@@ -68,7 +87,7 @@ describe('wizard navigation', () => {
           { id: 'code-improvement', label: 'Code Improvement' },
           { id: 'skill-pr-reviewer', label: 'Skill PR Reviewer' }
         ]
-      });
+      }, archetypeConfig);
 
       const values = container.children.map((card) => card.dataset.value);
       expect(values).toEqual([
@@ -88,6 +107,44 @@ describe('wizard navigation', () => {
       expect(container.children[5].classList.contains('priority-archetype')).toBe(false);
       expect(container.children[6].classList.contains('priority-archetype')).toBe(false);
     });
+
+    it('renders choice cards from wizard configuration', () => {
+      const container = createElement();
+      globalThis.document = {
+        getElementById(id) {
+          return id === 'trigger-options' ? container : null;
+        },
+        createElement() {
+          return createElement();
+        },
+        createElementNS() {
+          return createElement();
+        },
+        createTextNode(text) {
+          return { textContent: text };
+        }
+      };
+
+      renderChoiceOptions({
+        steps: {
+          trigger: {
+            options: [{
+              id: 'release',
+              label: 'Release published',
+              description: 'Runs for a release',
+              icon: 'tag'
+            }]
+          }
+        }
+      }, 'trigger');
+
+      expect(container.children).toHaveLength(1);
+      expect(container.children[0].children[0]).toMatchObject({
+        name: 'trigger',
+        type: 'checkbox',
+        value: 'release'
+      });
+    });
   });
 
   describe('copy prompt success', () => {
diff --git a/test/wizard-config.test.js b/test/wizard-config.test.js
new file mode 100644
index 0000000..5141e2d
--- /dev/null
+++ b/test/wizard-config.test.js
@@ -0,0 +1,46 @@
+import { describe, expect, it, vi } from 'vitest';
+
+import {
+  loadWizardConfig,
+  resolveWizardAssetUrl,
+  wizardOptions,
+  wizardStep
+} from '../src/js/wizard-config.js';
+
+describe('wizard configuration', () => {
+  it('loads configuration from a caller-provided URL', async () => {
+    const config = { steps: { trigger: { options: [] } } };
+    const fetchImpl = vi.fn().mockResolvedValue({
+      ok: true,
+      json: () => Promise.resolve(config)
+    });
+
+    await expect(loadWizardConfig('/custom/wizard.json', fetchImpl)).resolves.toBe(config);
+    expect(fetchImpl).toHaveBeenCalledWith('/custom/wizard.json');
+  });
+
+  it('resolves data files relative to an external configuration', () => {
+    globalThis.document = { baseURI: 'https://wizard.example/app/' };
+
+    expect(resolveWizardAssetUrl(
+      'data/manifest.json',
+      'https://custom.example/config/wizard.json'
+    )).toBe('https://custom.example/config/data/manifest.json');
+  });
+
+  it('reads configured steps and returns empty values for missing steps', () => {
+    const config = {
+      steps: {
+        output: {
+          placeholder: 'pick an output',
+          options: [{ id: 'publish' }]
+        }
+      }
+    };
+
+    expect(wizardStep(config, 'output').placeholder).toBe('pick an output');
+    expect(wizardOptions(config, 'output')).toEqual([{ id: 'publish' }]);
+    expect(wizardStep(config, 'unknown')).toEqual({});
+    expect(wizardOptions(config, 'unknown')).toEqual([]);
+  });
+});

From 537ac32ffb9d5b88621874f6508a062461368d90 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 27 Aug 2026 15:23:08 +0000
Subject: [PATCH 3/6] Handle wizard configuration failures

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 src/js/ui.js               | 12 +++++++++---
 src/js/wizard-config.js    |  8 ++++++--
 test/wizard-config.test.js | 11 ++++++++---
 3 files changed, 23 insertions(+), 8 deletions(-)

diff --git a/src/js/ui.js b/src/js/ui.js
index 4a788e8..cc055f0 100644
--- a/src/js/ui.js
+++ b/src/js/ui.js
@@ -42,16 +42,16 @@ function configuredUrl() {
 }
 
 export function initWizard(options) {
-  options = options || {};
+  const opts = options || {};
   initTheme();
-  const configUrl = options.configUrl || configuredUrl();
+  const configUrl = opts.configUrl || configuredUrl();
   const ready = loadWizardConfig(configUrl).then((config) => {
     wizardConfig = config;
     const patternsUrl = resolveWizardAssetUrl(config.patterns_url, configUrl);
     const enginesUrl = resolveWizardAssetUrl(config.engines_url, configUrl);
     return Promise.all([
       loadPatterns(patternsUrl),
-      loadDefinitionEngines(options.fetch, enginesUrl)
+      loadDefinitionEngines(opts.fetch, enginesUrl)
     ]);
   }).then(([data, engines]) => {
     patterns = data;
@@ -62,6 +62,12 @@ export function initWizard(options) {
     addDefinitionEngineOptions(engines);
     bindFormEvents();
     renderWorkflowSummary();
+  }).catch(() => {
+    const container = document.getElementById('archetype-options');
+    if (container) {
+      container.setAttribute('role', 'status');
+      container.textContent = 'Unable to load the wizard configuration.';
+    }
   });
   bindNavigation();
   initNavigationHistory();
diff --git a/src/js/wizard-config.js b/src/js/wizard-config.js
index d6117ab..3daef5d 100644
--- a/src/js/wizard-config.js
+++ b/src/js/wizard-config.js
@@ -9,10 +9,14 @@ export function loadWizardConfig(configUrl, fetchImpl) {
   });
 }
 
-export function resolveWizardAssetUrl(assetUrl, configUrl) {
+export function resolveWizardAssetUrl(assetUrl, configUrl, baseUrl) {
   if (!assetUrl) return null;
   const base = configUrl || WIZARD_CONFIG_URL;
-  return new URL(assetUrl, new URL(base, document.baseURI)).href;
+  const documentBase = globalThis.document && globalThis.document.baseURI;
+  const locationBase = globalThis.location && globalThis.location.href;
+  const pageBase = baseUrl || documentBase || locationBase;
+  if (!pageBase) return assetUrl;
+  return new URL(assetUrl, new URL(base, pageBase)).href;
 }
 
 export function wizardStep(config, id) {
diff --git a/test/wizard-config.test.js b/test/wizard-config.test.js
index 5141e2d..9cf87ee 100644
--- a/test/wizard-config.test.js
+++ b/test/wizard-config.test.js
@@ -20,14 +20,19 @@ describe('wizard configuration', () => {
   });
 
   it('resolves data files relative to an external configuration', () => {
-    globalThis.document = { baseURI: 'https://wizard.example/app/' };
-
     expect(resolveWizardAssetUrl(
       'data/manifest.json',
-      'https://custom.example/config/wizard.json'
+      'https://custom.example/config/wizard.json',
+      'https://wizard.example/app/'
     )).toBe('https://custom.example/config/data/manifest.json');
   });
 
+  it('leaves relative URLs usable without a browser base URL', () => {
+    expect(resolveWizardAssetUrl('patterns/manifest.json', 'wizard.json')).toBe(
+      'patterns/manifest.json'
+    );
+  });
+
   it('reads configured steps and returns empty values for missing steps', () => {
     const config = {
       steps: {

From e39f0c101bb2fd86ace206fd184e01829f459c71 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 27 Aug 2026 15:24:05 +0000
Subject: [PATCH 4/6] Tighten configuration error handling

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 README.md    |  2 ++
 src/js/ui.js | 22 ++++++++++++++--------
 2 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index f8db743..bcd652e 100644
--- a/README.md
+++ b/README.md
@@ -16,6 +16,8 @@ To host a customized wizard in another repository:
 2. Edit the published `wizard.json` without rebuilding the JavaScript bundle.
 3. Point `patterns_url` at a compatible pattern manifest. Relative URLs are resolved from the
    location of `wizard.json`, so the configuration and its pattern library can be hosted together.
+   The `recommendations.safe_outputs` map retains singular and plural aliases where upstream pattern
+   libraries use both forms (for example, `add-label` and `add-labels`).
 
 The default page reads the configuration URL from:
 
diff --git a/src/js/ui.js b/src/js/ui.js
index cc055f0..2394589 100644
--- a/src/js/ui.js
+++ b/src/js/ui.js
@@ -45,7 +45,17 @@ export function initWizard(options) {
   const opts = options || {};
   initTheme();
   const configUrl = opts.configUrl || configuredUrl();
-  const ready = loadWizardConfig(configUrl).then((config) => {
+  const ready = loadWizardConfig(configUrl).catch(() => {
+    return null;
+  }).then((config) => {
+    if (!config) {
+      const container = document.getElementById('archetype-options');
+      if (container) {
+        container.setAttribute('role', 'status');
+        container.textContent = 'Unable to load the wizard configuration.';
+      }
+      return null;
+    }
     wizardConfig = config;
     const patternsUrl = resolveWizardAssetUrl(config.patterns_url, configUrl);
     const enginesUrl = resolveWizardAssetUrl(config.engines_url, configUrl);
@@ -53,7 +63,9 @@ export function initWizard(options) {
       loadPatterns(patternsUrl),
       loadDefinitionEngines(opts.fetch, enginesUrl)
     ]);
-  }).then(([data, engines]) => {
+  }).then((loaded) => {
+    if (!loaded) return;
+    const [data, engines] = loaded;
     patterns = data;
     renderArchetypeOptions(data, wizardConfig);
     renderConfiguredOptions(wizardConfig);
@@ -62,12 +74,6 @@ export function initWizard(options) {
     addDefinitionEngineOptions(engines);
     bindFormEvents();
     renderWorkflowSummary();
-  }).catch(() => {
-    const container = document.getElementById('archetype-options');
-    if (container) {
-      container.setAttribute('role', 'status');
-      container.textContent = 'Unable to load the wizard configuration.';
-    }
   });
   bindNavigation();
   initNavigationHistory();

From db67bc578563c3cffe213505445b490720be98be Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 27 Aug 2026 16:16:35 +0000
Subject: [PATCH 5/6] Restore archetype prompt safeguards

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 patterns/archetypes/code-improvement.json      | 2 ++
 patterns/archetypes/dependency-monitor.json    | 4 +++-
 patterns/archetypes/documentation-updater.json | 1 +
 patterns/archetypes/status-report.json         | 3 ++-
 4 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/patterns/archetypes/code-improvement.json b/patterns/archetypes/code-improvement.json
index ea3c5c3..2ef7d21 100644
--- a/patterns/archetypes/code-improvement.json
+++ b/patterns/archetypes/code-improvement.json
@@ -56,6 +56,8 @@
     "Use schedule triggers for continuous maintenance coverage",
     "Add pre-steps to run tests/linters before the agent starts \u2014 validates baseline",
     "Avoid pr-fix and ci-doctor templates \u2014 both have <20% success in practice",
+    "Use explicit DO NOT constraints to keep changes scoped to the requested improvement",
+    "Use protected-files: fallback-to-issue for manifests, CI configuration, and agent instructions",
     "Add a pre-activation step that skips scheduled runs once too many open PRs share your title prefix, to avoid spamming maintainers"
   ],
   "anti_patterns": [
diff --git a/patterns/archetypes/dependency-monitor.json b/patterns/archetypes/dependency-monitor.json
index cbd98b5..3a495dd 100644
--- a/patterns/archetypes/dependency-monitor.json
+++ b/patterns/archetypes/dependency-monitor.json
@@ -57,7 +57,9 @@
   "tips": [
     "Use schedule triggers for reliable periodic checks",
     "Include a checklist of specific dependencies to monitor \u2014 don't leave it open-ended",
-    "Enable network access for fetching upstream release data"
+    "Enable network access for fetching upstream release data",
+    "Use DO NOT constraints to prevent unrelated dependency or source changes",
+    "Use skip-if-match to prevent duplicate scheduled findings"
   ],
   "anti_patterns": [
     "skills-updater",
diff --git a/patterns/archetypes/documentation-updater.json b/patterns/archetypes/documentation-updater.json
index 93ca185..0699f38 100644
--- a/patterns/archetypes/documentation-updater.json
+++ b/patterns/archetypes/documentation-updater.json
@@ -56,6 +56,7 @@
     "80% success rate \u2014 reliable when scoped to specific doc areas",
     "Add pre-steps to validate docs build before the agent starts",
     "Use DO NOT constraints to prevent deleting existing content",
+    "Use protected-files: fallback-to-issue for manifests, CI configuration, and agent instructions",
     "Add a pre-activation step that skips scheduled runs once too many open PRs share your title prefix, to avoid spamming maintainers"
   ],
   "anti_patterns": [
diff --git a/patterns/archetypes/status-report.json b/patterns/archetypes/status-report.json
index c7c22b5..744393b 100644
--- a/patterns/archetypes/status-report.json
+++ b/patterns/archetypes/status-report.json
@@ -55,7 +55,8 @@
   "tips": [
     "Pre-fetch data in a steps: block \u2014 #1 predictor of workflow health",
     "Use schedule triggers for repeatable reporting",
-    "Keep prompts focused on one report \u2014 multi-source reports need pre-steps"
+    "Keep prompts focused on one report \u2014 multi-source reports need pre-steps",
+    "Use DO NOT constraints to prevent repository changes while generating reports"
   ],
   "anti_patterns": [
     "daily-repo-status",

From 88c065f3605287af9e26a9ad61f59d5b16c32062 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 27 Aug 2026 16:19:53 +0000
Subject: [PATCH 6/6] Configure landing and footer content

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 README.md                  |  4 +--
 src/index.html             | 28 ++++++++++-----------
 src/js/ui.js               |  2 ++
 src/js/wizard-config.js    | 50 ++++++++++++++++++++++++++++++++++++++
 src/wizard.json            | 33 +++++++++++++++++++++++++
 test/wizard-config.test.js | 43 ++++++++++++++++++++++++++++++++
 6 files changed, 144 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index bcd652e..e433dfa 100644
--- a/README.md
+++ b/README.md
@@ -7,8 +7,8 @@ A wizard interface to create GitHub Agentic Workflows. Create ready-to-use [GitH
 ## Customize the wizard
 
 The dashboard is rendered at runtime from [`src/wizard.json`](src/wizard.json). The file defines the
-archetype ordering, trigger/output/extra/engine cards, summary text, recommendation mappings, and
-the URLs of the pattern library and engine catalog.
+landing-page text, footer labels and URLs, archetype ordering, trigger/output/extra/engine cards,
+summary text, recommendation mappings, and the URLs of the pattern library and engine catalog.
 
 To host a customized wizard in another repository:
 
diff --git a/src/index.html b/src/index.html
index aa1c9ca..4a45dca 100644
--- a/src/index.html
+++ b/src/index.html
@@ -65,24 +65,24 @@ <h1>GitHub Agentic Workflow Generator</h1>
     <section class="landing" id="landing" aria-labelledby="landing-title">
       <div class="landing-glow" aria-hidden="true"></div>
       <h2 class="landing-title" id="landing-title">Automate your repository with AI agents</h2>
-      <p class="landing-message">Answer a few questions and get a ready-to-run agentic workflow for your repository.</p>
+      <p class="landing-message" id="landing-message">Answer a few questions and get a ready-to-run agentic workflow for your repository.</p>
       <button class="btn btn-primary btn-get-started" id="btn-get-started" type="button">
-        Create Your Agentic Workflow
+        <span id="landing-button-label">Create Your Agentic Workflow</span>
         <svg class="octicon" aria-hidden="true"><use href="#octicon-zap"></use></svg>
       </button>
-      <p class="landing-hint">Takes about a minute — no sign-in required.</p>
+      <p class="landing-hint" id="landing-hint">Takes about a minute — no sign-in required.</p>
 
       <div class="landing-diagram" aria-hidden="true">
         <div class="ld-runner">
           <svg class="vendor-icon ld-runner-icon" focusable="false"><use href="#vendor-github"></use></svg>
-          <span class="ld-runner-label">Runs safely on GitHub Actions</span>
+          <span class="ld-runner-label" id="landing-runner">Runs safely on GitHub Actions</span>
         </div>
         <div class="ld-phases">
           <div class="ld-phase">
             <div class="ld-phase-icon"><svg class="octicon" focusable="false"><use href="#octicon-zap"></use></svg></div>
             <div class="ld-phase-text">
-              <span class="ld-phase-label">When</span>
-              <span class="ld-phase-sub">Trigger</span>
+              <span class="ld-phase-label" id="landing-trigger-label">When</span>
+              <span class="ld-phase-sub" id="landing-trigger-description">Trigger</span>
             </div>
           </div>
           <svg class="ld-arrow" viewBox="0 0 48 24" focusable="false">
@@ -98,7 +98,7 @@ <h2 class="landing-title" id="landing-title">Automate your repository with AI ag
               <svg class="vendor-icon" focusable="false"><use href="#vendor-openai"></use></svg>
             </div>
             <div class="ld-phase-text">
-              <span class="ld-phase-label">Agent</span>
+              <span class="ld-phase-label" id="landing-agent-label">Agent</span>
             </div>
           </div>
           <svg class="ld-arrow" viewBox="0 0 48 24" focusable="false">
@@ -113,7 +113,7 @@ <h2 class="landing-title" id="landing-title">Automate your repository with AI ag
               <svg class="octicon" focusable="false"><use href="#octicon-tag"></use></svg>
             </div>
             <div class="ld-phase-text">
-              <span class="ld-phase-label">Safe outputs</span>
+              <span class="ld-phase-label" id="landing-outputs-label">Safe outputs</span>
             </div>
           </div>
         </div>
@@ -234,12 +234,12 @@ <h2>Your workflow generator prompt is ready</h2>
 
   <footer class="site-footer">
     <div class="container">
-      <a class="footer-source" href="https://github.com/githubnext/gh-aw-wizard">
+      <a class="footer-source" id="footer-source" href="https://github.com/githubnext/gh-aw-wizard">
         <svg class="vendor-icon" aria-hidden="true"><use href="#vendor-github"></use></svg>
-        <span class="visually-hidden">View source</span>
+        <span class="visually-hidden" id="footer-source-label">View source</span>
       </a>
       <span class="legal-separator" aria-hidden="true">·</span>
-      <a href="https://github.com/githubnext/gh-aw-wizard/issues">Report an issue</a>
+      <a id="footer-report-issue" href="https://github.com/githubnext/gh-aw-wizard/issues">Report an issue</a>
       <span class="legal-separator" aria-hidden="true">·</span>
       <button class="theme-toggle" id="theme-toggle" type="button">
         <svg class="theme-toggle-icon octicon" aria-hidden="true"><use href="#octicon-device-desktop"></use></svg>
@@ -247,11 +247,11 @@ <h2>Your workflow generator prompt is ready</h2>
       </button>
       <span class="footer-separator" aria-hidden="true">•</span>
       <span class="footer-terms">
-        <a href="https://docs.github.com/en/site-policy/github-terms/github-terms-of-service" target="_blank" rel="noopener noreferrer">Terms</a>
+        <a id="footer-terms" href="https://docs.github.com/en/site-policy/github-terms/github-terms-of-service" target="_blank" rel="noopener noreferrer">Terms</a>
         <span class="legal-separator" aria-hidden="true">·</span>
-        <a href="https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement" target="_blank" rel="noopener noreferrer">Privacy</a>
+        <a id="footer-privacy" href="https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement" target="_blank" rel="noopener noreferrer">Privacy</a>
         <span class="legal-separator" aria-hidden="true">·</span>
-        <a href="https://github.com/security" target="_blank" rel="noopener noreferrer">Security</a>
+        <a id="footer-security" href="https://github.com/security" target="_blank" rel="noopener noreferrer">Security</a>
       </span>
     </div>
   </footer>
diff --git a/src/js/ui.js b/src/js/ui.js
index 2394589..3f06da4 100644
--- a/src/js/ui.js
+++ b/src/js/ui.js
@@ -22,6 +22,7 @@ import {
 } from './engines.js';
 import {
   WIZARD_CONFIG_URL,
+  applyPageContent,
   loadWizardConfig,
   resolveWizardAssetUrl,
   wizardOptions
@@ -57,6 +58,7 @@ export function initWizard(options) {
       return null;
     }
     wizardConfig = config;
+    applyPageContent(config, configUrl);
     const patternsUrl = resolveWizardAssetUrl(config.patterns_url, configUrl);
     const enginesUrl = resolveWizardAssetUrl(config.engines_url, configUrl);
     return Promise.all([
diff --git a/src/js/wizard-config.js b/src/js/wizard-config.js
index 3daef5d..0933e93 100644
--- a/src/js/wizard-config.js
+++ b/src/js/wizard-config.js
@@ -27,3 +27,53 @@ export function wizardOptions(config, id) {
   const step = wizardStep(config, id);
   return Array.isArray(step.options) ? step.options : [];
 }
+
+const LANDING_ELEMENTS = {
+  title: 'landing-title',
+  message: 'landing-message',
+  button: 'landing-button-label',
+  hint: 'landing-hint',
+  runner: 'landing-runner',
+  trigger_label: 'landing-trigger-label',
+  trigger_description: 'landing-trigger-description',
+  agent_label: 'landing-agent-label',
+  outputs_label: 'landing-outputs-label'
+};
+
+const FOOTER_ELEMENTS = {
+  source: ['footer-source', 'footer-source-label'],
+  report_issue: ['footer-report-issue', 'footer-report-issue'],
+  terms: ['footer-terms', 'footer-terms'],
+  privacy: ['footer-privacy', 'footer-privacy'],
+  security: ['footer-security', 'footer-security']
+};
+
+function setText(id, value) {
+  const element = document.getElementById(id);
+  if (element && typeof value === 'string') element.textContent = value;
+}
+
+function safeUrl(url, configUrl) {
+  const resolved = resolveWizardAssetUrl(url, configUrl);
+  if (!resolved) return null;
+  try {
+    const parsed = new URL(resolved, document.baseURI);
+    return parsed.protocol === 'http:' || parsed.protocol === 'https:' ? parsed.href : null;
+  } catch {
+    return null;
+  }
+}
+
+export function applyPageContent(config, configUrl) {
+  const landing = config && config.landing ? config.landing : {};
+  Object.entries(LANDING_ELEMENTS).forEach(([key, id]) => setText(id, landing[key]));
+
+  const footer = config && config.footer ? config.footer : {};
+  Object.entries(FOOTER_ELEMENTS).forEach(([key, ids]) => {
+    const item = footer[key] || {};
+    const link = document.getElementById(ids[0]);
+    const url = safeUrl(item.url, configUrl);
+    if (link && url) link.href = url;
+    setText(ids[1], item.label);
+  });
+}
diff --git a/src/wizard.json b/src/wizard.json
index 14b7fe3..6884ee5 100644
--- a/src/wizard.json
+++ b/src/wizard.json
@@ -1,6 +1,39 @@
 {
   "patterns_url": "patterns/manifest.json",
   "engines_url": "https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/engines.json",
+  "landing": {
+    "title": "Automate your repository with AI agents",
+    "message": "Answer a few questions and get a ready-to-run agentic workflow for your repository.",
+    "button": "Create Your Agentic Workflow",
+    "hint": "Takes about a minute — no sign-in required.",
+    "runner": "Runs safely on GitHub Actions",
+    "trigger_label": "When",
+    "trigger_description": "Trigger",
+    "agent_label": "Agent",
+    "outputs_label": "Safe outputs"
+  },
+  "footer": {
+    "source": {
+      "url": "https://github.com/githubnext/gh-aw-wizard",
+      "label": "View source"
+    },
+    "report_issue": {
+      "url": "https://github.com/githubnext/gh-aw-wizard/issues",
+      "label": "Report an issue"
+    },
+    "terms": {
+      "url": "https://docs.github.com/en/site-policy/github-terms/github-terms-of-service",
+      "label": "Terms"
+    },
+    "privacy": {
+      "url": "https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement",
+      "label": "Privacy"
+    },
+    "security": {
+      "url": "https://github.com/security",
+      "label": "Security"
+    }
+  },
   "archetypes": {
     "pinned": [
       "skill-pr-reviewer",
diff --git a/test/wizard-config.test.js b/test/wizard-config.test.js
index 9cf87ee..247d356 100644
--- a/test/wizard-config.test.js
+++ b/test/wizard-config.test.js
@@ -1,6 +1,7 @@
 import { describe, expect, it, vi } from 'vitest';
 
 import {
+  applyPageContent,
   loadWizardConfig,
   resolveWizardAssetUrl,
   wizardOptions,
@@ -48,4 +49,46 @@ describe('wizard configuration', () => {
     expect(wizardStep(config, 'unknown')).toEqual({});
     expect(wizardOptions(config, 'unknown')).toEqual([]);
   });
+
+  it('applies configured landing text and footer links safely', () => {
+    const elements = {
+      'landing-title': { textContent: '' },
+      'landing-button-label': { textContent: '' },
+      'footer-source': { href: '' },
+      'footer-source-label': { textContent: '' },
+      'footer-security': { href: '', textContent: '' }
+    };
+    globalThis.document = {
+      baseURI: 'https://wizard.example/app/',
+      getElementById(id) {
+        return elements[id] || null;
+      }
+    };
+
+    applyPageContent({
+      landing: {
+        title: 'Build an automation',
+        button: 'Start building'
+      },
+      footer: {
+        source: {
+          url: './source',
+          label: 'Source code'
+        },
+        security: {
+          url: 'javascript:alert(1)',
+          label: 'Security'
+        }
+      }
+    }, 'https://custom.example/config/wizard.json');
+
+    expect(elements['landing-title'].textContent).toBe('Build an automation');
+    expect(elements['landing-button-label'].textContent).toBe('Start building');
+    expect(elements['footer-source']).toMatchObject({
+      href: 'https://custom.example/config/source'
+    });
+    expect(elements['footer-source-label'].textContent).toBe('Source code');
+    expect(elements['footer-security'].href).toBe('');
+    expect(elements['footer-security'].textContent).toBe('Security');
+  });
 });