Comparison

A · Cursor rules · novuhq/novu B · AGENTS.md · novuhq/novu

What each file covers, counted
Dimension	Only in A	Only in B	Overlap
Sections	1	9	0%
Commands	0	2	0%
Section tags	0	3	0%

What each file covers

Sections

0 shared · 1 only in A · 9 only in B

− Dependency Graph
+ AGENTS.md
+ Cursor Cloud specific instructions
+ Build
+ AI Boundaries
+ Always
+ Ask First
+ Never
+ Developer-local agent config
+ Novu Distribution

Commands

0 shared · 0 only in A · 2 only in B

+ pnpm setup:agent
+ pnpm build

Section tags

0 shared · 0 only in A · 3 only in B

+ build
+ do-not
+ agent-behaviour

Line diff

+41 added−32 removed3 unchanged6.8% identical

novuhq/novu · .cursor/rules/dependency-graph.mdc

@@ −1 @@

1---

2description: Novu monorepo dependency graph — use when assessing blast radius before changing shared code

3globs:

4alwaysApply: false

5---

7## Dependency Graph

9```mermaid

10graph TD

11 subgraph apps [Apps]

12 api[api]

13 dashboard[dashboard]

14 worker[worker]

15 ws[ws]

16 end

17 subgraph libs [Libs - internal only]

18 dal[dal]

19 appGeneric[application-generic]

20 end

21 subgraph pkgs [Packages - published to NPM]

22 shared[shared]

23 framework[framework]

24 jsSDK[js]

25 reactSDK[react]

26 end

27 api --> appGeneric --> dal

28 worker --> appGeneric

29 ws --> appGeneric

30 api --> shared

31 worker --> shared

32 dashboard --> reactSDK --> jsSDK --> shared

33 dashboard --> framework

34```

novuhq/novu · AGENTS.md

@@ +1 @@

1# AGENTS.md

3## Cursor Cloud specific instructions

5`pnpm setup:agent` has already been run. Do not run it again. The environment is fully configured: dependencies installed, enterprise packages linked, project built, `.env` files in place, Docker services running, and a default user/org seeded. The dashboard auto signs in the pre-seeded agent user when opened in the browser (no manual login unless auto sign-in fails).

7## Build

9Run `pnpm build` after changes to `packages/` or `enterprise/`. Direct changes to `apps/` do not require a rebuild.

11## AI Boundaries

13### Always

14- Work within: `apps/api`, `apps/dashboard`, `apps/worker`, `apps/ws`

15- Use shared packages: `packages/shared`, `packages/framework`, `packages/js`, `packages/react`

16- Follow `libs/dal` for data access, `libs/application-generic` for business logic

18### Ask First

19- Before creating new UI components not in `apps/dashboard/src/components/`

20- Before adding npm dependencies

21- Before modifying MongoDB models, ClickHouse table definitions, or anything in `enterprise/` or `packages/providers/`

23### Never

24- Inactive apps — do not touch, unless monorepo wide refactor: `apps/webhook`

25- Auto-generated — never edit: `libs/internal-sdk`

26- UI: reuse existing Radix/shadcn components only; do not copy patterns from `playground/` into production code

27- If doing a monorepo wide refactor, you can touch the read only, but only when necessary.

30## Developer-local agent config

32If a **`.agents-local/`** directory exists in your working copy, read **`.agents-local/README.md`** first for personal, git-ignored agent configuration, skills and rules. Absence of the directory is normal.

34## Novu Distribution

35Novu is distributed in 3 modes, Community Edition, Enterprise Cloud Edition, and On-Prem Enterprise Edition.

37When making changes targeted to the Enterprise distribution, we need to make sure that the changes are not breaking the Community edition, and are properly gated behind a flag, or the novu enterpise env variables. Similarly when some changes are only targeting the Cloud, self-hosted on prem should not be affected.

39

40

41

42

43

@@ −1 +1 @@

1−---

2−description: Novu monorepo dependency graph — use when assessing blast radius before changing shared code

3−globs:

4−alwaysApply: false

5−---

1+# AGENTS.md

7−## Dependency Graph

3+## Cursor Cloud specific instructions

9−```mermaid

10−graph TD

11− subgraph apps [Apps]

12− api[api]

13− dashboard[dashboard]

14− worker[worker]

15− ws[ws]

16− end

17− subgraph libs [Libs - internal only]

18− dal[dal]

19− appGeneric[application-generic]

20− end

21− subgraph pkgs [Packages - published to NPM]

22− shared[shared]

23− framework[framework]

24− jsSDK[js]

25− reactSDK[react]

26− end

27− api --> appGeneric --> dal

28− worker --> appGeneric

29− ws --> appGeneric

30− api --> shared

31− worker --> shared

32− dashboard --> reactSDK --> jsSDK --> shared

33− dashboard --> framework

34−```

5+`pnpm setup:agent` has already been run. Do not run it again. The environment is fully configured: dependencies installed, enterprise packages linked, project built, `.env` files in place, Docker services running, and a default user/org seeded. The dashboard auto signs in the pre-seeded agent user when opened in the browser (no manual login unless auto sign-in fails).

7+## Build

9+Run `pnpm build` after changes to `packages/` or `enterprise/`. Direct changes to `apps/` do not require a rebuild.

10+

11+## AI Boundaries

12+

13+### Always

14+- Work within: `apps/api`, `apps/dashboard`, `apps/worker`, `apps/ws`

15+- Use shared packages: `packages/shared`, `packages/framework`, `packages/js`, `packages/react`

16+- Follow `libs/dal` for data access, `libs/application-generic` for business logic

17+

18+### Ask First

19+- Before creating new UI components not in `apps/dashboard/src/components/`

20+- Before adding npm dependencies

21+- Before modifying MongoDB models, ClickHouse table definitions, or anything in `enterprise/` or `packages/providers/`

22+

23+### Never

24+- Inactive apps — do not touch, unless monorepo wide refactor: `apps/webhook`

25+- Auto-generated — never edit: `libs/internal-sdk`

26+- UI: reuse existing Radix/shadcn components only; do not copy patterns from `playground/` into production code

27+- If doing a monorepo wide refactor, you can touch the read only, but only when necessary.

28+

29+

30+## Developer-local agent config

31+

32+If a **`.agents-local/`** directory exists in your working copy, read **`.agents-local/README.md`** first for personal, git-ignored agent configuration, skills and rules. Absence of the directory is normal.

33+

34+## Novu Distribution

35+Novu is distributed in 3 modes, Community Edition, Enterprise Cloud Edition, and On-Prem Enterprise Edition.

36+

37+When making changes targeted to the Enterprise distribution, we need to make sure that the changes are not breaking the Community edition, and are properly gated behind a flag, or the novu enterpise env variables. Similarly when some changes are only targeting the Cloud, self-hosted on prem should not be affected.

38+

39+

40+

41+

42+

43+

3544