Eolica Agent Kit

This package provides Eolica-Web's standard AI Agent configuration, including specialized Agents (like the Database Architect and Livewire Expert), Global Rules, Workflows, and Skills.

It's designed to be scaffolded into any Laravel or frontend repository you are working on to standardize code outputs generated by AI assistants.

Installation

To initialize the agent components in your project, run:

npx eolica-agent-kit

This command will copy the .agent folder into the root of your current project.

💡 Git and IDE Configuration

Make sure the .agent directory is NOT added to .gitignore if you want developers using tools like Cursor, Windsurf, or generic Copilots to share the same behavior. Committing these files ensures the whole team benefits from the same rules.

What is included?

Specialized Agents (.agent/agents/)

• livewire-expert: Master of anonymous components, Blade UI, and Tailwind CSS v4.
• filament-expert: Rapidly builds internal admin panels using Filament PHP v5.
• database-architect: Focuses on Eloquent, migrations, and schema design.
• code-reviewer: Ready to enforce standards and security checks.
• qa-engineer: Writes unbreakable Pest tests with Mockery.
• laravel-backend-engineer: Core architecture, routing, queues, and service container expert.

Global Rules (.agent/rules/)

• EOLICA_WEB.md: Enforces strict types, specific PHP versions, Livewire rules over traditional React/Vue, and standard architecture.

Workflows (.agent/workflows/)

Slash commands automation!

• /make-feature: Scaffolds everything needed for a fresh Livewire/Blade component logic block.
• /deploy: Pre-flight formatter, static analysis, and Pest runner.
• /extract-translations: Automatically extract strings into Laravel's language files.

Educational Skills (.agent/skills/)

Rules on:

• Laravel Architecture
• Tailwind Design (v4 setup without tailwind.config.js)
• PHP Testing Stack (Pest + Mockery)
• PHP Coding Standard (ECS)
• API Integrations (PSR standards setup)
• Pest Architecture Testing (arch() enforcement)
• Domain-Driven Actions (DDD, CQRS, DTOs)