PHPackages blamodex/laravel-ai-agents - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Testing & Quality](/categories/testing) 4. / 5. blamodex/laravel-ai-agents ActiveLibrary[Testing & Quality](/categories/testing) blamodex/laravel-ai-agents ========================== Markdown-based agent manuals for using LLMs as structured dev assistants in Laravel and React projects v1.0.2(5mo ago)1933MIT Since Nov 29Pushed 3mo agoCompare [ Source](https://github.com/blamodex/laravel-ai-agents)[ Packagist](https://packagist.org/packages/blamodex/laravel-ai-agents)[ Docs](https://github.com/blamodex/laravel-ai-agents)[ RSS](/packages/blamodex-laravel-ai-agents/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (5)Used By (3) Blamodex Dev Agents =================== [](#blamodex-dev-agents) [![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)[![Laravel](https://camo.githubusercontent.com/49180e08c9d2bf7321e8c7b5e2e6d04688dfe7dc215442c6e87bb62a1943800c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322d7265642e737667)](https://laravel.com)[![Packagist](https://camo.githubusercontent.com/4e218e7712f6d1fb521aa6d6f74e96a032f3ac99f2214948ead49809fee2f83a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5061636b61676973742d52656164792d626c75652e737667)](https://packagist.org/) A set of Markdown-based "agent manuals" for using LLMs (like Claude Code, GitHub Copilot, or ChatGPT) as structured development assistants. These agents provide a systematic workflow for building, testing, debugging, and maintaining code with AI assistance. 🎯 Designed For -------------- [](#-designed-for) - **Laravel 12** (PHP 8.2+) - **React / TypeScript** (Vite) - **PSR-12** coding standards - **Test-first / test-friendly** workflows 📦 Installation -------------- [](#-installation) ### Option 1: Composer (Recommended) [](#option-1-composer-recommended) ``` composer require --dev blamodex/laravel-ai-agents ``` **Optional: Create a symlink to access agents from your project root** ``` ln -s vendor/blamodex/laravel-ai-agents/agents agents ``` This allows you to reference agents as `/agents/DevAgent.md` instead of `/vendor/blamodex/laravel-ai-agents/agents/DevAgent.md`. ### Option 2: Manual Installation [](#option-2-manual-installation) Copy the `agents/` folder into the root of your project: ``` mkdir -p agents cp -r vendor/blamodex/laravel-ai-agents/agents/* ./agents/ ``` ### Option 3: Git Submodule [](#option-3-git-submodule) ``` git submodule add https://github.com/blamodex/laravel-ai-agents.git agents ``` Included Agents --------------- [](#included-agents) All agent definitions live under `./agents/`: - `DevAgent.md` – multi-file feature and refactor agent - `BugAgent.md` – diagnostic and debugging agent - `TestAgent.md` – test design and generation agent - `CleanupAgent.md` – non-behavioral cleanup and documentation agent - `WORKFLOW.md` – how to combine them in a Request → Agent → Test → Refine loop How to Use (Claude Code / VS Code) ---------------------------------- [](#how-to-use-claude-code--vs-code) 1. **Install the package** (see Installation above) 2. **Reference agents in your prompts**: ``` Use DevAgent. Follow the instructions in /agents/DevAgent.md. Goal: Implement rate limiting on all /api/* routes in a safe, incremental way. ``` 3. **Follow the workflow** in `agents/WORKFLOW.md`: - Start with **DevAgent** (plan + first step) - Use **TestAgent** to generate tests if needed - Use **BugAgent** when tests fail or errors appear - Use **CleanupAgent** at the end for polish and documentation 📚 Documentation --------------- [](#-documentation) - **[Workflow Guide](agents/WORKFLOW.md)** - Complete agent workflow loop - **[Laravel Usage Examples](examples/laravel-usage.md)** - Concrete Laravel examples - **[React Usage Examples](examples/react-usage.md)** - React + TypeScript examples - **[Contributing](CONTRIBUTING.md)** - How to contribute - **[Changelog](CHANGELOG.md)** - Version history Recommended Project Conventions ------------------------------- [](#recommended-project-conventions) These agents assume (and work best with): - Laravel: - Feature tests in `tests/Feature` - Unit tests in `tests/Unit` - Prefer factories and seeders over ad-hoc model creation - Frontend: - React + TypeScript under something like `resources/js` - Jest + React Testing Library for component tests - Tooling: - Composer scripts such as: ``` composer test composer test:coverage composer lint composer lint:fix composer analyze ``` You can adapt the Markdown files to match your own project conventions. Customizing ----------- [](#customizing) Feel free to fork or copy these agent files and customize them for your project: - Adjust command names (`composer test` → `npm test`, etc.) - Modify directory structure expectations - Add project-specific conventions - Create new specialized agents (DeployAgent, DocAgent, etc.) 🤝 Contributing -------------- [](#-contributing) Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details. 📄 License --------- [](#-license) MIT License - see [LICENSE](LICENSE) for details. 🙏 Acknowledgments ----------------- [](#-acknowledgments) Built for teams using AI-assisted development workflows with tools like: - [Claude Code (Anthropic)](https://www.anthropic.com/) - [GitHub Copilot](https://github.com/features/copilot) - [ChatGPT](https://openai.com/chatgpt) 🔗 Links ------- [](#-links) - [Report a Bug](https://github.com/blamodex/laravel-ai-agents/issues) - [Request a Feature](https://github.com/blamodex/laravel-ai-agents/issues) - [View Changelog](CHANGELOG.md) ### Health Score 36 — LowBetter than 82% of packages Maintenance75 Regular maintenance activity Popularity14 Limited adoption so far Community10 Small or concentrated contributor base Maturity38 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 3 Last Release 164d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/4f55d38385fa6cea42e03e9f4d95bbb789c6c0492de1e386b60e5f2836c96d5d?d=identicon)[blamodex](/maintainers/blamodex) --- Top Contributors [![blackmage-codex](https://avatars.githubusercontent.com/u/218423009?v=4)](https://github.com/blackmage-codex "blackmage-codex (10 commits)") --- Tags testinglaravelaiworkflowdevelopmentagentsclaudellm ### Embed Badge ![Health badge](/badges/blamodex-laravel-ai-agents/health.svg) ``` [![Health](https://phpackages.com/badges/blamodex-laravel-ai-agents/health.svg)](https://phpackages.com/packages/blamodex-laravel-ai-agents) ``` ### Alternatives [vizra/vizra-adk Vizra Agent Development Kit - A comprehensive Laravel package for building intelligent AI agents. 29026.1k](/packages/vizra-vizra-adk)[mischasigtermans/laravel-altitude Claude Code agents for the TALL stack, powered by Laravel Boost 1139.2k](/packages/mischasigtermans-laravel-altitude)[sbsaga/toon 🧠 TOON for Laravel — a compact, human-readable, and token-efficient data format for AI prompts & LLM contexts. Perfect for ChatGPT, Gemini, Claude, Mistral, and OpenAI integrations (JSON ⇄ TOON). 6115.6k](/packages/sbsaga-toon)[claude-php/claude-php-sdk-laravel Laravel integration for the Claude PHP SDK - Anthropic Claude API 5010.8k](/packages/claude-php-claude-php-sdk-laravel)[cboxdk/statamic-mcp MCP (Model Context Protocol) server for Statamic CMS v6 — gives AI assistants structured access to content, blueprints, assets, and more. 225.6k](/packages/cboxdk-statamic-mcp) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)