fix: correct AI workflow doc file references to prevent read:file_not_found errors

- 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.
This commit is contained in:
2026-04-22 21:09:42 +01:00
parent 3eaf8ec7a5
commit 17de1949ae
3 changed files with 8 additions and 9 deletions
+6 -6
View File
@@ -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