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
+2 -2
View File
@@ -144,12 +144,12 @@ Apply the minimal fix necessary to address the critical issue.
Increment the PATCH version and update all version numbers: 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 - FPDEN_VERSION constant
- CHANGELOG.md - CHANGELOG.md
- readme.txt - readme.txt
- README.md - 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 ### 4. Commit and Push
-1
View File
@@ -27,7 +27,6 @@ When implementing a new feature:
- Add appropriate comments - Add appropriate comments
- Consider performance implications - Consider performance implications
- Maintain backward compatibility - Maintain backward compatibility
- Review reference plugins in the `reference-plugins/` directory for inspiration and best practices
### 3. Update Documentation ### 3. Update Documentation
+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: The `includes/` directory contains the core plugin functionality:
- **includes/core.php** - Core class for handling the main plugin functionality - **includes/Core.php** - Core class for handling the main plugin functionality
- **includes/plugin.php** - Main plugin class that initializes all components - **includes/Plugin.php** - Main plugin class that initializes all components
- **includes/updater.php** - Updater class for handling plugin updates - **includes/Updater.php** - Updater class for handling plugin updates
## File Naming Conventions ## 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: When referring to files or directories in AI conversations, use the following format:
- **@includes/plugin.php** - Main plugin class - **@includes/Plugin.php** - Main plugin class
- **@includes/core.php** - Core functionality - **@includes/Core.php** - Core functionality
- **@admin/lib/admin.php** - Admin functionality - **@admin/lib/admin.php** - Admin functionality
- **@admin/lib/modal.php** - Modal 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/js/update-source-selector.js** - Update source selector JavaScript
- **@admin/css/update-source-selector.css** - Update source selector CSS - **@admin/css/update-source-selector.css** - Update source selector CSS