create-harness-superpower

Scaffold Laravel 12 projects with AI agent harness engineering — Superpowers workflow, Cursor/Claude rules, Pest/Pint/PHPStan, Playwright, and MCP.

Prerequisites

• Node.js 18+
• PHP 8.3+
• Composer
• Superpowers plugin (Cursor or Claude Code)

Install

npx create-harness-superpower my-app

Or inject harness into an existing Laravel 12 project:

cd my-existing-laravel-app
npx harness-superpower init

Commands

| Command | Description | |---------|-------------| | npx create-harness-superpower [name] | New Laravel 12 + harness (default if no subcommand) | | npx create-harness-superpower create [name] | Same as above | | npx harness-superpower init | Inject harness into current directory |

Flags

• --yes — skip prompts (defaults: both platforms)
• --cursor-only / --claude-only — single platform overlay
• --force (init only) — overwrite harness files with backup, no prompts

What gets scaffolded

• Agent config: AGENTS.md, .cursor/rules/, .claude/rules/, CLAUDE.md
• Docs: docs/function-list.md, docs/handoffs/, docs/superpowers/
• Toolchain: Pest, Pint, PHPStan (Larastan), Playwright (e2e/)
• Artisan: harness:verify, harness:sync-docs
• MCP: laravel-harness server (laravel-best-practices, module-map)
• CI: GitHub Actions (composer check)

After install

cp .env.example .env && php artisan key:generate
composer check
composer harness:verify --docs   # optional

Development

npm install
npm test
npm run fetch-best-practices     # refresh vendored laravel-best-practices.md

Docs

• Design spec
• Implementation plan

License

MIT