# Orchestrate Production API Development

Production API builds need clear roles, tests, and deployment gates. This skill organizes agents through planning, TDD implementation, validation, documentation, and blue-green release.

## Install

```bash
npx skillstore add dnyoussef/when-building-backend-api-orchestrate-api-development
```

## Metadata

- Status: approved
- Slug: dnyoussef-when-building-backend-api-orchestrate-api-development
- Skillstore revision: r1
- Version status: missing
- Tree hash: 47df7d4abba5986199661f36eaebceb421675305bde783d1890e5d21afe88f52
- Author: DNYoussef
- GitHub username: DNYoussef
- License: MIT
- Repository: https://github.com/DNYoussef/ai-chrome-extension/tree/main/.claude/skills/when-building-backend-api-orchestrate-api-development
- Ref: c579efd02184f1128d6741d16e6c8d951d7d4208
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, filesystem, env\_access
- Quality score: 76
- Public page: https://skillstore.pages.dev/skills/dnyoussef-when-building-backend-api-orchestrate-api-development
- Manifest: https://skillstore.pages.dev/api/skills/dnyoussef-when-building-backend-api-orchestrate-api-development/manifest

## Capabilities

- Defines a five-phase REST API workflow from requirements through monitoring.
- Assigns product, architecture, database, QA, security, DevOps, and documentation roles.
- Provides TDD steps for RED, GREEN, and REFACTOR implementation cycles.
- Specifies validation gates for coverage, security, performance, documentation, and release readiness.
- Includes a GraphViz process diagram for workflow visualization.

## Use Cases

- Plan a new service API: Turn requirements into endpoints, data models, OpenAPI contracts, and a test strategy.
- Coordinate TDD implementation: Guide backend, testing, and review agents through repeatable endpoint delivery cycles.
- Prepare release validation: Organize security checks, performance tests, documentation, deployment, rollback, and monitoring tasks.

## Prompt Templates

### Start an API plan

```
Use this workflow to plan a REST API for my product. Define phases, agents, main deliverables, and first decisions.
```

### Design endpoints and tests

```
Apply the workflow to my requirements. Produce endpoint groups, data model tasks, OpenAPI tasks, and TDD test coverage goals.
```

### Run a TDD delivery cycle

```
Coordinate tester, backend developer, and reviewer agents for these endpoints. Keep the RED, GREEN, and REFACTOR outputs separate.
```

### Validate production readiness

```
Use the deployment phase to create a release readiness review with security, performance, documentation, rollback, and monitoring gates.
```

## Limitations

- Does not implement an API without an agent runtime and project context.
- Assumes access to claude-flow, test tools, deployment tools, and target infrastructure.
- Command examples require review before use in production systems.
- Uses generic Node.js and Kubernetes examples that may need adaptation.

## Best Practices

- Confirm requirements, data ownership, and security needs before starting implementation.
- Keep every endpoint inside a visible RED, GREEN, and REFACTOR cycle.
- Review deployment commands against the target environment before execution.

## Anti Patterns

- Skipping OpenAPI design and writing endpoints without a shared contract.
- Treating generated command examples as production commands without review.
- Moving to deployment before security, performance, documentation, and rollback gates pass.

## Security Audit

- Audited at: 2026-07-05T13:59:48.543\+00:00
- Summary: The audit reviewed SKILL.md and the GraphViz process file. All static findings were false positives from Markdown formatting, example shell commands, sample API code, or diagram labels. No evidence found of prompt injection, credential exfiltration, hidden network calls, or installer scripts.

## Stats

- Views: 233
- Downloads: 9
- Favorites: 0
- Popularity score: 0