chore: run husky pre-commit, stage and commit all mustache and doc updates

Author: ashleyshaw

.github/agents/release-scaffold.agent.md

@@ -24,22 +24,18 @@ metadata:
 
 ## Wizard Integration & Advanced Features
 
-This agent supports an interactive and automated wizard for release preparation:
-
-- **Conditional Logic:**
-  - Only prompts for advanced checks (e.g., smoke test, schema validation) if user opts in or config enables them.
-- **Config File Automation:**
-  - Accepts a config file to automate release checks and reporting:
-    - `node scripts/agents/release-scaffold.agent.js --config path/to/release-config.json`
-  - Config can specify which checks to run, custom version, or skip optional steps.
-- **Dry-Run/Mock Mode:**
-  - Use `WIZARD_MODE=mock` or `--dry-run` to simulate all checks and reporting without modifying files.
-  - Useful for CI, validation, and pre-release rehearsal.
-- **Validation & Error Recovery:**
-  - Each step validates its outcome (e.g., placeholder integrity, version alignment).
-  - If a check fails, the wizard reports the error, suggests fixes, and can re-run after correction.
-- **Explicit Mapping:**
-  - Each wizard step maps to a config schema field and release check (see below).
+This agent is tightly integrated with the **Release Scaffold Wizard** defined in `.github/prompts/create-release-scaffold.prompt.md` and implemented via `scripts/lib/wizard.js`.
+
+- **Wizard Prompt:** All release-scaffold processes must use the wizard steps and config schema defined in `.github/prompts/create-release-scaffold.prompt.md`.
+- **Wizard Interface:** Supports CLI, JSON, ENV, mock, and other interfaces as defined in `scripts/lib/wizard.js`.
+- **Mustache Placeholder Protection:** Never strip or replace `{{mustache}}` placeholders in the scaffold repository. Placeholders are only replaced during theme generation, not in the scaffold itself. Validate placeholder presence before every release.
+- **Conditional Logic:** Prompts for advanced checks (e.g., smoke test, schema validation) only if enabled in config or by user input.
+- **Config File Automation:** Accepts a config file to automate release checks and reporting. See wizard prompt for schema.
+- **Dry-Run/Mock Mode:** Use `WIZARD_MODE=mock` or `--dry-run` to simulate all checks and reporting without modifying files. Useful for CI, validation, and pre-release rehearsal.
+- **Validation & Error Recovery:** Each step validates its outcome (e.g., placeholder integrity, version alignment). If a check fails, the wizard reports the error, suggests fixes, and can re-run after correction.
+- **Explicit Mapping:** Each wizard step maps to a config schema field and release check (see wizard prompt).
+
+See `.github/prompts/create-release-scaffold.prompt.md` for the canonical wizard steps and config schema.
 
 ### Example: Using a Config File
 

.github/instructions/folder-structure.instructions.md

@@ -6,6 +6,9 @@ applyTo: "**"
 
 # Folder Structure Instructions
 
+> **Critical Rule:**
+> Never strip or replace `{{mustache}}` placeholders in the scaffold repository. Only replace them during theme generation, never in the scaffold itself.
+
 ## Overview
 
 This document provides a comprehensive reference for the block-theme-scaffold project's folder structure, naming conventions, and organization principles.
@@ -66,23 +69,27 @@ block-theme-scaffold/
 Contains all GitHub-specific and AI agent configuration files.
 
 #### .github/agents/
+
 - **Purpose:** AI agent specification documents
 - **Naming:** `[agent-name].agent.md`
 - **Contents:** Agent behavior, capabilities, and constraints
 - **Mustache:** Contains `{{variables}}` in scaffold, replaced in generated themes
 
 **Files:**
+
 - `generate-theme.agent.md` - Theme generator agent spec
 - `release.agent.md` - Release preparation agent (templated)
 - `release-scaffold.agent.md` - Scaffold release agent (deleted in generated themes)
 
 #### .github/instructions/
+
 - **Purpose:** Detailed instructions for AI agents
 - **Naming:** `[topic].instructions.md`
 - **Contents:** How-to guides for specific tasks
 - **Mustache:** May contain `{{variables}}` where appropriate
 
 **Key Files:**
+
 - `reporting.instructions.md` - Report generation and storage
 - `release.instructions.md` - Release process (templated)
 - `generate-theme.instructions.md` - Theme generation guide
@@ -92,6 +99,7 @@ Contains all GitHub-specific and AI agent configuration files.
 - `temp-files.instructions.md` - Temporary file handling
 
 #### .github/projects/
+
 - **Purpose:** Project management and planning
 - **Structure:**
   ```
@@ -102,12 +110,14 @@ Contains all GitHub-specific and AI agent configuration files.
   ```
 
 #### .github/prompts/
+
 - **Purpose:** AI prompt templates
 - **Naming:** `[prompt-name].prompt.md`
 - **Contents:** Structured prompts for AI assistants
 - **Mustache:** Contains `{{variables}}` in scaffold
 
 #### .github/reports/
+
 - **Purpose:** Generated reports and analysis outputs
 - **Structure:**
   ```
@@ -126,32 +136,39 @@ Contains all GitHub-specific and AI agent configuration files.
 - **Gitignored:** Yes (except README and .gitkeep)
 
 #### .github/schemas/
+
 - **Purpose:** JSON schemas for validation
 - **Naming:** `[schema-name].schema.json`
 
 **Files:**
+
 - `theme-config.schema.json` - Theme configuration schema
 - `frontmatter.schema.json` - Agent frontmatter schema
 - `mustache-variables-registry.schema.json` - Mustache variable registry
 
 ### scripts/ - Build and Automation Scripts
 
 #### scripts/agents/
+
 - **Purpose:** Agent implementation scripts
 - **Naming:** `[agent-name].agent.js`
 
 #### scripts/lib/
+
 - **Purpose:** Shared libraries and utilities
 - **Naming:** Descriptive names with action prefix
 
 **Files:**
+
 - `define-config-schema.js` - Theme configuration schema definition
 
 #### scripts/validation/
+
 - **Purpose:** Validation scripts
 - **Naming:** `validate-[what].js` or `audit-[what].js`
 
 **Files:**
+
 - `validate-mustache-schema.js` - Mustache variable validation
 - `validate-agent-frontmatter.js` - Agent frontmatter validation
 - `validate-config-schema.js` - Configuration validation wrapper
@@ -164,6 +181,7 @@ User-facing documentation and guides.
 **Naming:** `[TOPIC_NAME].md` (uppercase with underscores)
 
 **Files:**
+
 - `GENERATE_THEME.md` - Theme generation guide
 - `RELEASE_PROCESS.md` - Release process (templated)
 - `RELEASE_PROCESS_SCAFFOLD.md` - Scaffold release (deleted in generated themes)
@@ -176,6 +194,7 @@ User-facing documentation and guides.
 Runtime logs from scripts and agents.
 
 **Structure:**
+
 ```
 logs/
 ├── agents/         # Agent execution logs
@@ -198,16 +217,16 @@ logs/
 
 ### Files
 
-| Type | Convention | Example |
-|------|------------|---------|
-| Documentation | `UPPERCASE_WITH_UNDERSCORES.md` | `GENERATE_THEME.md` |
-| Instructions | `kebab-case.instructions.md` | `release.instructions.md` |
-| Agents | `kebab-case.agent.md/js` | `generate-theme.agent.js` |
-| Schemas | `kebab-case.schema.json` | `theme-config.schema.json` |
-| Reports | `YYYY-MM-DD-kebab-case.ext` | `2025-12-17-coverage.html` |
-| Logs | `YYYY-MM-DD-kebab-case.log` | `2025-12-17-build.log` |
-| Plans | `YYYY-MM-DD-kebab-case.md` | `2025-12-17-feature-plan.md` |
-| Scripts | `action-subject.js` | `validate-mustache-schema.js` |
+| Type          | Convention                      | Example                       |
+| ------------- | ------------------------------- | ----------------------------- |
+| Documentation | `UPPERCASE_WITH_UNDERSCORES.md` | `GENERATE_THEME.md`           |
+| Instructions  | `kebab-case.instructions.md`    | `release.instructions.md`     |
+| Agents        | `kebab-case.agent.md/js`        | `generate-theme.agent.js`     |
+| Schemas       | `kebab-case.schema.json`        | `theme-config.schema.json`    |
+| Reports       | `YYYY-MM-DD-kebab-case.ext`     | `2025-12-17-coverage.html`    |
+| Logs          | `YYYY-MM-DD-kebab-case.log`     | `2025-12-17-build.log`        |
+| Plans         | `YYYY-MM-DD-kebab-case.md`      | `2025-12-17-feature-plan.md`  |
+| Scripts       | `action-subject.js`             | `validate-mustache-schema.js` |
 
 ### Script Naming Actions
 
@@ -218,9 +237,9 @@ logs/
 
 ### Directories
 
-| Type | Convention | Example |
-|------|------------|---------|
-| Standard | `kebab-case` | `.github/instructions/` |
+| Type       | Convention              | Example                        |
+| ---------- | ----------------------- | ------------------------------ |
+| Standard   | `kebab-case`            | `.github/instructions/`        |
 | Namespaced | `category/subcategory/` | `.github/reports/coverage/js/` |
 
 ## Gitignore Rules
@@ -268,6 +287,7 @@ output-theme/
 ### In Scaffold Repository
 
 Files containing mustache variables:
+
 - `style.css`
 - `functions.php`
 - `theme.json`
@@ -279,22 +299,26 @@ Files containing mustache variables:
 ### After Generation
 
 All `{{variables}}` replaced except in:
+
 - Documentation examples (intentional)
 - Archived/deleted scaffold-specific files
 
 ## Workflow Integration
 
 ### Build Process
+
 ```
 src/ → (webpack/sass) → build/ → (package) → dist/
 ```
 
 ### Generation Process
+
 ```
 scaffold/ → (generate-theme.js) → output-theme/
 ```
 
 ### Testing Process
+
 ```
 src/ + tests/ → (jest/phpunit/playwright) → .github/reports/coverage/
 ```

.github/instructions/generate-theme.instructions.md

@@ -6,6 +6,9 @@ applyTo: ".github/prompts/generate-theme.prompt.md"
 
 # Generate Theme Instructions
 
+> **Critical Rule:**
+> Never strip or replace `{{mustache}}` placeholders in the scaffold repository. Only replace them during theme generation, never in the scaffold itself.
+
 You are a theme generation assistant. Follow our mustache-driven scaffold patterns to collect inputs, validate them, and drive the generator scripts. Avoid hard-coding defaults, skipping validation, or leaving scaffold-only files in the generated output.
 
 This file provides comprehensive instructions for AI agents using the `generate-theme.prompt.md` prompt to guide users through WordPress block theme generation using the mustache template system.

.github/prompts/create-release-scaffold.prompt.md

@@ -8,6 +8,20 @@ This prompt defines the interactive **Release Scaffold Wizard** for the block th
 
 ---
 
+## Integration with Wizard Library
+
+- The wizard steps and config schema defined here are implemented in `scripts/lib/wizard.js`.
+- Supported interfaces: CLI, JSON, ENV, mock, HTTP, YAML, stdin (see wizard.js for details).
+- Each wizard step maps to a config schema field and is used by the release-scaffold agent and scripts.
+
+## Mustache Placeholder Protection
+
+- **Never strip or replace `{{mustache}}` placeholders in the scaffold repository.**
+- Placeholders are only replaced during theme generation, not in the scaffold itself.
+- The wizard and all release-scaffold processes must validate that placeholders are present before release.
+
+---
+
 ## 🚀 Block Theme Scaffold Release Interactive Wizard
 
 The Release Scaffold Wizard guides you step-by-step through preparing and publishing a new block theme scaffold release. Use this wizard for all release-scaffold.\* processes, including automation and manual runs.