larv

Adoption controller for /larv:adopt. Read-only on user code. Detects existing Laravel packages and produces docs/larv/ retroactively.

Phase 2 - C4 architecture, ADRs, and Laravel package integration matrix from Phase 0 library decisions.

Phase 10 - production deployment guidance and verification. Defaults to Laravel Cloud hosting and Namecheap DNS; deploy instructions are also generated into docs/Handsoff/production-deploy.md for external AI handoff.

Phase 3 - design recommendation memo, user chooses from Attio-first recommendations or a specific direction, mockup server renders interactive HTML Effectiveness mockups for this app's screens, user converges on one design, brand spec finalized.

Phase 0 - Laravel-specific brainstorming, grounded in the DDD interview output. Starts with the user's design-direction preference, then asks about admin panel, auth, async, realtime, observability, performance, payments, multi-tenancy, search, MCPs, and dev tooling.

Phase 6.5 - Docsify-served review of the full plan and generated handoff before the Phase 8 routing menu. Verifier allocates a port from the docsite range; firewall opened; probe-before-announce.

Phase 1 - DDD viability check, then either Laravel-DDD architecture mapping (WebFetches the linked medium article at runtime) or a flat Eloquent-friendly domain model.

Phase 0a - business-process-only DDD interview. Runs before Discuss. Outputs ubiquitous language, business invariants, edge cases, and a draft subdomain clustering, all in plain English.

Use when the user types /larv-feature-feedback or asks to add in-app feedback, bug report, idea report, screenshot feedback, or developer feedback to a Laravel app.

Use when the user types /larv-feature-how-it-works or asks to add a How It Works, Guide, walkthrough, product tour, or user workflow page to a Laravel app.

Use when the user types /larv-feature-onboarding-helper or asks to add onboarding, first-login setup, guided tours, role walkthroughs, or user-flow helper UX to a Laravel app.

Use when performing a full end-to-end production smoke test of a Laravel app — logs all bugs found across every feature before fixing any of them.

Generate the universal Handsoff.md index, sandbox bootstrap handoff, production/env/ops guides, per-slice handsoffs, and AI starting-point files. Mandatory before the routing menu.

Use at the start of every larv skill, command wrapper, and workflow phase to activate the Ponytail + gated Headroom + Caveman combo; checks Headroom through scripts/headroom-combo.sh, applies YAGNI/Ponytail discipline, preserves Caveman style, and falls back without Headroom when unsafe or unavailable.

Use when creating a HyperFrames promo video for a Laravel or larv-managed app, especially when the app needs discovery, theme direction, app screenshots, role/workflow documentation, claim confirmation, or delegated rendering with hyperframes-codex.

Phase 8 thin loop — read each docs/Handsoff/slice-NN-*.md and execute its inline bash. Same code path for same-session, subagents, and external-AI execution.

Phase 11 - aggregate implementation reports, local learnings, and plugin improvement notes into LEARNINGS.md proposals. Supports --quick, --full, --since, and --dry-run.

Top-level dispatcher. Per-phase soft gate, required mockup/docsite URLs, mandatory handoff generation, and routing menu before Phase 8. Spawns fresh subagents per phase.

Phase 6 - Elephant Carpaccio slice plan with parallelism annotations, token budget, and the mandatory sandbox deploy/start script consumed by handoff bootstrap.

Phase 5 wrapper - failure modes, adversarial review, risks register. May loop back to phases 2/3/4.

Use when the user types /larv:presentation or asks for a browser-served visual workflow presentation of the current repo.

Legacy helper reference for sandbox provisioning. The current /larv:full flow does not dispatch this skill; app sandbox startup is generated as docs/Handsoff/bootstrap-sandbox.md and run by the implementation venue.

Use when the user types /larv:redesign-attio-finance or asks to redesign a Laravel frontend into the Attio Finance CRM visual system.

Use when the user types /larv:redesign-attio-venture or asks to redesign a Laravel frontend into the Attio Venture CRM visual system.

Use when the user types /larv:redesign-impeccable-higgsfield or asks to redesign a Laravel frontend using Impeccable directions and Higgsfield comps presented on a sandbox URL.

Repository security guard for Laravel and larv workflows before adopting, installing, running, implementing, or trusting app code and packages.

Wire a consumer Laravel app to auth.odvi.app (dtt-sso). Diagnoses and fixes the "Permissions refresh failed / HTTP 404 /api/permissions/catalog" error, registers the app on the IdP, and refreshes the permission catalog. Run this skill from the CONSUMER app's repo, not from the dtt-sso repo.

Phase 4 - Pest, Playwright, package-specific test matrix, and acceptance criteria for Laravel apps.

Phase 9 - final verification across Pint, Pest, Larastan, asset build, migrations, and sandbox smoke before production deploy guidance.