# AGENTS.md

## Project Name
CourtKulture

## Goal
Build an original pickleball open-play queue and court rotation web app.

This app is inspired only by the general idea of pickleball queue/court rotation apps. Do not copy PickleQ.app branding, UI, source code, exact text, logo, color scheme, screenshots, or proprietary implementation.

## Tech Stack
- Laravel 12
- PHP 8.2+
- MySQL or MariaDB
- Blade templates
- Bootstrap 5
- Vite
- Laravel Breeze authentication
- Eloquent ORM
- Form Requests
- Policies/Gates
- Service classes
- PHPUnit or Pest tests

## Superpowers Rule
Before planning, coding, debugging, or reviewing, use the installed Superpowers plugin.

Use Superpowers for:
- Understanding the task
- Planning before coding
- Breaking work into phases
- Test-driven or verification workflow
- Debugging
- Code review
- Security review

Do not code before planning.
Do not make unrelated changes.
Do not add unnecessary dependencies without approval.

## Coding Rules
- Use Laravel conventions.
- Keep controllers thin.
- Put business logic in service classes.
- Use Form Request validation.
- Use database transactions for queue and match logic.
- Add tests for important logic.
- Do not hardcode secrets.
- Mobile-first UI.
- Keep MVP simple.

## Main Features
- Open-play sessions
- Courts
- Players
- Queue
- Match generation
- Match result recording
- Public live session view
- Staff dashboard
- Player standings