dot-ai-config

Daily dependency-staleness audit for the CNW (Create Nx Workspace) template repos under ~/projects/cnw-templates/. Detects out-of-date deps (nx, @nx/*, AND third-party), applies safe upgrades within known compatibility constraints, verifies each repo (build/test/lint/typecheck/e2e), and opens one PR per repo that has updates. Use when "audit template deps", "check template dependencies", "update template deps", "template dep audit", or for a scheduled/daily run. Distinct from `cnw-update-templates` (which only nx-migrates the 4 base templates at the old flat paths).

Update all CNW (Create Nx Workspace) template repos to a target Nx version using nx migrate. Handles angular-template, react-template, typescript-template, and empty-template. Runs migrations, commits changes, but does NOT push without user confirmation. Use when "update templates", "cnw templates", "template update", "migrate templates", or specifying a version like "update templates to 22.7.0".

Adversarial multi-dimension review of a branch's uncommitted/committed diff before opening or updating a PR. Fans out review dimensions (correctness, design conformance, copy/voice, hygiene/tests), adversarially verifies each finding, and drafts a terse PR description. Use for a pre-PR review, "review my branch before I open the PR", adversarial PR review, or a conformance gate before push. For deep maintainability/abstraction audits use thermo-nuclear-code-quality-review instead (complementary, not a substitute).

Validate-and-ship loop for nx astro-docs changes. Runs prettier, vale, the STYLE_GUIDE structural pass, an anchor sweep, then amends the squashed commit and force-pushes with 1Password op-request logging. Use after every docs edit round in the nx repo. Triggers on "docs iterate", "amend and push the docs", "ship the docs change", "docs validate and push".

Save a live third-party page (GitHub repo page, npmx/npm package page, docs site) as a local static copy and inject an element into it (badge, banner, widget) for demos without shipping to prod. Use when user wants to "demo X on the GitHub README", "inject the badge into a real page", "make this page work locally", "mock up how it looks on npmjs/github", or "download and serve this page with my change". Output is a directory servable with `npx serve`.

Warn-only deprecation of a first-party Nx bundler config helper (composePlugins/withNx/withWeb/withReact and friends) for removal in the next major. Use when asked to "deprecate <helper>", for a "config helpers deprecated" milestone NXC ticket, or any of the @nx/{vite,webpack,rspack,next,expo,rollup}/react config-composition helpers. Triggers on "deprecate config helper", "deprecate withNx/withWeb/withReact/composePlugins", "warn-only deprecate <helper>".

Compute Nx CLI scorecard metrics for a month: GitHub issues/PRs (nrwl/nx), Linear high-priority misc issues, and npm download counts with YoY growth. Outputs a Notion-ready markdown table. Use when user says "scorecard", "nx scorecard", "cli scorecard", "monthly scorecard", or asks for the Nx CLI team's monthly issue/PR/download metrics.

Render a single Ocean (Nx Cloud) React component in isolation with the real design tokens and capture a screenshot (light + dark), without booting the full Remix app/DB. Use when you need to visually verify or proof-of-work a component you built/changed in the ocean repo, especially when nx/serve is unavailable. Triggers on "screenshot this component", "render it in isolation", "show me what it looks like", "component shot", "preview the component", "verify the design", "check light and dark".

Run an extremely strict maintainability review for abstraction quality, giant files, and spaghetti-condition growth. Use for a thermo-nuclear code quality review, thermonuclear review, deep code quality audit, or especially harsh maintainability review.

Best practices for Remotion - Video creation in React

Weekly scan and audit orchestrator for Nx platform intelligence. Runs all 12 scan/audit commands plus the monthly digest via parallel subagents, then synthesizes a unified report with delta tracking. Use when user says "run scans", "weekly scan", "scan and audit", "run audits", "weekly report", "what's new this week", or any variation. Also use for "monthly scan" or "full audit".

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

Query and analyze create-nx-workspace (CNW) telemetry data from MongoDB. Supports prod and staging environments. Use for error analysis, funnel metrics, version comparisons, and usage trends. Triggers on "CNW stats", "workspace stats", "error rates", "telemetry", "commandStats", "CNW errors", "CNW analysis". Also triggers on "show CNW UI", "CNW dashboard", "CNW report", "show me visually" — generates a self-contained HTML dashboard from the bundled template.

Query and analyze Nx Cloud Distributed Task Execution (DTE) usage from the MongoDB nrwl-api database. Distinguishes Manual DTE (self-managed agents, no launchTemplate) from launch-template DTE (Nx Cloud-managed agents). Breaks down by plan tier (TEAM, PRO, ENTERPRISE, FREE, etc.) and time window. Triggers on "DTE stats", "manual DTE", "Team customers DTE", "distributed execution analysis", "agents stats", "launch template usage", "DTE adoption", "DTE breakdown by plan".

Director-level metrics review across Nx platform: nx.dev engagement, AI traffic rates, npm download trends, docs traffic/page performance, CNW funnel stats, and SPACE engineering productivity. Use when user says "check metrics", "metrics review", "how are our numbers", "dashboard check", "KPI review", "important metrics", or asks about engagement, traffic, downloads, or productivity trends.

Log 1Password auth requests to /private/tmp/op_requests.txt before running any command that triggers a 1P prompt: `op` (any subcommand) and remote `git` ops (push, pull, fetch, clone, ls-remote, remote update — these pull SSH keys from 1Password's agent). The log line shows up in Raycast so Jack sees what's pending before approving the 1P prompt. Triggers automatically before running any of: op, git push, git pull, git fetch, git clone, git ls-remote, git remote update.

Capture terminal output or code as a static image (PNG/SVG/WebP) using charmbracelet/freeze. Use for proof-of-work screenshots when an agent finishes a task ("here's the green test run"), or for polished CLI/TUI demo stills for blog posts/social. NOT for animated demos — use terminal-demo-recorder (VHS) for those. Triggers on "freeze", "screenshot the output", "capture this command", "proof of work image", "make an image of", "snapshot the terminal".

Check modified Nx documentation pages against the astro-docs style guide. Auto-trigger after writing or editing docs content in the nx repo. Also trigger on "check style", "style guide", "docs review", "validate docs". Should run as a final step whenever docs files are modified.

Query and analyze create-nx-workspace (CNW) telemetry data from MongoDB. Supports prod and staging environments. Use for error analysis, funnel metrics, version comparisons, and usage trends. Triggers on "CNW stats", "workspace stats", "error rates", "telemetry", "commandStats", "CNW errors", "CNW analysis".

Help generate terminal demo videos or GIFs using VHS. Use when the user wants to record a terminal session, create a demo for social media/blogs, or mentions "vhs" specifically.

Import, merge, or combine repositories into an Nx workspace using nx import. USE WHEN the user asks to adopt Nx across repos, move projects into a monorepo, or bring code/history from another repository.

Run a local Go HTTP server that captures Nx Cloud API traffic from create-nx-workspace (CNW) and nx init. Use when testing CNW telemetry, recordStat payloads, init analytics, or any request CNW/init would send to NX_CLOUD_API. Triggers on "test CNW stats", "test CNW analytics locally", "test nx init stats", "capture recordStat", "local nx cloud api", "log CNW requests", "test telemetry locally".

Update all CNW (Create Nx Workspace) template repos to a target Nx version using nx migrate. Handles angular-template, react-template, typescript-template, and empty-template. Runs migrations, commits changes, but does NOT push without user confirmation. Use when "update templates", "cnw templates", "template update", "migrate templates", or specifying a version like "update templates to 22.7.0".

Intercepts edits to ~/.gemini/ and ~/.config/ synced files and redirects to ~/projects/dot-ai-config/. Triggers when modifying GEMINI.md, skills, commands, settings, or dotfiles (kitty, fish, nvim, mise, git). Also logs skill/command invocations to the usage tracker.

Collaborate with Gemini CLI for deep codebase research, reviews, and brainstorming. Use this to delegate tasks that require extensive file searching, multi-step analysis, or a 'second opinion' from Gemini's specialized agents.

Enforce caveman-lite prose style on every Linear issue description written or updated via the Linear MCP tools. Descriptions must be succinct: no filler, no hedging, no marketing recap. Keep articles and full sentences; drop everything else. Applies to ALL Linear issue create/update operations — no user keyword required. Triggers automatically when about to call: - mcp__gemini_ai_Linear__save_issue - mcp__gemini_ai_Linear__create_comment (if comment is issue-description-like) Also triggers on phrases like "make this Linear issue shorter", "caveman-lite the issue", "trim the description".

Director-level metrics review across Nx platform: nx.dev engagement, AI traffic rates, npm download trends, docs traffic/page performance, CNW funnel stats, and SPACE engineering productivity. Use when user says "check metrics", "metrics review", "how are our numbers", "dashboard check", "KPI review", "important metrics", or asks about engagement, traffic, downloads, or productivity trends.

Check modified Nx documentation pages against the astro-docs style guide. Auto-trigger after writing or editing docs content in the nx repo. Also trigger on "check style", "style guide", "docs review", "validate docs". Should run as a final step whenever docs files are modified.

Weekly scan and audit orchestrator for Nx platform intelligence. Runs all 12 scan/audit commands plus the monthly digest via parallel subagents, then synthesizes a unified report with delta tracking. Use when user says "run scans", "weekly scan", "scan and audit", "run audits", "weekly report", "what's new this week", or any variation. Also use for "monthly scan" or "full audit".

Route code review requests through Plannotator (https://plannotator.ai) so Jack can leave comments, request changes, or approve in an interactive UI instead of inline chat. Triggers whenever the user asks to review a branch, diff, PR, or pending changes — phrases like "review this", "review the branch", "review my changes", "look over this PR", "can you review", "ready for review", or any request for code review feedback. Also triggers when a task ends with "now review it" or similar handoff to a review step.

Enforce caveman-lite prose style on every Linear issue description written or updated via the Linear MCP tools. Descriptions must be succinct: no filler, no hedging, no marketing recap. Keep articles and full sentences; drop everything else. Applies to ALL Linear issue create/update operations — no user keyword required. Triggers automatically when about to call: - mcp__claude_ai_Linear__save_issue - mcp__claude_ai_Linear__create_comment (if comment is issue-description-like) Also triggers on phrases like "make this Linear issue shorter", "caveman-lite the issue", "trim the description".

Collaborate with Gemini CLI for deep codebase research, reviews, and brainstorming. Use this to delegate tasks that require extensive file searching, multi-step analysis, or a 'second opinion' from Gemini's specialized agents.

Run a local Go HTTP server that captures Nx Cloud API traffic from create-nx-workspace (CNW) and nx init. Use when testing CNW telemetry, recordStat payloads, init analytics, or any request CNW/init would send to NX_CLOUD_API. Triggers on "test CNW stats", "test CNW analytics locally", "test nx init stats", "capture recordStat", "local nx cloud api", "log CNW requests", "test telemetry locally".

Apply patches/fixes from night-shift worker agents. Parses session reports, presents fixable issues for selection, creates git worktrees with applied patches, and commits for review. Triggers on "apply nightshift", "nightshift fixes", "apply patches", "night shift".

Weekly planning assistant. Reviews all PARA areas by priority, pulls Linear backlog, checks active experiments, and produces a prioritized action plan. Use when user says "plan my week", "weekly plan", "what should I focus on", "Monday planning", "plan the week", "weekly priorities", or starts the week and wants to get organized. Also triggers on "mid-week refresh" or "end of week review".

Route code review requests through Plannotator (https://plannotator.ai) so Jack can leave comments, request changes, or approve in an interactive UI instead of inline chat. Triggers whenever the user asks to review a branch, diff, PR, or pending changes — phrases like "review this", "review the branch", "review my changes", "look over this PR", "can you review", "ready for review", or any request for code review feedback. Also triggers when a task ends with "now review it" or similar handoff to a review step.

Check website pages from an index URL for broken links, missing images, SEO issues, and console errors. Crawls <a href> links from the index page (shallow, no recursion) and validates each. Supports localhost, preview deploys, staging, and production. Optional compare mode diffs DOM against a reference URL.

Validate Nx project config changes for cache input/output misalignments. Auto-trigger when project.json, package.json targets, or nx.json targetDefaults/namedInputs are modified. Also trigger on "check cache config", "validate inputs outputs".

Test nx-cloud client-bundle commands locally against snapshot, staging, or local environments. Use when testing onboarding, fix-ci, or other nx-cloud CLI commands. Triggers on "test bundle", "cloud bundle", "nx-cloud local", "test onboard", "bundle tester".

Check Netlify deploy status for Nx sites. Use when user asks "is it deployed?", "deploy status", "check deploy", "is main deployed?", or "did it deploy?". Auto-selects sites based on current repo.