Pi-Dev-Ops

Use when a Remotion video needs creative direction: hook, visual sequence, scene purpose, motion restraint, and CTA direction before render.

Use when a Remotion video has timing, sync, transition, caption, pacing, or audio-fit risk and needs editing discipline before render.

Use when /remotion-video needs existing Synthex ElevenLabs, brand-config, Remotion, output storage, Claude, or Hermes integration without adding vendors.

/remotion-video one-shot Remotion command skill and ENTRY POINT for the Remotion Skills Package. Use for video, explainer, ad, promo, reel, intro, social cut, marketing, training, or launch videos. Reads the brief, classifies intent, enforces one single Synthex ElevenLabs voice, emits a production/wave plan, and dispatches the right sub-skills in topological order. Always invoked first.

Use when a Remotion video job needs production gates, render evidence, output discipline, and pass/fail validation before it can be called shippable.

Use when a Remotion video needs a professional marketing QA pass for brand fit, readability, pacing, typography, polish, and not-looking-generated.

Use when a Remotion marketing video needs a timed script, scene narration, on-screen text, CTA, and voice pacing that fits a single ElevenLabs voice.

/review specialised command skill. Use when the operator asks for /review, review, code review, launch review, or "check this before ship" and needs one de-duplicated, evidence-backed review packet instead of fixes or secondary work.

NorthStar add-on for /northstar and /ship-it. Removes noisy branches, picks the highest-value straight path to ShipIt, and hands only the approved launch-ready lane into the existing launch-charter → ship-it → ship-chain machinery.

Agentic development operating loop for non-engineer-led builds: expand the idea, research surrounding advances, produce artifacts, plan, build, review, and compound learnings back into the 2nd brain and CRM.

Synthex API testing enforcer. NEVER mock the database in integration tests — use real Supabase. NEVER skip the 401 (unauthenticated) or 403 (wrong org) test cases. NEVER use pnpm. ALWAYS structure tests as: 401 → 403 → 400 → 200/201 happy path. Activate on ANY request to write API tests, validate endpoints, add test coverage, or check test quality.

Synthex campaign content enforcer. NEVER open posts with "Excited to announce", use "leverage", "game-changing", or "revolutionary", produce platform-agnostic copy, or generate content that scores below 80. ALWAYS write platform-distinct hooks, use specific numbers over superlatives, and enforce exactly one CTA per piece. Activate on ANY request to create a campaign, generate posts, write social content, or launch content for a product, offer, or event.

Synthex brand consistency enforcer. NEVER produce vague feedback ("sounds on-brand", "good feel", "consistent with your voice"). ALWAYS score against specific criteria: vocabulary match percentage, anti-pattern phrase count, and CTA quality. Every feedback item must be specific enough to act on immediately. Activate on ANY request to check brand consistency, audit content against brand guidelines, review voice alignment, or validate that content matches a Business DNA profile.

Establishes an authenticated browser session on synthex.social or localhost so that protected dashboard routes can be verified without human login. Handles the Supabase email/password login flow using the SYNTHEX_TEST_EMAIL and SYNTHEX_TEST_PASSWORD environment variables. Use before running browser-verify or site-smoke-test on authenticated routes (/dashboard/*), when asked to "log in", "authenticate", "sign in to test the dashboard", or when browser-verify reports "Authentication required".

Synthex brand DNA extractor. NEVER produce surface-level brand descriptions ("professional and friendly"), generic persona archetypes ("busy professional aged 25–45"), or tone descriptions that could apply to any brand. ALWAYS extract vocabulary the brand actually uses, describe what the brand explicitly is NOT, and ground the audience in a specific outcome they are seeking. Activate on ANY request to extract brand identity, build a DNA profile, define a brand voice, analyse a website for brand signals, or create a persona profile.

Synthex campaign planning enforcer. NEVER produce generic Mon-announcement, Wed-educational, Fri-promotional calendar arcs, or fill slots with placeholder content types without brand-specific reasoning. ALWAYS derive the content arc from the brand's DNA and campaign goal, vary cadence by platform, and name the specific hook angle for every calendar slot. Activate on ANY request to plan a campaign, build a content calendar, schedule posts, or map out a 30/60/90-day content strategy.

Campaign and client data management via Prisma ORM. Handles CRUD operations on campaigns, posts, projects, and user preferences. Tracks analytics and API usage. Use when user says "create campaign", "list campaigns", "update post", "delete project", "client data", or "manage analytics".

Synthex code quality enforcer. NEVER flag Synthex conventions as bugs (Australian English, Supabase-only auth, SWR with credentials:'include', selective error boundaries). NEVER suggest Redux, Zustand, tRPC, or any pattern absent from this codebase. ALWAYS enforce: useRouter from next/navigation, no window.location.href, SWR for client data fetching, { error: string } response shape. Activate on ANY request to review code, audit a PR, check a component, or validate an implementation.

Competitor gap analysis, displacement tactics, benchmarking, citation gaps, and quarterly strategy reviews for local businesses. Use when analysing competitors, planning market positioning, or building competitive advantage in local search.

AI content generation pipeline guide for SYNTHEX. Documents the model registry, provider abstraction, BYOK key injection, content scoring, and repurposing flow. Use when working on AI-powered content features or debugging model selection issues.

Synthex database operations enforcer. NEVER use prisma db push for schema changes — use migrate diff + db execute. NEVER add non-nullable columns without defaults. NEVER write Prisma queries without organizationId scope. ALWAYS use backward-compatible migrations and validate with prisma validate first. Activate on ANY request to change schema, write a query, create a migration, add a model, or modify database operations.

Synthex design system enforcer. NEVER use Inter as a heading font, purple (#8B5CF6) gradients on white, or generic glassmorphism without Synthex tokens. ALWAYS use Space Grotesk headings, #f97316 brand orange, #0f172a slate background, and the Synthex glass token set. Activate on ANY request involving UI, components, styling, layout, visual design, colour, typography, spacing, shadows, animations, or anything a user will see on screen.

Listing optimisation, review response strategy, Google Posts, local pack ranking factors, NAP consistency, and category selection for Google Business Profile. Use when optimising GBP listings, managing reviews, or improving local search visibility.

GSC data interpretation, indexing triage, coverage analysis, sitemap strategy, and diagnostic decision trees for search performance issues. Use when working with Search Console data, debugging indexing problems, or analysing search analytics trends.

Algorithm update types, diagnosis workflows, recovery strategies, and proactive hardening for Google algorithm changes. Use when diagnosing traffic drops, responding to algorithm updates, or hardening sites against future updates.

Orchestrates google-search-console, google-business-profile, competitive-local-strategy, and google-updates-sentinel skills into a unified local SEO strategy with monthly audit cadence. Use when running local SEO campaigns, onboarding new clients, or performing monthly audits.

Synthex platform showcase enforcer. NEVER describe features with generic marketing language ("powerful AI", "seamless integration") or produce wall-of-bullets capability lists. ALWAYS lead with a specific client outcome, use concrete numbers, and write in Australian English. Activate on ANY request to showcase a platform, explain a feature, demonstrate capability, or create platform presentation content.

Synthex security posture enforcer. NEVER apply generic OWASP checklists without grounding in Synthex's specific threat model. NEVER suggest any auth system other than Supabase. ALWAYS audit: SSRF via validateExternalUrl, JWT tier elevation via resolveVerifiedTier, CORS via CORS_ORIGIN exact-match, org-scope bypass in Prisma. Activate on ANY request to harden security, audit vulnerabilities, review auth patterns, check for injection risks, or assess an attack surface.

"No implementation without specification" enforcement. Auto-generates specification documents before any feature or project work begins. Two templates: project-phase (10 sections) and feature (8 sections). Specs are written to `.claude/specs/`. Includes detection logic to intercept implementation tasks that lack a spec.

Synthex UX enforcer. NEVER produce generic bullet-list audit reports, recite WCAG rules without grounding them in Synthex's dark glassmorphic interface, or reference pnpm (this project uses npm). ALWAYS ground findings in Synthex's #0f172a dark background, Radix UI primitive semantics, and 4px spacing scale. Activate on ANY request to audit UX, review accessibility, optimise flows, check interactions, or validate usability.

Video generation pipeline guide for Synthex. Documents the 4-provider architecture (Runway, Synthesia, D-ID, Remotion), FFmpeg post-processing, media library integration, and God Mode gating.

Synthex visual content enforcer. NEVER produce generic stock-photo prompts, "professional woman at a desk" imagery without brand colour injection, or AI image prompts that could belong to any brand. ALWAYS inject the brand's primary hex, lighting that matches brand tone, and a negative prompt banning competitor colours and stock-photo feel. Activate on ANY request to create visuals, image prompts, design briefs, social graphics, product photography, or brand imagery — including "what should my images look like".

ENTRY POINT for the Remotion Skills Package. Use the moment a brief mentions "remotion skills package", "remotion package", "use remotion", or any of the video keywords — video, explainer, ad, promo, reel, intro, social cut, 60s/30s/15s spot, or any rendered marketing/training video for one of the portfolio brands (DR, NRPG, RestoreAssist/RA, CARSI, CCW) or for a customer brand. Globally available across every project under /Users/phill-mac/. Reads the brief, classifies intent (composition type, brand, channel, duration), emits a wave-plan JSON, and dispatches the right sub-skills in topological order. Always invoked first.

Research a project and plan 15+ moves ahead before building anything. Establishes the win condition (Definition of Done), reads the board (repo + PORTFOLIO registry + live external research), computes the gap, lays a roadmap spine of 15+ verifiable moves, forks branch points where outcomes are contingent, and red-teams the end-state to surface the "move-16 surprise" before it bites. Produces BOTH a human-readable foresight brief AND a machine-readable structured plan the swarm can execute. Use this FIRST whenever you (or the autonomous loop) are about to build, scope, or roadmap a project — and whenever someone asks "what's the full path to X", "what are we missing", "plan N moves ahead", "think this through", or talks about strategy, foresight, lookahead, sequencing, dependencies, or roadmaps. Use it even when the request just says "build project X" — map the whole path before executing the first step.

Run a relentless one-question-at-a-time interview on a sketch or plan until every branch of the decision tree resolves into either a decision, a rabbit hole, or an explicit no-go. Use when the user wants to stress-test a fat-marker sketch before any code is written, or asks to be "grilled", "interviewed", or to "stress-test" a plan. Adapted from Matt Pocock's /grill-me (mattpocock/skills) and combined with Shape Up's appetite + fidelity discipline.

Research and intelligence doctrine — the directing analysis layer for growth and sustainability data collection. Frames questions, tasks collector skills, grades evidence (NATO/Admiralty), runs ACH/premortem/gap-scan, and delivers defensible evaluations with kill-switches. Use before any non-trivial research, market sizing, strategic bet, or when synthesising collector output into a decision.

Method for collecting and gathering data for growth and sustainability across the 11-business portfolio. Defines the two-layer stack — Analyst (direction + analysis) commands collector skills (CMO, CFO, CTO, CS, Margot, wiki, Scout, marketing) — and the handoff contract between them. Use when framing executive visibility, research sprints, board prep, or any question about whether the business can grow and endure.

Authors or extends a Remotion composition (.tsx) wired to BrandConfig + Storyboard + layout spec + motion. The actual builder skill — runs as a Sonnet-tier worker. Triggered after brand, storyboard, designer, and motion-language outputs are ready. Produces the file under remotion-studio/src/compositions/ and registers it in src/Root.tsx.

Safely manage long-running tmux-based dev workflows (build, test, watch, log tailing) on the local machine via a constrained command grammar. Use when an agent or operator wants to inspect tmux state, start a known profile, or run an allowlisted command inside a tracked session. NEVER use for production deploys, force-pushes, secret-exfiltrating commands, or anything matching the denylist. Read policy/ before executing.

How to ship PRs cleanly across the Unite-Group portfolio (Synthex, Pi-Dev-Ops, Disaster-Recovery, DR-NRPG, RestoreAssist, ATO, CARSI, CCW-CRM, Unite-Hub, synthex-mcp-app) without falling into the same CI / Vercel / Supabase / convention traps every session. Captures the recurring failure modes I hit 2026-05-25 across PRs