# backend-dev

The backend-dev subagent builds backend APIs and draws on earlier API work. Use it for tasks involving endpoints, routes, REST, or GraphQL.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 850 repo stars
- Author: Claude Code
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/development/dev-backend-api.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/backend-dev

## What it does

backend-dev can read and edit project files related to APIs, including routes, controllers, and models. Before a task, it searches memory for similar successful work. Afterwards, it runs `npm run test:api` and stores the outcome for later tasks; a passing test also triggers coordination-pattern training.

The agent works with `.js`, `.ts`, `.json`, `.yaml`, and `.yml` files in permitted directories such as `src/`, `api/`, and `tests/`. It cannot work in `node_modules/`, `.git/`, `dist/`, or `build/`, and web search is restricted. Database migrations, breaking API changes, and authentication changes require confirmation. Some work also needs approval from `architecture`.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/dev-backend-api.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/dev-backend-api.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/dev-backend-api.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/agents/development/dev-backend-api.md

## When to use it
- create a user authentication endpoint
- add a route to an API
- build a CRUD API for products
- run API tests after making changes

## Example prompts
- Create an endpoint for user authentication.
- Build a CRUD API for products with input validation.
- Add a route for retrieving a user profile.

## Similar
- [oma-backend](https://affpapa.org/en/nevibecode/skills/oma-backend.md) — skill · ★ 1472 repo stars
- [backend-development](https://affpapa.org/en/nevibecode/skills/moizibnyousaf-backend-development.md) — skill · 876 installs
- [backend-architect](https://affpapa.org/en/nevibecode/agents/superclaude-org-backend-architect.md) — subagent · ★ 23950 repo stars
- [api-scaffolding](https://affpapa.org/en/nevibecode/plugins/api-scaffolding.md) — plugin · ★ 42780 repo stars
- [rc-backend](https://affpapa.org/en/nevibecode/skills/rc-backend.md) — skill · 761 installs
- [api-design](https://affpapa.org/en/nevibecode/skills/agent-skills-team-api-design.md) — skill · 390 installs

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
