---
name: nustack
description: "Use before changing a relational schema, migration, seed or DB file; package.json, a pnpm workspace or tsconfig; wrangler config or Worker source; a Java service or its build; a @nurix/* CLI; or before publishing an @nurix/* package or debugging an npm publish. The Nurix platform conventions: schema design and naming, workspaces, Cloudflare Workers, Java layout, CLI behavior and packaging, seed pipelines, publishing."
---

# NuStack

The Nurix platform conventions, one area per reference. Read every reference whose trigger matches the task before acting, and read it in full: each one is the authority for its area, and nothing in this file restates it.

| Reference | Load when |
| --- | --- |
| [`references/database.md`](references/database.md) | any relational schema change — a table, column, index, junction, foreign key, migration — or reviewing one: what earns a table, where a fact lives, naming, keys, column types |
| [`references/seeding.md`](references/seeding.md) | a seed pipeline, a seeder, a seed file's format, or scraped or generated data headed for a catalog |
| [`references/pnpm.md`](references/pnpm.md) | `package.json`, `pnpm-workspace.yaml`, `.npmrc` or a `tsconfig`: package naming, monorepo boundaries, the catalog, consuming `@nurix/*` packages |
| [`references/monorepo-setup.md`](references/monorepo-setup.md) | scaffolding a new pnpm workspace, converting a repo to one, adding a workspace member, wiring the catalog, root scripts or build gating |
| [`references/monorepo-master-list.md`](references/monorepo-master-list.md) | the tiered workspace requirements — auditing a workspace's health, reviewing a monorepo PR, deciding what to enforce next |
| [`references/cloudflare.md`](references/cloudflare.md) | `wrangler.jsonc` or Worker source: setup, vars and secrets, dispatch, errors, modules, WebSockets |
| [`references/java.md`](references/java.md) | a Java service or library: the build, the project root, packages and modules, configuration, migrations, `platform-core` |
| [`references/cli.md`](references/cli.md) | a `@nurix/*` command-line tool's behavior: authentication, where it keeps what it is given, how a script or an agent drives it |
| [`references/cli-design.md`](references/cli-design.md) | building or changing a distributable `@nurix/*` CLI: packaging, `npx` distribution, self-update, managed file blocks |
| [`references/publishing.md`](references/publishing.md) | creating or publishing a `@nurix/*` package, wiring or debugging a publish workflow, diagnosing a failed `npm publish` |

Traffic-driven schema and cache choices are the `optimizer`, run on the user's ask.