PHPackages podtech/skill - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. podtech/skill ActiveLibrary[Framework](/categories/framework) podtech/skill ============= PodTech engineering conventions and AI skills for Laravel projects — backend, shadcn-vue frontend, database modeling, and RPI workflow. 01PHP Since Apr 20Pushed 1mo agoCompare [ Source](https://github.com/rafaelhlessa/podtech-skill)[ Packagist](https://packagist.org/packages/podtech/skill)[ RSS](/packages/podtech-skill/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependenciesVersions (1)Used By (0) podtech/skill ============= [](#podtechskill) Engineering conventions and AI skills for Laravel projects. Installs best practices as **a single source of truth** (`.ai/upstream/`) referenced by Cursor, GitHub Copilot, and Claude Code — so every tool reads the same rules. --- What's Included --------------- [](#whats-included) CategoryContent**Backend**Controller → Action → Resource architecture, N+1 prevention, eager loading, cache, jobs, security, PHPStan level 5**Frontend**shadcn-vue components, design system, TypeScript typing, all UI states, forms with vee-validate + zod**Database**Migrations with constraints, cascade rules, index strategy, data types for Brazilian documents**Exceptions**Domain exceptions, centralized HTTP translation**Testing**Pest strategy — unit for Actions, feature for endpoints**PHPDocs**Documentation conventions for AI-assisted development**RPI Workflow**Brainstorm → Research → Plan → Iterate → Implement → Investigate--- Installation ------------ [](#installation) ### Via Packagist (após publicar) [](#via-packagist-após-publicar) ``` composer require podtech/skill ``` ### Via repositório local (desenvolvimento / antes de publicar) [](#via-repositório-local-desenvolvimento--antes-de-publicar) No `composer.json` do seu projeto Laravel: ``` { "repositories": [ { "type": "path", "url": "../podtech-skill", "options": { "symlink": true } } ], "require": { "podtech/skill": "^1.0" } } ``` ``` composer require podtech/skill:^1.0 ``` ### Via repositório Git (antes do Packagist) [](#via-repositório-git-antes-do-packagist) ``` { "repositories": [ { "type": "vcs", "url": "https://github.com/podtech/skill" } ], "minimum-stability": "dev", "prefer-stable": true, "require": { "podtech/skill": "dev-main" } } ``` ``` composer require podtech/skill:dev-main ``` --- ### 1. Publish convention files [](#1-publish-convention-files) **API project (PHP only):** ``` php artisan vendor:publish --tag=podtech-api ``` **Inertia + shadcn-vue project:** ``` php artisan vendor:publish --tag=podtech-inertia ``` This creates: ``` .ai/ upstream/ ← package conventions (do not edit) conventions.md database.md exceptions.md phpdocs.md static-analysis.md testing.md crud.md (api only) resources.md (api only) components.md (inertia only) forms.md (inertia only) pages.md (inertia only) props.md (inertia only) local/ overrides.md ← your project-specific rules (edit freely) AGENTS.md ← global agent instructions ``` ### 2. Install IDE rules [](#2-install-ide-rules) **Cursor:** ``` # Interactive php artisan podtech:cursor # API project php artisan podtech:cursor --api # Inertia + shadcn-vue php artisan podtech:cursor --inertia # With RPI workflow php artisan podtech:cursor --inertia --rpi ``` **GitHub Copilot:** ``` php artisan podtech:copilot --api php artisan podtech:copilot --inertia ``` **Claude Code CLI:** ``` # All skills (project-scoped) php artisan podtech:claude # Specific skills php artisan podtech:claude --backend php artisan podtech:claude --frontend php artisan podtech:claude --database php artisan podtech:claude --rpi # Install globally (all projects) cp -r .claude/skills/* ~/.claude/skills/ ``` --- Project Structure After Setup ----------------------------- [](#project-structure-after-setup) ``` project/ ├── .ai/ │ ├── upstream/ ← DO NOT EDIT (managed by package) │ │ ├── conventions.md │ │ ├── database.md │ │ ├── exceptions.md │ │ └── ... │ └── local/ │ └── overrides.md ← EDIT HERE (your project rules) ├── .claude/ │ ├── skills/ ← Claude Code skills │ │ ├── backend-laravel/ │ │ ├── frontend-shadcn/ │ │ ├── database-modeling/ │ │ ├── brainstorm/ │ │ ├── research/ │ │ ├── plan/ │ │ ├── iterate/ │ │ ├── implement/ │ │ └── investigate/ │ └── agents/ ├── .cursor/ │ ├── rules/ │ │ ├── podtech.mdc ← convention rules │ │ └── rpi.mdc ← RPI workflow rule │ └── skills/ ← RPI skills for Cursor ├── .github/ │ └── copilot-instructions.md └── AGENTS.md ``` --- Project-Specific Rules ---------------------- [](#project-specific-rules) Edit `.ai/local/overrides.md` to override any upstream convention: ``` # Project Overrides ## This project uses Livewire instead of Inertia - Ignore all upstream Inertia conventions - Forms follow Livewire patterns (see app/Livewire/) ## Custom exception base class - Use App\Exceptions\AppException instead of DomainException ``` Local rules always have higher priority than upstream. --- RPI Workflow ------------ [](#rpi-workflow) For complex features, use the Research → Plan → Implement flow: SkillCursorClaude CodeWhenBrainstorm`/brainstorm``/brainstorm`Explore ideas before researchResearch`/research``/research`Deep technical investigationPlan`/plan``/plan`Atomic tasks before codingIterate`/iterate``/iterate`Adjust an existing planImplement`/implement``/implement`Execute the plan mechanicallyInvestigate`/investigate``/investigate`Diagnose bugsArtifacts are saved in `docs/rpi/`. --- Updating -------- [](#updating) ``` composer update podtech/skill php artisan vendor:publish --tag=podtech-api --force # or --tag=podtech-inertia php artisan podtech:claude --all --force php artisan podtech:cursor --inertia --rpi --force ``` --- Package Structure ----------------- [](#package-structure) ``` podtech/skill/ ├── composer.json ├── AGENTS.md ├── src/ │ ├── SkillServiceProvider.php │ └── Commands/ │ ├── CursorSetupCommand.php │ ├── CopilotSetupCommand.php │ └── ClaudeCodeSetupCommand.php └── resources/ ├── ai/ │ ├── shared/ conventions, database, exceptions, phpdocs, static-analysis, testing │ ├── api/ crud, resources │ ├── inertia/ components (shadcn-vue), forms, pages, props │ └── local/ overrides template ├── cursor/ │ ├── podtech-api.mdc │ ├── podtech-inertia.mdc │ ├── rpi.mdc │ └── skills/ brainstorm, research, plan, iterate, implement, investigate ├── claude/ │ ├── skills/ backend-laravel, frontend-shadcn, database-modeling + RPI │ └── agents/ detective, developer, world-detective, writer └── copilot/ ├── podtech-api.md └── podtech-inertia.md ``` ### Health Score 19 — LowBetter than 10% of packages Maintenance59 Moderate activity, may be stable Popularity1 Limited adoption so far Community6 Small or concentrated contributor base Maturity11 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/753c2ed23ae7d0647d895f7ac0cbf02b6d22216be3a0499b62a124b8adf1c9c1?d=identicon)[rafaelhlessa](/maintainers/rafaelhlessa) --- Top Contributors [![rafaelhlessa](https://avatars.githubusercontent.com/u/43303944?v=4)](https://github.com/rafaelhlessa "rafaelhlessa (2 commits)") ### Embed Badge ![Health badge](/badges/podtech-skill/health.svg) ``` [![Health](https://phpackages.com/badges/podtech-skill/health.svg)](https://phpackages.com/packages/podtech-skill) ``` ### Alternatives [laravel/socialite Laravel wrapper around OAuth 1 & OAuth 2 libraries. 5.7k104.3M822](/packages/laravel-socialite)[laravel/dusk Laravel Dusk provides simple end-to-end testing and browser automation. 1.9k38.6M289](/packages/laravel-dusk)[pinguo/php-msf Pinguo Micro Service Framework For PHP 1.7k4.2k](/packages/pinguo-php-msf)[nineinchnick/edatatables Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin 173.2k](/packages/nineinchnick-edatatables) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)