docs: update README files and add release creation prompt

- Update 24 README.md files with enhanced documentation
- Add .github/prompts/create-release.prompt.md for release workflow
- Add readme.instructions.md for documentation standards
- Complete v1.0.0 release preparation documentation

Author: ashleyshaw

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

@@ -0,0 +1,357 @@
+---
+description: Step-by-step guide for creating GitHub releases for the Multi-Block Plugin Scaffold
+category: Release Management
+type: Prompt
+audience: Maintainers
+date: 2025-12-10
+---
+
+# Create GitHub Release Prompt
+
+This prompt guides you through creating a GitHub release from an existing git tag for the Multi-Block Plugin Scaffold.
+
+## Prerequisites
+
+Before starting, ensure:
+
+- ✅ Git tag exists (check: `git tag -l`)
+- ✅ Tag pushed to GitHub (check: `git ls-remote --tags origin`)
+- ✅ CHANGELOG.md updated with release notes
+- ✅ All release preparation tasks complete
+- ✅ Template repository enabled in settings
+- ✅ GitHub topics added
+
+## Quick Start
+
+**URL:** https://github.com/lightspeedwp/multi-block-plugin-scaffold/releases/new
+
+**Tag:** v1.0.0 (or your version)
+
+**Title:** `v1.0.0: Multi-Block Plugin Scaffold`
+
+**Description:** Copy from template below
+
+---
+
+## Step-by-Step Instructions
+
+### Step 1: Navigate to Create Release
+
+1. Go to: https://github.com/lightspeedwp/multi-block-plugin-scaffold/releases/new
+2. Or: Repository → "Releases" → "Draft a new release"
+
+### Step 2: Select Tag
+
+1. Click "Choose a tag" dropdown
+2. Select your version tag: **v1.0.0**
+3. Target branch: **main** (auto-selected)
+
+### Step 3: Add Release Title
+
+Format: `v{VERSION}: {PROJECT_NAME}`
+
+**Example:**
+```
+v1.0.0: Multi-Block Plugin Scaffold
+```
+
+### Step 4: Add Release Description
+
+Copy and customize this template:
+
+```markdown
+🎉 **Initial Release** - Multi-Block Plugin Scaffold v1.0.0
+
+A comprehensive WordPress plugin scaffold with dual-mode generation, mustache templating, and complete development infrastructure for building modern block plugins.
+
+---
+
+## ✨ Highlights
+
+### Core Features
+
+- **🔧 Dual-Mode Generator** - Template mode (`--in-place`) or output folder mode (default)
+- **🎨 Mustache Templating** - 6 transformation filters (upper, lower, pascalCase, camelCase, kebabCase, snakeCase)
+- **📦 Example Blocks** - Card, Collection, Slider, and Featured blocks ready to use
+- **🧪 130 Unit Tests** - Comprehensive test coverage across 7 test suites
+- **🔍 Complete Linting** - ESLint, Stylelint, PHPCS, and PHPStan configured
+- **📚 15+ Documentation Files** - Comprehensive guides for all aspects
+
+### WordPress Integration
+
+- Custom Post Types & Taxonomies scaffolding
+- Secure Custom Fields (SCF) with local JSON sync
+- Block Patterns (7 pre-built patterns)
+- Block Templates with automatic assignment
+- Block Bindings API support (WordPress 6.5+)
+- Block Styles registration
+- Options Pages with Settings API
+
+### Developer Experience
+
+- Interactive CLI with JSON mode
+- Schema validation for configuration
+- Dry-run testing system
+- Pre-commit hooks (Husky)
+- wp-env integration
+- Webpack 5 build system
+
+---
+
+## 🚀 Getting Started
+
+### Using the Template
+
+1. Click the green **"Use this template"** button
+2. Create your repository
+3. Clone locally: `git clone https://github.com/YOUR_ORG/YOUR_PLUGIN.git`
+4. Install dependencies: `npm install && composer install`
+5. Run generator: `node scripts/generate-plugin.js --in-place`
+
+### Quick Generation
+
+```bash
+# Clone the scaffold
+git clone https://github.com/lightspeedwp/multi-block-plugin-scaffold.git my-plugin
+cd my-plugin
+
+# Generate plugin (output mode)
+node scripts/generate-plugin.js --config plugin-config.json
+
+# Or use interactive mode
+node scripts/generate-plugin.js
+```
+
+---
+
+## 📋 Requirements
+
+- **WordPress:** 6.5 or higher
+- **PHP:** 8.0 or higher
+- **Node.js:** 18.x or higher
+- **Composer:** 2.x or higher
+
+---
+
+## 📖 Documentation
+
+Complete documentation available in the `docs/` directory:
+
+- **[README.md](https://github.com/lightspeedwp/multi-block-plugin-scaffold#readme)** - Overview and quick start
+- **[GENERATE-PLUGIN.md](https://github.com/lightspeedwp/multi-block-plugin-scaffold/blob/main/docs/GENERATE-PLUGIN.md)** - Plugin generation guide
+- **[ARCHITECTURE.md](https://github.com/lightspeedwp/multi-block-plugin-scaffold/blob/main/docs/ARCHITECTURE.md)** - Repository structure
+- **[BUILD-PROCESS.md](https://github.com/lightspeedwp/multi-block-plugin-scaffold/blob/main/docs/BUILD-PROCESS.md)** - Build system details
+- **[TESTING.md](https://github.com/lightspeedwp/multi-block-plugin-scaffold/blob/main/docs/TESTING.md)** - Testing strategies
+
+---
+
+## 🔗 Links
+
+- **Documentation:** https://github.com/lightspeedwp/multi-block-plugin-scaffold/tree/main/docs
+- **Issues:** https://github.com/lightspeedwp/multi-block-plugin-scaffold/issues
+- **Discussions:** https://github.com/lightspeedwp/multi-block-plugin-scaffold/discussions
+- **Changelog:** [CHANGELOG.md](https://github.com/lightspeedwp/multi-block-plugin-scaffold/blob/main/CHANGELOG.md)
+
+---
+
+## 🙏 Credits
+
+Developed by [LightSpeed](https://lightspeedwp.agency) for the WordPress community.
+
+---
+
+## 📄 License
+
+GPL-3.0-or-later - See [LICENSE](https://github.com/lightspeedwp/multi-block-plugin-scaffold/blob/main/LICENSE) for details.
+```
+
+### Step 5: Configure Release Options
+
+**Set as latest release:**
+- ✅ Check this box
+
+**Set as a pre-release:**
+- ☐ Leave unchecked (this is a stable release)
+
+**Create a discussion for this release:**
+- ☐ Optional - check if you want community discussion
+
+### Step 6: Publish Release
+
+1. Review all information
+2. Click **"Publish release"** button
+3. Confirm release published
+
+---
+
+## Verification Checklist
+
+After publishing, verify:
+
+- [ ] Release appears at: https://github.com/lightspeedwp/multi-block-plugin-scaffold/releases
+- [ ] "Latest" badge is visible
+- [ ] Download links work (Source code zip/tar.gz)
+- [ ] Release description displays correctly with formatting
+- [ ] All documentation links are functional
+- [ ] Release shows correct tag (v1.0.0)
+- [ ] Target branch is "main"
+
+---
+
+## Alternative: GitHub CLI
+
+If you prefer automation:
+
+```bash
+# Install GitHub CLI if needed
+brew install gh
+
+# Authenticate
+gh auth login
+
+# Create release from tag
+gh release create v1.0.0 \
+  --title "v1.0.0: Multi-Block Plugin Scaffold" \
+  --notes-file RELEASE_NOTES.md \
+  --latest
+
+# Or use inline notes
+gh release create v1.0.0 \
+  --title "v1.0.0: Multi-Block Plugin Scaffold" \
+  --notes "$(cat CHANGELOG.md)" \
+  --latest
+```
+
+---
+
+## Alternative: GitHub API
+
+Using curl with GitHub API:
+
+```bash
+# Set variables
+GITHUB_TOKEN="your_personal_access_token"
+REPO="lightspeedwp/multi-block-plugin-scaffold"
+TAG="v1.0.0"
+
+# Create release
+curl -X POST \
+  -H "Accept: application/vnd.github+json" \
+  -H "Authorization: Bearer $GITHUB_TOKEN" \
+  https://api.github.com/repos/$REPO/releases \
+  -d '{
+    "tag_name": "'"$TAG"'",
+    "target_commitish": "main",
+    "name": "v1.0.0: Multi-Block Plugin Scaffold",
+    "body": "Release notes here...",
+    "draft": false,
+    "prerelease": false,
+    "make_latest": true
+  }'
+```
+
+---
+
+## Troubleshooting
+
+### Issue: Tag not found
+
+**Solution:**
+```bash
+# Check if tag exists locally
+git tag -l
+
+# Check if tag exists on remote
+git ls-remote --tags origin
+
+# Push tag if missing
+git push origin v1.0.0
+```
+
+### Issue: Release fails to create
+
+**Possible causes:**
+1. Tag doesn't exist on GitHub
+2. Insufficient permissions
+3. Release with same tag already exists
+
+**Solution:**
+- Verify tag pushed to GitHub
+- Check repository permissions (need write access)
+- Delete existing release if recreating
+
+### Issue: Markdown not rendering
+
+**Causes:**
+- Malformed markdown syntax
+- Broken links
+- Invalid HTML in description
+
+**Solution:**
+- Validate markdown with a linter
+- Preview in GitHub's markdown preview
+- Remove any raw HTML
+
+---
+
+## Post-Release Tasks
+
+After publishing v1.0.0:
+
+1. **Update todo list** - Mark Task 20 as completed
+2. **Announce release** - Share on social media, WordPress Slack
+3. **Monitor issues** - Watch for bug reports from early adopters
+4. **Plan v1.1.0** - Start collecting feature requests
+5. **Update documentation** - Add any post-release notes
+
+---
+
+## Related Files
+
+- [CHANGELOG.md](../../CHANGELOG.md) - Release notes source
+- [release.agent.md](../agents/release.agent.md) - Release preparation agent
+- [template-repository-settings.json](../template-repository-settings.json) - Repository configuration
+- [GOVERNANCE.md](../../docs/GOVERNANCE.md) - Release process policies
+
+---
+
+## Quick Reference Card
+
+| Item | Value |
+|------|-------|
+| **Release URL** | https://github.com/lightspeedwp/multi-block-plugin-scaffold/releases/new |
+| **Tag** | v1.0.0 |
+| **Title Format** | `v{VERSION}: {PROJECT_NAME}` |
+| **Target Branch** | main |
+| **Latest** | ✅ Yes |
+| **Pre-release** | ☐ No |
+
+---
+
+## Success Criteria
+
+Release is successful when:
+
+- ✅ Release published and visible
+- ✅ "Latest" badge shown
+- ✅ Download links functional
+- ✅ All documentation accessible
+- ✅ Template repository working
+- ✅ Topics searchable on GitHub
+- ✅ Community can use template
+
+---
+
+## Next Steps
+
+After v1.0.0 release:
+
+1. Monitor feedback and issues
+2. Plan v1.0.1 for bug fixes (if needed)
+3. Start planning v1.1.0 features
+4. Update roadmap based on community input
+5. Continue improving documentation
+
+---
+
+**Ready to create the release?** Use this checklist and follow the steps above! 🚀