padosoft

Use when implementing the backend of a complex Laravel admin page (filters, KPI, lists, exports). Guides Request/DTO/service/controller/route layout, output contract design, and the minimum tests required. Trigger on tasks like "build admin index", "add filtered admin page", "write backend for admin dashboard".

Use BEFORE creating or refactoring any admin interface to audit existing UI components, services, and helpers and decide REUSE / EXTEND / CREATE-DOMAIN / CREATE-GLOBAL for each piece. Trigger when starting a new admin page, when asked to "check existing components first", or before any "create-admin-interface" run.

Use when implementing the JS/CSS frontend of a complex Laravel admin page (entrypoint, API client, filters, table, KPI/charts, modals, empty/loading/error states). Trigger on tasks like "wire admin page JS", "build admin filters", "render admin table", or anything touching frontend modules of an admin view.

Orchestrator skill for creating or refactoring a complex Laravel admin page (filters, KPIs, tables, exports, charts, modals). Drives the full sequence — component audit, contract definition, backend, frontend, hardening — and chains the related admin-interface-* skills. Trigger on requests like "create admin page", "build dashboard for X", or "refactor admin index for Y".

Use when adding or refactoring a Laravel 13 HTTP API endpoint. Drives the route → thin controller → FormRequest → DTO → service/action → JsonResource → feature test pipeline, with stable response shape and consistent status codes. Trigger on tasks like "add API endpoint", "expose X via API", or "create REST route".

Use when adding or refactoring a Laravel 13 controller (web, API, or admin). Drives thin-controller patterns — FormRequest validation, DTO/command objects, delegation to service/action, coherent view/resource/redirect responses, plus the minimum feature test. Trigger on tasks like "add controller for X", "refactor controller", "expose admin action".

Use when scaffolding a standard Laravel 13 CRUD backend (model+migration, FormRequest, resource controller or API endpoints, view/JSON wiring, full validation/create/update/delete tests). Trigger on tasks like "create CRUD for X", "scaffold resource for Y", "add admin CRUD module".

Use when introducing a new Laravel storage disk or file workflow (uploads, exports, generated artifacts like dossiers/PDFs). Centralizes disk config, path/naming rules, streaming for large files, visibility/retention/cleanup. Trigger on tasks like "add new disk", "store generated file", "manage uploads".

Anchor skill for the padosoft/laravel-flow-admin package. Read FIRST when opening this repo to understand stack (Laravel 13 + PHP 8.3/8.4 + Blade + Vite + Alpine.js + Playwright), where the design source lives (.design-source/), the read-model contract from padosoft/laravel-flow we consume, and the macro/subtask branch + Copilot review loop. Trigger when starting any work in this repo, when restarting a session, or when a sub-agent is dispatched.

BEFORE every `git push`, run a systematic self-review on the diff against a checklist of the recurring footguns Copilot has flagged in this codebase. The goal is to catch issues that would otherwise consume Copilot review cycles. Trigger BEFORE typing `git push`, after `git commit`, when about to open a PR with `gh pr create`, when running the local test gate, or when the user asks to "review my changes" / "lint diff" / "check diff".

Use to implement the backend slice of a complex Laravel admin page (controller, view-model factories, query layer with eager loading, FormRequest validation, action handlers gated by authorizer, pagination/sorting/filtering DTOs). Trigger when adding/modifying any controller under `src/Http/Controllers/` or `routes/flow-admin.php`, when wiring a new admin route, or when working on a Macro 5/6/7 backend slice per `docs/IMPLEMENTATION_PLAN.md`.

Use BEFORE building or refactoring any admin page to inventory existing Blade components, partials, design tokens, and reusable Alpine stores so the new work composes existing primitives instead of duplicating them. Trigger at the start of every Macro 3/5/6/7 UI slice, before adding a new Blade component, or when Copilot flags duplication during review.

Use to implement the frontend slice of a complex Laravel admin page using Blade + Vite + Alpine.js (no SPA framework). Covers Blade partials/components, Alpine stores for client state, design-token CSS hygiene, status badges, JSON syntax-highlight, sparklines, charts, drawer, modal, ⌘K palette interactions. Trigger when adding/modifying templates under `resources/views/`, CSS under `resources/css/`, or JS under `resources/js/`, and when implementing a Macro 3/5/6/7/8 UI slice per `docs/IMPLEMENTATION_PLAN.md`.

Orchestrator skill for creating or refactoring complex Laravel admin pages with KPI tiles, filters, tables, drawers, modals, charts, exports. Coordinates the audit → backend → frontend → test phases by dispatching to `admin-interface-component-audit`, `admin-interface-backend`, `admin-interface-frontend`, and `playwright-enterprise-tester`. Trigger when user asks to "build an admin page", "add a dashboard view", "refactor the admin shell", or when starting any Macro 5/6/7 page implementation in `docs/IMPLEMENTATION_PLAN.md`.

Use when creating a JSON endpoint under `/flow/api/*` (e.g. `/flow/api/search`, `/flow/api/live`) backing the admin UI. Covers route registration, FormRequest validation, JSON resource shape, authorizer gating, CSRF or session-based auth (no Sanctum tokens for browser-held UI), pagination contract, and Feature test coverage. Trigger when adding/modifying any AJAX or polling endpoint in `routes/flow-admin.php`.

Use to introduce a new Laravel controller in this package following the FormRequest → DTO → Service → ViewModel → Blade pipeline. Covers route registration in `routes/flow-admin.php`, view namespace usage (`flow-admin::`), CSRF on POST forms, authorizer gating for mutations, and Feature test coverage via Testbench. Trigger when adding/modifying any class under `src/Http/Controllers/`.

Maintain the public docmd documentation site in docs-site.

BEFORE every `git push`, when you have added or removed unit / feature / assertion code in this commit, run the local test suite and reconcile every test-count / assertion-count claim across README.md, the PR description, sample-output blocks, comparison tables, roadmap rows, and inline narrative. Trigger when the commit modifies any `tests/**` file, when you've added or removed an `assert*()` call, when README.md still mentions a previous run's count, or when about to open a PR that touches test files.

BEFORE every `git push`, run a systematic self-review on the diff against a checklist of the recurring footguns Copilot has flagged in this codebase. The goal is to catch issues that would otherwise consume Copilot review cycles. Trigger BEFORE typing `git push`, after `git commit`, when about to open a PR with `gh pr create`, when running the local test gate, or when the user asks to "review my changes" / "lint diff" / "check diff".

After EVERY commit-push-PR cycle, the agent MUST loop on Copilot review + CI status until ALL Copilot comments resolved AND ALL CI checks green. NEVER stop after a single push. Trigger when opening a PR with `gh pr create`, after `git push` to a PR branch, or when user asks to "fix PR" / "address review" / "make CI green". Applies to ALL repos lopadova/* and padosoft/*. The loop is mandatory for current and future sessions and for any developer working on this codebase.

Leggi, classifica e indirizza review comments di una pull request in modo sistematico.

BEFORE every push of a task/subtask branch, run a LOCAL GitHub Copilot CLI review loop on the FULL branch diff vs origin/main and iterate until zero actionable findings. Trigger before `git push`, before `gh pr create`, after completing a subtask implementation, or when the user asks for "local review" / "review locale" / "copilot locale". Complements (never replaces) copilot-pr-review-loop, which handles the PR-level review after push.

Use when working on padosoft/laravel-flow enterprise roadmap tasks, including persistence, queue/replay, approval gates, webhook outbox, companion dashboard contracts, API stability, release docs, or any restart after context loss.

Create and maintain the docmd documentation site for laravel-flow.

BEFORE every `git push`, run a systematic self-review on the diff against a checklist of the recurring footguns Copilot has flagged in this codebase. The goal is to catch issues that would otherwise consume Copilot review cycles. Trigger BEFORE typing `git push`, after `git commit`, when about to open a PR with `gh pr create`, when running the local test gate, or when the user asks to "review my changes" / "lint diff" / "check diff".

After EVERY commit-push-PR cycle, the agent MUST loop on Copilot review + CI status until ALL Copilot comments resolved AND ALL CI checks green. NEVER stop after a single push. Trigger when opening a PR with `gh pr create`, after `git push` to a PR branch, or when user asks to "fix PR" / "address review" / "make CI green". Applies to ALL repos lopadova/* and padosoft/*. The loop is mandatory for current and future sessions and for any developer working on this codebase.

Use whenever working in docs-site/, adding or editing public documentation pages, changing docmd navigation, plugins, semantic search, branding, Cloudflare Pages deployment, or keeping docs synchronized with user-facing package features.

Resume and enforce the implementation process for the padosoft/laravel-evidence-risk-review Laravel package.

Continue or resume the padosoft/laravel-evidence-risk-review package implementation. Use when working in this repo, when context was compacted or lost, or when enforcing the branch, PR, Copilot review, documentation, testing, Laravel package, standalone-agnostic, default-OFF, and release rules.

Use ChatGPT Codex Connector as the automatic PR review fallback when GitHub Copilot Code Review is blocked by quota, budget, access, or prolonged non-response.

Run the mandatory GitHub Copilot Code Review and CI loop for PRs in this repository. Use after opening a PR, after pushing to a PR branch, when requesting a Copilot re-review, or when fixing PR review/CI feedback.

Resume or enforce the padosoft/laravel-evidence-risk-review-admin implementation plan.

Continue or resume the padosoft/laravel-evidence-risk-review-admin package implementation. Use when working in this repo, when context was compacted or lost, or when enforcing branch, PR, testing, frontend, Laravel package, standalone-agnostic, and release rules.

Use ChatGPT Codex Connector as the automatic PR review fallback when GitHub Copilot Code Review is blocked by quota, budget, access, or prolonged non-response.

Run the GitHub Copilot Code Review and CI loop when the final deep review is required or when the temporary per-W review override is removed.

Use when working inside docs-site/ — authoring or editing documentation pages, adding/reordering sidebar navigation, touching docmd plugins (search/git/seo/sitemap/mermaid/math/llms), or keeping the docs in sync with package features. Covers docmd syntax, semantic search, build/verify, and the Cloudflare Pages deploy.

Use when closing any sub-task/PR in this repo — runs the local Copilot review gate, then the GitHub PR + Copilot reviewer + CI loop until green.

Use when implementing any task in this Laravel package — the strict TDD + both-states + append-only + compose-not-couple cadence the plan mandates.

Use when working in docs-site/, adding Laravel Rebel ecosystem docs, changing docmd navigation/plugins/search, or keeping package README links in sync with centralized documentation.

Use when adding or changing code in any padosoft/laravel-rebel-* package — encodes the suite's TDD loop, PHPStan-max recipes, security/telemetry rules, and the branch→PR→CI→tag/release Definition of Done.

Keep the docmd documentation site synchronized with product_image_discovery source, README, API routes, commands, and configuration.

Use when working on the padosoft/product-image-discovery Laravel package, including product image discovery, matching, scoring, queue jobs, API endpoints, search providers, trusted source logic, anti-false-positive checks, image quality rules, optional sidecar behavior, tests, docs, installation instructions, and release readiness.

Author, build, and maintain the docmd documentation site in docs-site/. Use when editing docs-site/, adding or updating documentation pages, changing the sidebar/navigation, configuring docmd plugins, re-running the Mintlify→docmd migration, or keeping the docs in sync with new/changed features (see rule-docmd-docs-sync). Covers the exact docmd container syntax, the FontAwesome→Lucide icon mapping, plugin config, the build/verify commands, and the gotchas hit during the original migration.

Continue or resume padosoft/eval-harness implementation. Use when working in this Laravel package, following the roadmap, enforcing Laravel 12+/PHP 8.3+ support, Horizon-ready queue design with sync tests, headless report APIs for a separate UI package, branch/PR/Copilot review loops, and progress/lesson documentation.

Author and maintain the public documentation site for laravel-iam-ai, built with docmd and living in docs-site/. Use this skill whenever you work inside docs-site/, add or edit a docs page, touch navigation/plugins in docmd.config.json, change the search/build tooling, or keep the docs in sync with a user-facing feature change. Covers the layout, the dev/build/check commands, the container syntax, Lucide icons, semantic search, branding, Cloudflare Pages deploy, the page-structure standard and the gotchas.

Use when implementing ANY task in this Laravel IAM package repo. Enforces the branch/PR/test/advisory-review loop, Herd PHP 8.5 testing, the Pest+PHPStan-max+Pint gate, and LESSON.md/README upkeep. Trigger on building, coding, testing, reviewing, or releasing this package.

Use when creating or maintaining the docmd static documentation site under docs-site.

Use when working on the laravel-ai-finops package (or its admin) to follow the mandatory branch/PR/Definition-of-Done/Copilot-loop workflow and resume from the correct point.