@kennethsolomon/shipkit 3.18.0 → 3.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kennethsolomon/shipkit",
-  "version": "3.18.0",
+  "version": "3.19.0",
   "description": "A structured workflow toolkit for Claude Code.",
   "keywords": [
     "claude",

package/skills/sk:laravel-deploy/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: sk:laravel-deploy
+description: "Deploy a Laravel application to Laravel Cloud via the `cloud` CLI. Requires /sk:gates to pass before deploying."
+---
+
+# /sk:laravel-deploy
+
+Deploy the current Laravel application to Laravel Cloud.
+
+## Pre-Deploy Gate Check
+
+**Gates must pass before any deploy.** If `/sk:gates` has not been run since the last code change, run it first:
+
+```
+/sk:gates
+```
+
+All quality checks (lint, tests, security, review) must be green before deploying to any environment.
+
+## Setup (First Time)
+
+Install the Laravel Cloud CLI if missing:
+```bash
+composer global require laravel/cloud-cli
+```
+
+Authenticate:
+```bash
+cloud auth -n
+```
+
+## CLI Rules
+
+Never hardcode command signatures — always run `cloud <command> -h` to discover options at runtime.
+
+| Operation | Flags |
+|-----------|-------|
+| Read | `--json -n` |
+| Create | `--json -n` |
+| Update | `--json -n --force` |
+| Delete | `-n --force` (no `--json`) |
+| Deploy | `-n` with all options explicitly |
+
+## Deployment Workflow
+
+### First Deploy
+```bash
+cloud ship -n
+```
+
+### Existing App
+```bash
+cloud repo:config
+cloud deploy {app} {env} -n --open
+cloud deploy:monitor -n
+```
+
+### Environment Variables
+```bash
+cloud environment:variables -n --force
+```
+
+### Infrastructure
+
+**Database:**
+```bash
+cloud database-cluster:create --json -n
+cloud database:create --json -n
+```
+
+**Cache:**
+```bash
+cloud cache:create --json -n
+```
+
+**Custom Domain:**
+```bash
+cloud domain:create --json -n
+cloud domain:verify -n
+```
+
+## Sub-Agent Delegation
+
+Delegate to background agents (non-blocking):
+- `deploy:monitor` — watch deployment progress
+- `deployment:get` — fetch deployment status
+- `resource:list` — list infrastructure resources
+
+Keep in main context:
+- `cloud deploy` (need deployment ID immediately)
+- Short status commands
+
+## Troubleshooting
+
+Inspect current infrastructure state:
+```bash
+cloud <resource>:list --json -n
+```
+
+Check deployment logs:
+```bash
+cloud deployment:get {id} --json -n
+```
+
+## Official Plugin
+
+For richer guidance with checklists for complex multi-step infrastructure operations, install the official plugin:
+```
+/plugin install laravel-cloud@laravel
+```
+
+Docs: https://cloud.laravel.com/docs

package/skills/sk:laravel-init/SKILL.md

@@ -32,6 +32,24 @@ Behavior depends on who owns the file:
 - **Generated** (has `<!-- Generated by /laravel-init -->` marker): safe to edit directly with section-level updates using `<!-- BEGIN/END -->` markers
 - **User-owned** (no marker): never edit — create `CLAUDE-sub-agents.md` alongside it and let the user copy what they want
 
+## Optional: Official Laravel Plugins
+
+After setup completes, suggest the two official Laravel plugins from Taylor Otwell:
+
+> "Install official Laravel plugins? (`laravel-simplifier` for code refinement + `laravel-cloud` for deployments) [y/n]"
+
+If yes, install each:
+```bash
+/plugin install laravel-simplifier@laravel
+/plugin install laravel-cloud@laravel
+```
+
+**What each adds:**
+- `laravel-simplifier` — an Opus-powered agent that reviews recently modified PHP/Laravel code and refines it for PSR-12 compliance, Laravel conventions, and readability without changing behavior. Invoke after `/sk:execute-plan`: "Review recent changes using the laravel-simplifier agent"
+- `laravel-cloud` — guides deployment and infrastructure management on Laravel Cloud via the `cloud` CLI. Triggers automatically when you ask about deploying. Or use `/sk:laravel-deploy` for a gate-enforced deploy workflow.
+
+If no, skip — plugins can be installed manually at any time.
+
 ## After Running
 
 Start with `/sk:brainstorm` to plan your feature.

package/skills/sk:setup-claude/SKILL.md

@@ -176,6 +176,24 @@ composer require --dev pestphp/pest pestphp/pest-plugin-laravel
 ./vendor/bin/pest --init
 ```
 
+### Laravel Official Plugins
+
+After tool installation, suggest the two official Laravel plugins from Taylor Otwell:
+
+> "Install official Laravel plugins? (`laravel-simplifier` for PHP code refinement + `laravel-cloud` for deployments) [y/n]"
+
+If yes, install each — skip any already configured:
+```bash
+/plugin install laravel-simplifier@laravel
+/plugin install laravel-cloud@laravel
+```
+
+**What each adds:**
+- `laravel-simplifier` — an Opus-powered agent that reviews recently modified PHP/Laravel code and refines it for PSR-12 compliance, Laravel conventions, and readability without changing behavior. Invoke after `/sk:execute-plan`: "Review recent changes using the laravel-simplifier agent"
+- `laravel-cloud` — guides deployment and infrastructure management on Laravel Cloud via the `cloud` CLI. Triggers automatically when you ask about deploying. Also available via `/sk:laravel-deploy` for a gate-enforced workflow.
+
+If no, skip — plugins can be installed manually at any time.
+
 ### Config Publishing (create-if-missing only)
 
 **`phpstan.neon`:**
@@ -254,6 +272,23 @@ Use Agent tool with subagent_type="Explore" — launch all in a single message:
   - Agent 3: Explore test patterns and existing test coverage for the area
 ```
 
+### Code Refinement (after /sk:execute-plan)
+
+After implementing code, run the `laravel-simplifier` agent to refine recently modified PHP/Laravel code:
+
+```
+Invoke the laravel-simplifier agent:
+"Review recent changes using the laravel-simplifier agent"
+```
+
+This agent (Opus-powered, official from Taylor Otwell):
+- Applies PSR-12 standards and Laravel conventions
+- Reduces unnecessary nesting — prefers `match` over nested ternaries
+- Improves variable and method naming
+- Never changes behavior — refine only
+
+Requires: `/plugin install laravel-simplifier@laravel`
+
 ### Parallel Quality Checks (/sk:lint)
 
 After Pint formats files, run PHPStan and Rector in parallel (both are read-only):
@@ -309,6 +344,16 @@ When a generated CLAUDE.md exists (has `<!-- Generated by /sk:setup-claude -->`
 
 This check runs every time — even if tools are installed and tasks files exist. Never short-circuit before verifying section completeness.
 
+### Laravel Commands (CLAUDE.md Additions)
+
+When generating or updating a CLAUDE.md for a Laravel project, append these commands to the Commands table (in addition to the standard ShipKit commands):
+
+| Command | Purpose |
+|---------|---------|
+| `/sk:laravel-deploy` | Deploy to Laravel Cloud (gates must pass first) |
+| `/sk:laravel-init` | Configure existing Laravel project with production-ready conventions |
+| `/sk:laravel-new` | Scaffold a fresh Laravel app with production-ready conventions |
+
 ### Laravel Idempotency (extends global rules)
 
 **Never overwrite** (in addition to global list):

package/skills/sk:setup-claude/templates/.claude/agents/debugger.md

@@ -6,6 +6,13 @@ allowed-tools: Read, Edit, Bash, Grep, Glob
 memory: project
 ---
 
+<!-- DESIGN NOTE: No `isolation: worktree` by design.
+     Debugger is invoked solo (never in parallel with other agents) and must
+     see the actual working state — the real failing code, the real test output,
+     the real stack trace. A worktree copy would give it a clean slate,
+     defeating its ability to reproduce the bug. Edit access is needed to place
+     and remove targeted debug logs during investigation. -->
+
 # Debugger Agent
 
 You are an expert debugger. Find root causes, not symptoms.

package/skills/sk:setup-claude/templates/.claude/agents/qa-engineer.md

@@ -7,6 +7,14 @@ memory: project
 background: true
 ---
 
+<!-- DESIGN NOTE: No `isolation: worktree` by design.
+     qa-engineer runs as a background agent (background: true) alongside
+     backend-dev and frontend-dev during sk:team. It only creates test scenario
+     files (e.g., e2e/<feature>.spec.ts, tasks/e2e-scenarios.md) — never source
+     files. Its writes land in a separate directory tree from the implementation
+     agents' worktree changes, so file conflicts cannot occur. Isolation adds
+     overhead with no benefit here. -->
+
 # QA Engineer Agent
 
 You are the QA Agent in a team workflow. Your job is to write E2E test scenarios while the Backend and Frontend agents implement code in parallel.

package/skills/sk:setup-claude/templates/.claude/agents/tech-writer.md

@@ -6,6 +6,13 @@ tools: Read, Write, Edit, Grep, Glob
 memory: project
 ---
 
+<!-- DESIGN NOTE: No `isolation: worktree` by design.
+     tech-writer only creates and edits documentation files (README.md,
+     docs/*.md, architecture docs, inline comments). It never modifies source
+     code, migrations, or config files. Because its writes are confined to
+     documentation paths that implementation agents never touch, isolation is
+     unnecessary overhead. -->
+
 You are a technical writer specializing in developer documentation. You make codebases comprehensible — to future contributors, to users, and to the developers themselves six months later.
 
 ## On Invocation

package/skills/sk:setup-claude/templates/.claude/rules/laravel.md.template

@@ -18,3 +18,14 @@ paths:
 - **Migrations**: One logical change per migration. Never modify a published migration.
 - **Config**: Access config via `config()` helper, never `env()` outside config files.
 - **Strict mode**: Models use strict mode (prevent lazy loading, silently discarding attributes, accessing missing attributes).
+
+## Code Refinement
+
+After running `/sk:execute-plan`, use the `laravel-simplifier` agent to refine recently modified PHP/Laravel code:
+- Applies PSR-12 standards and Laravel conventions
+- Reduces unnecessary nesting and complexity — prefer `match` over nested ternaries
+- Improves variable and method naming for readability
+- Never changes behavior — refine only
+
+Install once: `/plugin install laravel-simplifier@laravel`
+Invoke: "Review recent changes using the laravel-simplifier agent"

package/skills/sk:setup-claude/templates/CLAUDE.md.template

@@ -310,6 +310,9 @@ Create entries in: `[ARCH_CHANGELOG_DIR]`
 | `/sk:gates` | Run all quality gates in optimized parallel batches |
 | `/sk:health` | Harness self-audit scorecard (7 categories, 0-70) |
 | `/sk:hotfix` | Emergency fix workflow — skip design/TDD, quality gates enforced |
+| `/sk:laravel-deploy` | Deploy to Laravel Cloud (gates must pass first) — Laravel projects only |
+| `/sk:laravel-init` | Configure existing Laravel project with production-ready conventions |
+| `/sk:laravel-new` | Scaffold a fresh Laravel app with production-ready conventions |
 | `/sk:learn` | Extract reusable patterns from sessions into learned instincts |
 | `/sk:lint` | Auto-detect and run all project linters + dependency audits |
 | `/sk:perf` | Performance audit — bundle, N+1, Core Web Vitals, memory |