bb-nx-workspace

Define architectural boundaries and ownership for Nx workspace apps and packages.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/valentinmathey/Skills-Back-Automation --skill bb-nx-workspace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bb-nx-workspace
Source: https://github.com/valentinmathey/Skills-Back-Automation/tree/main/skills/bb-nx-workspace
Command: npx skills add https://github.com/valentinmathey/Skills-Back-Automation --skill bb-nx-workspace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Defines the boundaries, ownership, and responsibilities for each application and package in the monorepo to prevent misplacement of functionality and ambiguous ownership.

Core Features & Use Cases

  • Establish clear ownership and separation for apps and packages in the Nx workspace.
  • Provide guidance on where to place new functionality, modules, or services among apps like bruno-brown-bk, internal-api, and orders-api.
  • Enforce the dependency rule: packages should not import apps; apps expose APIs while packages depend on them.

Quick Start

Review the monorepo structure and place new functionality in the appropriate app or package according to the guidelines.

Frequently Asked Questions about bb-nx-workspace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce architectural boundaries in an Nx monorepo?

To enforce architectural boundaries in an Nx monorepo, you define strict ownership rules and dependency directions between apps and packages. This prevents misplacing functionality and ensures packages never import apps directly.

Where should I place new functionality and modules in a monorepo workspace?

Placing new functionality in a monorepo workspace requires reviewing the established app and package boundaries. You place modules or services in the appropriate application, such as internal-api or orders-api, based on documented ownership responsibilities.

What is the dependency direction rule between apps and packages in an Nx workspace?

The dependency rule in an Nx workspace dictates that packages should not import apps. Apps expose APIs while packages depend on them, clarifying structural organization and preventing ambiguous dependency loops.

Can I establish clear ownership for multiple backend apps within a single Nx workspace?

Yes, you can establish clear ownership for multiple backend apps within an Nx workspace. The architecture defines specific responsibilities and separation for apps like bruno-brown-bk, internal-api, and orders-api to prevent ambiguous ownership.

What's the best way to organize packages and apps to prevent misplacing services?

The best way to organize packages and apps to prevent misplacing services is enforcing strict dependency rules and core patterns. Documenting these boundaries ensures every module or service has a designated, unambiguous location.