nonlinear-xyz/factory-kit

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Motion discipline distilled across builds. Attention as a fixed per-viewport budget, figure/ground separation (calm the ground, load motion into the figure), one focal point of motion per screen, diegetic-over-decorative test, trigger-on-intent-then-settle over perpetual loops, and the prefers-reduced-motion fallback.…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Use when designing or implementing API endpoints — server actions, tRPC procedures, REST routes for external consumers. Carries the factory's API conventions — the server actions vs tRPC decision, procedure tier stacking, per-mutation Zod schemas, central router composition with manual registration, pagination…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

API conventions for both server actions and tRPC builds. Covers the decision between them, per-mutation Zod input schemas, central router composition, pagination shape, multi-field search via Drizzle ilike + or(), mutation lifecycle hooks, conditional query enabling, stale-time defaults, error response shape and…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Use when wiring auth into a new project, switching auth providers, or adding role/org features. Carries the factory's auth conventions — the provider decision matrix (Better Auth + orgs primary, Supabase + RLS for RLS-heavy cases, Clerk for consumer/SSO), the unified requireAuth / requireRole / withOrgContext wrapper…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Auth and authorization conventions distilled across builds with three different auth stacks (Better Auth + orgs, Supabase Auth + RLS, Clerk). Covers the provider decision matrix, the unified wrapper interface (requireAuth / requireRole / withOrgContext), procedure tier stacking, session handling, OAuth callback…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

CI and pull-request review conventions. One canonical .github/workflows/ci.yml is the merge gate (typecheck, lint, test, build, claude-review); branch protection's required-checks list matches the job list 1:1; anthropics/claude-code-action@v1 reviews every PR against the factory-pitfalls.md checklist as a required…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Close out a Linear issue — move to Done, add a closing comment, and clean up the local branch/worktree.

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Use to review a PR, diff, or recently-written code against the factory's conventions. Read-only — outputs structured review, not diffs. Carries the full factory-pitfalls digest as a PR checklist plus the conventions from every other factory-.md skill. Flags anti-patterns, missing conventions, security risks, and…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Commit message and branch convention — Conventional Commits format with a Linear issue reference required in subject or body. Includes the canonical commitlint.config.cjs, Husky hook snippet, and opencommit configuration. Read whenever setting up a new project or wiring AI-assisted commits.

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Database schema, ORM, and migration conventions across builds. Drizzle as default with domain-partitioned schema modules, shared timestamps helper, multi-tenancy keys with cascade delete, pgTableCreator prefixing, JSONB for flexible attributes, schema-derived type exports, polymorphic table patterns, ESLint Drizzle…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Use when designing or implementing data ingestion, CSV imports, time-series storage, Python services that sit alongside Next.js, simulation pipelines, or external-API integration with submit/poll/fetch shapes. Carries the factory's data-pipeline conventions — TS scripts with Papa Parse, JSONB envelopes for…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Data ingestion and pipeline conventions for projects that import CSVs, run simulations, or operate Python services alongside Next.js. Covers Papa Parse for CSV imports, JSONB envelope storage for time-series data, the three-entry-point Python service pattern (CLI / Cloud Run API / Pub/Sub), YAML config for…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Use when planning or executing a destructive change against a production database — schema migrations with backfills, periodic data imports, one-shot RPCs, drop-constraint operations, anything that mutates prod tables and cannot be trivially undone. Sister agent to db-schema-architect (schemas) and…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

The operational discipline for running a destructive change against a production database — schema migrations, data backfills, one-shot RPCs, historical seed imports. Adjacent to factory-data-layer.md (schema design) and factory-deployment.md (where migrations execute in CI) — this skill is about the runbook around…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Use when designing or modifying database schemas, migrations, multi-tenant data models, or polymorphic table structures. Carries the factory's data-layer conventions — Drizzle with domain-partitioned schema modules, shared.ts with timestamps helper and pgTableCreator, org-keyed FKs with cascade delete, JSONB envelope…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Deployment and infrastructure conventions across builds. Vercel + Neon for web (with PR branch DBs), Cloud Run for Python services (one service per entry-point variant), GitHub Actions matrix-deploy on merge, Terraform with environments/modules layout for AWS / compliance customers, RDS IAM authentication for AWS DBs…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Design-system discipline distilled across builds. Semantic token vocabulary (name intent, not palette position), CSS variables bridged into Tailwind, dark/light as a variable swap, single- vs two-layer token systems, component primitives as token consumers, when to promote a repeated utility cluster into a primitive…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Load a Linear issue into context and enter plan mode for a focused session.

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Use to turn a vague client ask into a buildable feature spec — scoping, decisions-needed identification, skill routing, risk surfacing. Carries the factory's decision-criteria stack (Mantine vs shadcn, server actions vs tRPC, auth provider, etc.) and routes to the right specialist skills. Outputs a structured spec …

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Use when building multi-step forms, complex intake flows, drawer-CRUD forms, or anything beyond a one-shot Mantine form. Carries the factory's form conventions — react-hook-form + Zod via resolver, three Zod variants (server strict / client lenient / patch), modular section files from day one, field registry for…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Form conventions distilled across builds. react-hook-form + Zod via resolver (Mantine or shadcn variant), three Zod schema variants (server strict / client lenient / patch), drawer-CRUD with mode union, field-registry pattern for multi-step forms, declarative conditional visibility with auto-cleanup, debounced…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Use when scaffolding any frontend surface that touches lists, forms, drawers, tables, or entity editing. Carries the factory's CRUD conventions — DataTable + drawer with mode union, RowActions primitive, per-context Zod schema variants, query-key naming, format helpers as single source, tier-based heading components…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Frontend conventions distilled across builds. CRUD shape (DataTable + drawer with mode union), RowActions primitive, format helpers, heading tiers, semantic color tokens, query-key naming, component-library decision criteria (Mantine vs shadcn). Read when scaffolding any UI surface that touches lists, forms, or entity…

nonlinear-xyz/factory-kit

Skill Claude CodeCodex

Part of factory-kit

Measure the factory-kit's token footprint — baseline vs on-demand, heaviest assets, trim candidates.