Backend AI Tooling

This project uses Laravel Boost to accelerate AI-assisted development.

Boost is part of the repository harness described in docs/ai-workflow.md. Keep framework-version guidance in Boost and Core-specific workflow guidance in repository docs and .ai/skills/.

Enabling Boost

To enable Boost in your local environment, run:

shell

docker compose exec -T core.web php artisan boost:install

Updating Guidelines

To ensure local AI guidelines reflect the latest versions of installed Laravel ecosystem packages, run:

shell

docker compose exec -T core.web php artisan boost:update

Custom AI Guidelines

Use custom guidelines for project-wide instructions and standards:

Create .blade.php or .md files in .ai/guidelines/.
Keep each file focused on one concern (for example: backend conventions, testing, or architecture context).
To override Boost's built-in guidance, create a custom guideline with a matching file path in .ai/guidelines/.

Use skills for reusable, task-oriented workflows:

Create skills under .ai/skills/<skill-name>/SKILL.md.
Use a skill when a task needs step-by-step execution (for example: processor onboarding, endpoint rollout, or migration playbooks).
Include clear triggers ("use this skill when..."), required inputs, and concrete implementation steps.
Keep skills narrowly scoped and reference shared guidelines instead of duplicating large policy blocks.

Agent Entry Points

AGENTS.md and CLAUDE.md are generated by Boost — do not edit them directly. All project-specific agent guidance belongs in .ai/guidelines/ and .ai/skills/.