armanisadeghi

Use when modifying anything under features/files/, app/(a)/files/, app/(public)/share/, or any caller that uploads, downloads, lists, moves, renames, shares, or previews user files.

Add the canonical single icon-only copy/export control to any surface that shows data (rows, cards, lists, detail/record pages) using `components/agent-copy`: one CopyForAiIcon menu containing Copy, Copy JSON, Copy for AI, AI variants, downloads,…

Use when adding/changing a CMS surface manifest, the site_structure/html_pages_structure framing XML, a CMS context menu/extraSections wiring, or the cms-authoring platform skill. Also use when a new CMS route/tab needs an agent entry point.

Use whenever a form needs to accept ONE image and produce permanent public URLs for one or more platform-specific sizes (OG image, social posts, avatars, logos, favicons, app icons). Replaces every legacy image-URL input, single-size uploader, and…

The Pattern Patrols system — recurring, certified sweeps that keep eradicated problem-patterns dead (dead ends, mobile breakage, light/dark violations, missing copy-for-AI, emojis, bare Loading text, unregistered coming-soon, type-suppression debt, and a…

Bring any (core) route into conformance with the AppShell header + body-height + mobile doctrine — the repeatable fix recipe for the campaign to kill faux in-body headers, banned viewport-height calcs, avatar collisions, and mobile menus that vanish instead…

Single source of truth for iOS-native mobile web UX. Covers viewport units, safe areas, Dialog-to-Drawer conversion, Tabs-to-vertical-stacking, touch targets, input zoom prevention, and responsive patterns. Use when building any UI component, fixing mobile…

The canonical doctrine for ALL Supabase realtime in matrx-frontend — postgres_changes, broadcast, and presence. Use BEFORE writing or modifying any `.channel(` subscription, any handler that reacts to a table this client also writes (echo suppression), any…

Audit, package, submit, and track Matrx Extend Chrome Web Store updates. Use for release readiness, Store-policy change assessment, version selection, dashboard submission, listing/privacy/test-instruction updates, and approval monitoring. Do not use for…

Use when extending what the matrx-extend Chrome extension exposes to the aidream backend — adding or modifying server-side capabilities, capability-envelope state keys, discovery routing, or the unified tool merge that injects browser tools into the LLM.…

Use when the matrx-extend Chrome extension needs to coordinate with the Next.js admin app at aimatrx.com — delivering a payload to a tab, opening a window-panels overlay via deep-link, or relaying a message across machines through Supabase Broadcast. Scope…

Use when the matrx-extend Chrome extension needs to invoke a system-level capability that only the matrx-local Tauri desktop engine can provide — running a shell command, accessing the filesystem outside the browser sandbox, or receiving a server-pushed event…

Create a hyper-specialized, production-grade AI Matrx platform agent through the hosted AI Dream MCP (agent_author / agent_catalog / agent_run), usually paired with a registered content-IR kind for its output. Use whenever anyone asks to create, build,…

End-to-end guide to the Matrx OAuth flow — a Next.js proxy in matrx-frontend fronting Supabase, the FastAPI (aidream) callback that does the admin gate, SPA callbacks (aidream apps/dashboard, apps/workflow-studio), and the Tauri desktop client (matrx-local).…

Customize how a tool call renders inside the matrx-extend Chrome extension's chat surface (the agent harness). Use when adding a new entry to the per-tool display registry — overriding the inline header (icon, prefix, name, suffix, info), tweaking how args…

Consume scoped short-lived credentials (token broker) in matrx-extend — provider realtime sessions, direct provider calls through the aidream gateway. Use whenever a feature needs temporary privileged reach to a provider API. NOT for adding new…

Enforce mobile and web performance standards including cache-first data, image optimization, query efficiency, list rendering, bundle size, and monitoring. Use when implementing data fetching, displaying images, writing database queries, rendering lists,…

Ensures correct Supabase patterns across database architecture, auth, storage, and RLS policies. Use when working with database queries, API routes, authentication, storage operations, RLS policies, or schema changes. Also use when the user mentions Supabase,…

MANDATORY: Enforces iOS 26 native design compliance including Liquid Glass, PlatformColor for all system colors, centralized theming via useTheme()/useThemeColors(), SF Symbols, haptic feedback, contentInsetAdjustmentBehavior on all scroll views, and native…

Ensures Android implementations use truly native components, Material 3 Expressive design patterns, and Android 16 requirements. Use when implementing Android-specific features, reviewing Android code for native feel, or when the user mentions Android native,…

Analyzes user flows, determines feature requirements, and creates UI/UX infrastructure plans. Use when planning new features, evaluating user journeys, identifying feature gaps, or when the user mentions user flow, UX planning, feature analysis, UI…

Audit TypeScript code for type safety issues, anti-patterns, and duplicate type definitions. Use when fixing type errors, reviewing TypeScript code, auditing for "any" or "as" usage, checking for duplicate types, or ensuring Supabase types are used as source…

Audit API routes for business logic ownership, type safety, validation, and production hardening. Use when reviewing API routes, creating new endpoints, checking for logic leakage in components, or ensuring endpoints meet production standards. Also use when…

Comprehensive cross-platform feature verification and synchronization. Use after completing a feature to ensure identical functionality across Web Desktop, Web Mobile, iOS, and Android with native implementations. Audits for missing features, API consistency,…

Use whenever adding work to, coordinating, or working an Autonomous Work Loop campaign: atomic claims, full in-scope autonomy, routine-blocker repair, evidence-gated closure, and independent verification.

The Campaign Pattern — how a vision becomes a finished, verified, deployed system with near-zero owner involvement. READ BEFORE launching or coordinating any large build, module, campaign, or multi-agent project: the owner's five launch moves, the…

Take ONE registry node (Domain, Feature, or Sub-feature) and end its documentation sprawl: census every repo, extract everything that carries MEANING into the node's doc kit in common-docs, and DELETE it from the repos it came from — proven by a re-grep, not…

Operate, inspect, diagnose, and safely deploy the AI Matrx ECS/Fargate production platform in AWS us-east-1 without browser access. Use for AWS platform status, ECS services/tasks, CloudWatch logs, alarms, ECR images, ECS Exec, Terraform changes, failover…

Safely inspect, rehearse, verify, and cut over the AI Matrx Supabase Postgres region migration from Matrx Main in us-west-1 to the prepared AI Matrx project in us-east-1. Use for Supabase region-move status, logical backup/restore, project capacity,…

Diagnose and durably fix anything broken on the Matrx fleet (deploys stuck, services behind/unreachable, red fleet-health, sandboxes misbehaving). Use whenever the operator reports "X isn't working / isn't updating / shows behind" on the /srv host, the EC2…

Add a new PyPI-published aidream package as a fully-managed microservice — auto-deploy from PyPI, fleet check, Secrets store, Services page — like matrx-files and matrx-seo. Use when the user says "set up <package> to autodeploy / be managed on the ship…

Use when extending or debugging the connection between the matrx-local Tauri desktop engine and the matrx-extend Chrome extension — adding an RPC command on POST /extension/rpc, exposing a dispatcher tool to the extension, or pushing engine events down the…

Guide for working on the Transcription, Voice, and Wake Word system spanning Rust (Tauri), Python (FastAPI), and React layers. Use when editing Voice.tsx, use-transcription.ts, use-wake-word.ts, use-transcription-sessions.ts, TranscriptionContext,…

Enforces mobile native template principles including no hardcoded colors, proper safe area handling, platform-specific implementations, centralized theming, and TypeScript strict mode. Use when creating components, reviewing code, editing files, or when…

Create production-grade Dockerfiles optimized for speed, security, and minimal size. Use when creating or reviewing Dockerfiles, docker-compose files, or when optimizing container images for Python, Node.js, or multi-runtime environments.