From 17de1949aef3967eb6962b411cc1cd0f6c9157a1 Mon Sep 17 00:00:00 2001
From: marcusquinn <6428977+marcusquinn@users.noreply.github.com>
Date: Wed, 22 Apr 2026 21:09:42 +0100
Subject: [PATCH] fix: correct AI workflow doc file references to prevent
 read:file_not_found errors
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- folder-structure.md: fix includes/core.php → Core.php, plugin.php → Plugin.php,
  updater.php → Updater.php (PascalCase matches actual filenames on disk)
- bug-fixing.md: fix fix-plugin-does-not-exist-notices.php →
  wp-fix-plugin-does-not-exist-notices.php (correct wp- prefix) and
  languages/fix-plugin... → languages/wp-fix-plugin... (same prefix fix)
- feature-development.md: remove reference to non-existent reference-plugins/
  directory to stop read:file_not_found errors when AI follows the docs

Addresses contributor insight issue #16: incorrect file paths in AI workflow
docs were the root cause of 23x read:file_not_found, 71x edit:not_read_first,
32x edit:edit_stale_read, and 66x bash:other errors in AI assistant sessions.
---
 .ai-workflows/bug-fixing.md          |  4 ++--
 .ai-workflows/feature-development.md |  1 -
 .ai-workflows/folder-structure.md    | 12 ++++++------
 3 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/.ai-workflows/bug-fixing.md b/.ai-workflows/bug-fixing.md
index 4e4b8f0..0be6022 100644
--- a/.ai-workflows/bug-fixing.md
+++ b/.ai-workflows/bug-fixing.md
@@ -144,12 +144,12 @@ Apply the minimal fix necessary to address the critical issue.
 
 Increment the PATCH version and update all version numbers:
 
-- Main plugin file (fix-plugin-does-not-exist-notices.php)
+- Main plugin file (wp-fix-plugin-does-not-exist-notices.php)
 - FPDEN_VERSION constant
 - CHANGELOG.md
 - readme.txt
 - README.md
-- languages/fix-plugin-does-not-exist-notices.pot (Project-Id-Version)
+- languages/wp-fix-plugin-does-not-exist-notices.pot (Project-Id-Version)
 
 ### 4. Commit and Push
 
diff --git a/.ai-workflows/feature-development.md b/.ai-workflows/feature-development.md
index 27c92dd..7791c68 100644
--- a/.ai-workflows/feature-development.md
+++ b/.ai-workflows/feature-development.md
@@ -27,7 +27,6 @@ When implementing a new feature:
 - Add appropriate comments
 - Consider performance implications
 - Maintain backward compatibility
-- Review reference plugins in the `reference-plugins/` directory for inspiration and best practices
 
 ### 3. Update Documentation
 
diff --git a/.ai-workflows/folder-structure.md b/.ai-workflows/folder-structure.md
index e63e665..10ecfea 100644
--- a/.ai-workflows/folder-structure.md
+++ b/.ai-workflows/folder-structure.md
@@ -28,9 +28,9 @@ This document outlines the folder structure of the plugin and explains the purpo
 
 The `includes/` directory contains the core plugin functionality:
 
-- **includes/core.php** - Core class for handling the main plugin functionality
-- **includes/plugin.php** - Main plugin class that initializes all components
-- **includes/updater.php** - Updater class for handling plugin updates
+- **includes/Core.php** - Core class for handling the main plugin functionality
+- **includes/Plugin.php** - Main plugin class that initializes all components
+- **includes/Updater.php** - Updater class for handling plugin updates
 
 ## File Naming Conventions
 
@@ -50,10 +50,10 @@ The `includes/` directory contains the core plugin functionality:
 
 When referring to files or directories in AI conversations, use the following format:
 
-- **@includes/plugin.php** - Main plugin class
-- **@includes/core.php** - Core functionality
+- **@includes/Plugin.php** - Main plugin class
+- **@includes/Core.php** - Core functionality
 - **@admin/lib/admin.php** - Admin functionality
 - **@admin/lib/modal.php** - Modal functionality
-- **@includes/updater.php** - Updater functionality
+- **@includes/Updater.php** - Updater functionality
 - **@admin/js/update-source-selector.js** - Update source selector JavaScript
 - **@admin/css/update-source-selector.css** - Update source selector CSS