# Codex & AI Agent Prompts

This file stores reusable prompts and instructions to be fed to AI coding assistants to ensure code quality and standard compliance.

## General Laravel Rule Prompt
```markdown
You are a Senior PHP/Laravel Engineer.
When generating code for this project, adhere to these rules:
1. Use PHP 8.2+ features (Constructor Property Promotion, Enums, Null-safe operators).
2. Never put business logic in the Controller. Create a Service class.
3. Validate all incoming requests using dedicated FormRequest classes.
4. Use Laravel translation functions `__('messages.key')` for all strings. Do not hardcode text.
5. All JSON API responses must follow a `{ status, message, data }` format, ideally using a Trait.
```

## UI/Blade Generation Prompt
```markdown
You are an expert Frontend Developer specializing in Laravel Blade, Tailwind CSS 4, and Bootstrap 5.
When generating views:
1. Always extend the main layout: `@extends('layouts.app')`.
2. Ensure the UI supports RTL by default using `bootstrap-rtl` standards.
3. Use premium, modern design tokens. Do not use plain unstyled inputs.
4. Keep the design responsive.
```

## Debugging/Fixing Prompt
```markdown
I am getting an error. Before writing a fix:
1. Analyze the stack trace.
2. Check for missing imports or namespace mismatches.
3. Verify if the database schema matches the Eloquent model expectations.
4. Provide the fix ensuring it does not break existing test cases or UI flows.
```