iambateman / speedrun
A Claude Code powered tool for Laravel apps to build features by typing /feature.
Requires
- php: ^8.2
- doctrine/dbal: ^3.6|^4
- illuminate/contracts: ^11|^12
- laravel/prompts: ^0.3
- spatie/laravel-package-tools: ^1.14.0
- symfony/yaml: ^6.0|^7.0
Requires (Dev)
- larastan/larastan: ^2.0.1
- laravel/pint: ^1.0
- nunomaduro/collision: ^8.4
- orchestra/testbench: ^9|^10
- pestphp/pest: ^3.0
- pestphp/pest-plugin-arch: ^3.0
- pestphp/pest-plugin-laravel: ^3.0
README
Speedrun helps Laravel developers use Claude Code to generate new features or update existing features inside a Laravel project.
Installation
composer require iambateman/speedrun php artisan speedrun:install
Alpha warning
This is alpha work which is actively being adjusted. Right now, it feels a little slower than it should...like the subagents are doing more work than I want them to do. Use at your own risk.
Usage
- In terminal, type
claude
to open Claude Code. - type
/feature
with a description of the feature you want to make.
How it works
Claude often fails to implement entire code files and instead "stubs out" code. It also tends to make too many changes inside a project. This package creates a workflow for Claude to keep the developer in the "driver's seat" and reduce the time spent fixing broken code.
This framework is adapted from Anthropic's best practices for working with agents.
- START: Call
/feature
inside of Claude Code to create a new feature folder. - DISCOVER: Claude asks the developer to write what they know about the feature. Then, Claude will do it's own discovery.
- PLAN: Claude will create working documents inside the feature folder with sample code which will eventually go into the app. This is a "staging" setup, which gives the dev an opportunity to scan through all changes in one place.
- EXECUTE: Claude will use the plan to incorporate the feature into the app.
- CLEAN: Claude will offer to delete the feature folder so we don't have sample code lying around.
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Speedrun: iambateman
- All Contributors
License
The MIT License (MIT). Please see License File for more information.