Agent Guidelines & Operational Rules

1. The "Constitution" & Project Identity

Project Name: NextBlock CMS Mandate: Build a premium, Open-Core Next.js CMS. Core Stack: Next.js (App Router), Supabase, Tailwind CSS, Tiptap v3.

Critical Rules

1. Strict Separation:

   libs/ui

   and

   libs/db

   must be publishable as standalone packages. They cannot depend on

   apps/nextblock

   .
2. Open-Core Model: The core is open-source; premium extensions are private.
3. Distribution: Users get a standalone app via

   npm create nextblock

   .

2. Operational Rules (Global Context)

• Context First: Before answering complex questions, always check

  docs/README.md

  and relevant linked docs.
• Strict Types: Always use

  strict: true

  TypeScript. No

  any

  unless absolutely unavoidable and documented.
• Target the App, Not the Template: NEVER edit files in

  apps/create-nextblock/templates/nextblock-template

  directly. Always make changes in

  apps/nextblock

  (the core app). The template is synced from the core app via scripts.

3. Maintenance Rule: 'Ghost Module Synchronization'

[!IMPORTANT] CRITICAL: Whenever you modify the exports of

libs/ecommerce

(the private library), you MUST immediately update

tools/stubs/libs/ecommerce/index.ts

to export the same names (as stubs).

Why? Failure to do this will break the public open-source build which relies on these stubs when the private library is not present.

4. Documentation Access

• Use the

  context7

  MCP tool to fetch the latest documentation for Next.js, Supabase, Nx, Tailwind, etc.
• Do not guess about API updates; verify with

  context7

  if unsure.