Nynaeve 2.15.8 - Self-Contained Documentation and Git Workflow Rules

[jasperf]

Version: 2.15.8

This release is documentation-only, correcting agent-facing guidance in CLAUDE.md and AGENTS.md and bumping the theme to 2.15.8. The primary fix is a corrected block.json prefix table: the documented block category prefix incorrectly read imagewize/*, while categories are actually registered as nynaeve/* in app/setup.php via block_categories_all, meaning any block created from the old guidance would silently land in the editor's generic category. The change also resolves every broken relative link in the theme's markdown — four docs/ links in CLAUDE.md, a project root CHANGELOG.md link that escaped the theme directory with ../../../../../, and three historical docs/ links in the 1.20.2 entry — and inlines the load-bearing content from those missing files so the theme's guidance stands alone outside the imagewize.com monorepo. Finally, it codifies the branch-per-change and atomic-commit workflow rules in both agent guidance files. No PHP, block, markup, styling, or build output changed across the five modified files (96 insertions, 22 deletions).

Block Standards Corrections:

• Fixed the documented block category prefix from imagewize/* to nynaeve/*, matching the slugs actually registered in app/setup.php (nynaeve/hero, nynaeve/features, nynaeve/cta, nynaeve/content, and others); an unregistered slug fails silently rather than erroring, so the incorrect documentation produced miscategorized blocks with no visible warning.
• Documented the three distinct prefixes that were previously conflated in one place: namespace imagewize ("name": "imagewize/my-block"), category nynaeve, and textdomain nynaeve (the theme's Text Domain from style.css, not sage or imagewize).
• Updated the reference block.json example in both CLAUDE.md and AGENTS.md so copy-paste use produces a correctly registered block.

Documentation Portability:

• Removed four broken relative links in CLAUDE.md pointing at a theme-level docs/ folder that does not exist (ACF-BLOCKS.md, BLOCKS.md, CONTENT-WIDTH-AND-LAYOUT.md, PATTERN-TO-NATIVE-BLOCK.md).
• Inlined the essential content from those documents — the layout and block padding system, and the ACF field default-value requirement — so guidance is self-contained for anyone using the theme outside the monorepo.
• Removed the CHANGELOG.md intro link to the project root changelog and de-linked three docs/ references in the historical 1.20.2 entry to plain code spans, preserving the historical record while ensuring every link in the theme's markdown resolves within the theme.

Git Workflow Rules:

• Added a "Branch Per Change" section requiring all theme work to start on its own branch off main and land via PR, because release-theme.sh generates its changelog by diffing the current branch against main — work committed directly to main yields an empty release changelog.
• Added an "Atomic Commits" section requiring files to be staged individually or in small logical groups, with one logical change per commit and no AI attribution footers in history.

Version Release:

• Bumped theme version to 2.15.8 in style.css and the Stable tag in readme.txt, with matching entries added to CHANGELOG.md and the readme.txt changelog.

Files Changed:

• AGENTS.md (Modified)
• CHANGELOG.md (Modified)
• CLAUDE.md (Modified)
• readme.txt (Modified)
• style.css (Modified)