Skill: /create-pr

Usage

/create-pr "{task_description}"

Prerequisites

• All changes must be committed (Step 5 completed)
• Branch must not already have an open PR

Steps

1. Pre-flight Check

git status          # must be clean (nothing to commit)
git log main..HEAD  # show commits to be included in PR

If working tree is dirty, stop and report:

🚧 STOP: Uncommitted changes detected. Run /git-commit first.

2. Push to Remote

git push -u origin $(git branch --show-current)

Confirm:

✅  Pushed to origin/{branch-name}

3. Generate PR Description

Compose the full PR using this template. Fill every section with real content — do NOT leave any section as a placeholder.

PR Title: {type}({domain}): {imperative description} (≤ 72 chars)

## Summary

One paragraph explaining what this PR does and the business reason for it.

## Changes

A clear list of every changed file and what changed, grouped by layer:

Backend (Laravel)

• app/Services/ProductFilterService.php — new service for product filtering
• app/Http/Controllers/ProductController.php — inject filter service, update index()

Frontend (React)

• src/hooks/useProductFilter.ts — new React Query hook wrapping filter API
• src/components/ProductFilter/ProductFilter.tsx — new filter UI component

Database

• database/migrations/..._add_category_id_to_products.php — adds category_id FK

Docs / Reference

• references/backend_map.md — updated with ProductFilterService
• references/frontend_map.md — updated with useProductFilter hook

## How to Test

Step-by-step instructions for a reviewer to manually verify the change:

1. php artisan migrate to run the new migration
2. Navigate to /products → filter panel should appear in the sidebar
3. Select a category → list should update without page reload
4. Clear filter → all products should reappear
5. Check php artisan test --filter ProductFilterTest — should be green

## Screenshots (UI changes only)

## Checklist

• Tests pass (php artisan test / pnpm test)
• Lint passes (no errors)
• Reference files updated (references/*.md)
• No .env values committed
• No debug code (dd(), console.log) left in

4. Open the PR

Use GitHub CLI if available:

gh pr create \
  --title "{PR title}" \
  --body "{PR body}" \
  --base main \
  --head $(git branch --show-current)

If gh is not available, output the PR body for manual submission and provide the GitHub URL for the branch:

🔗 Manual PR creation required.
   Branch URL: https://github.com/{org}/{repo}/compare/{branch-name}
   Copy the PR body above.

5. Confirm

──────────────────────────────────────────────────────────────
  PULL REQUEST CREATED
──────────────────────────────────────────────────────────────
PR URL    : {url}
Title     : {title}
Base      : main
Head      : {branch}
Commits   : {count}

Next step: /test-lint {technology}
──────────────────────────────────────────────────────────────