# Project Conventions (AI Instruction Manual)

This document is designed to guide AI agents and developers on how to maintain, extend, and optimize this project while minimizing computational overhead (AI credits).

## 🤖 AI Guidelines (Saving Credits)

- **Be Concise**: Favor brief, high-impact comments over verbose explanations.
- **Context Awareness**: Use the already provided `docs/ARCHITECTURE.md` to understand the system instead of re-indexing every time.
- **Incremental Changes**: When modifying code, use diffs or specific line edits rather than rewriting entire files.
- **No Placeholders**: Never use placeholder code. All implementations must be functional.

## 🛠 Coding Standards

- **WordPress Standards**: Follow WordPress Coding Standards for PHP. Use tabs for indentation in PHP and JS.
- **Singleton Pattern**: Core classes should use the `instance()` method for access.
- **AJAX Convention**: All AJAX handlers must include nonce checks and capability checks.
- **UI Design**: Maintain the "DazeStack" aesthetic—colorful, fluid, and performance-first.

## 📂 File Structure

- `bulk-plugin-manager.php`: Main entry point and constants definition.
- `includes/`: Core PHP logic classes.
  - `class-dsbpm-admin.php`: Handles UI rendering and AJAX logic (The Brain).
  - `class-dsbpm-skin.php`: Custom Upgrader Skin for silent background tasks.
- `assets/`: UI assets (CSS, JS, JS vendor files).
- `docs/`: Technical documentation and architecture overviews.

## 🔄 Workflow

1. Always verify syntax using `php -l` before finalizing changes.
2. Document major logic changes in `docs/ARCHITECTURE.md`.
3. Use descriptive but brief Git commit messages.