monorepo-backend-layout
For repos with a backend/ (or similar) directory, treat that as the app root. Create all API routes and library code under backend/src/app/... and backend/src/lib/... Never create src/ at the repository root for backend routes. Use before creating any API or lib file to prevent 404s and wrong-path creation.
Source facts
- Repository
- pmarashian/cursor-agent-skills
- Last source activity
- February 13, 2026 at 19:51
- Detected SKILL.md language
- English
- Stars
- 2
- Forks
- 1
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- monorepo-backend-layout
- description
- For repos with a backend/ (or similar) directory, treat that as the app root. Create all API routes and library code under backend/src/app/... and backend/src/lib/... Never create src/ at the repository root for backend routes. Use before creating any API or lib file to prevent 404s and wrong-path creation.
# Monorepo / Backend Layout
For repositories with a `backend/` (or similar) directory, that directory is the backend app root.
## Checklist Before Creating Any API or Lib File
1. **Identify the backend app root** (e.g. `backend/`).
2. **Create files only under that root**:
- API routes: `backend/src/app/api/...`
- Library code: `backend/src/lib/...`
- (Or the project's actual layout—e.g. `backend/src/app/...` for Next.js App Router.)
## Rules
- **Never** create `src/` at the repository root for backend routes or libs.
- **Never** put routes under `backend/lib/` if the project uses `backend/src/lib/`.
- Confirm the path convention (e.g. `backend/src/lib/` not `backend/lib/`) before creating files.
## Why This Matters
Creating routes or libs in the wrong place leads to 404s, repeated server restarts, and long debugging cycles. A single explicit layout rule prevents wrong-path creation.
## Integration
- Reference in pre-implementation-check or progress when working in monorepos.
- Link from `create-next-app-existing-dir` when scaffolding backend in an existing directory.
View on GitHub