Skip to content

Initial release

Choose a tag to compare

@jpcaparas jpcaparas released this 03 Nov 22:40
· 10 commits to main since this release

v0.1.0 (2025-11-03)

First public release of Laravel Superpowers — a Laravel‑focused skills library for Claude Code. It brings proven workflows (TDD, debugging, planning) together with Laravel‑aware guidance that stays platform‑agnostic (works with or without Sail).

Highlights

  • Plugin identity and marketplace metadata for the Laravel fork

    • Renamed plugin to superpowers-laravel and pointed metadata to jpcaparas/superpowers-laravel
    • Added local marketplace entry to simplify install during development
  • Laravel‑aware SessionStart

    • Startup hook auto‑detects Laravel projects (via artisan or composer.json with laravel/framework)
    • Injects a concise “Using Superpowers in Laravel Projects” introduction when Laravel is detected
  • New Laravel skills (all Sail/non‑Sail compatible)

    • Onboarding & Runner (using‑laravel‑superpowers, runner‑selection)
    • Development & Testing (tdd‑with‑pest, migrations‑and‑factories)
    • Quality & Operations (quality‑checks, queues‑and‑horizon)
    • Architecture & Complexity (ports‑and‑adapters, template‑method‑and‑plugins, complexity‑guardrails)
  • Optional skills (scaffolding for growing teams)

    • Nova resource patterns; Horizon dashboards/metrics; E2E Playwright patterns
    • API surface evolution; Config/Env storage strategy
  • Key commands (plugin‑namespaced)

    • /superpowers-laravel:brainstorm, /superpowers-laravel:write-plan, /superpowers-laravel:execute-plan
    • /superpowers-laravel:laravel-check, /superpowers-laravel:laravel-tdd
  • Documentation

    • Updated README for Laravel‑first usage (now includes repo logo)
    • Added Related Tools note for Laravel Boost (complementary if installed)
    • New integration guide: docs/laravel/INTEGRATION.md
    • New installation notes (version‑agnostic): docs/laravel/INSTALLATION-NOTES.md

Files

  • Hook: hooks/session-start.sh (Laravel detection + onboarding)
  • Skills live under skills/; commands under commands/
  • Docs: docs/laravel/INTEGRATION.md, docs/laravel/INSTALLATION-NOTES.md

New skills inspired by Clean Coders Guide

  • Controller cleanup; performance (eager loading, select columns, caching); dependency trimming
  • Helpers; interfaces + DI; strategy; controller testing

Commands

  • Examples provided for core flows and a few advanced skills; run /help to see everything available in your environment.

Maintenance

  • Moved Laravel skills from skills/laravel/** to first‑party skills/**
  • Removed empty directories after consolidation
  • Cleaned references in README and docs to reflect new locations and command namespace
  • Added CI validation for skills structure and plugin conventions: .github/workflows/validate-skills.yml

Notes

  • All skills intentionally include Sail/non‑Sail command pairs to avoid platform lock‑in.
  • Insights is treated as optional; Pint and static analysis (PHPStan/Psalm) are encouraged as baselines.