Skip to content

Use when creating, changing, or reviewing an app in apps/*: layout, allowed dependencies, logic/UI separation, and checks.

View source

App rules

Layout

apps/<name>/, copied from the project's app template (without build output and installed dependencies). package.json name is <name>.

  • src/core/: domain logic, independent of the UI. Write this first.
  • src/ui/: views on top of the core logic.

Code

  • Use @workspace/ui components and the project's own hooks.
  • Do not implement library features in the app. If a packages/* feature is missing, stop and report it.
  • No new dependencies unless the step lists them and the user approved them.

Checks

check (dev-tools) with filter: "<app>" and tasks: ["typecheck", "lint", "test", "build"] must pass.

Requirements

  • [test] and [ux] requirements have tests.
  • Every [manual] requirement appears in the acceptance checklist, which the user runs with the app's dev command (see AGENTS.md).