API Development Kit

Complete toolkit for building and documenting RESTful APIs with automated testing and documentation generation. Perfect for backend developers starting new API projects.

## Features

- Complete API development workflow
- Automated documentation generation
- Built-in testing and debugging tools
- REST API design best practices

## Use Cases

- Building new REST APIs from scratch
- Standardizing API development across teams
- Learning API development best practices
- Rapid prototyping of API endpoints

## TL;DR

A collection of four HeyClaude resources for REST API development with Claude Code: the api-builder-agent plus the docs, generate-tests, and debug commands. Install them in the recommended order to scaffold an API, generate documentation, create tests, and debug requests.

- An API-builder agent to scaffold REST endpoints
- A docs command for generating API documentation
- A generate-tests command for creating test suites
- A debug command for tracing API requests

## Collection Overview

**Collection Type:** Development Resources\n**Focus Area:** REST API Development\n**Skill Level:** Beginner\n**Resource Count:** 4 items (1 agent, 3 commands)

## What's Included

## Collection Contents

Essential resources for rapid API development

- **api-builder-agent** (Agent): Scaffolds REST API endpoints and structure with Claude Code.
- **docs** (Command): Generates API documentation for your project.
- **generate-tests** (Command): Creates test suites for your API code.
- **debug** (Command): Helps trace and debug API requests.

## Quick Start

Browse the collection to find the resources most relevant to your API development needs. Each item includes detailed usage instructions and can be customized for your specific requirements.

## Prerequisites

- Node.js 18 or higher
- Basic understanding of REST API concepts
- Code editor with Claude integration

## Recommended Order

1. `api-builder-agent`
2. `docs`
3. `generate-tests`
4. `debug`

## Troubleshooting

### API Builder agent conflicts with existing test framework

Install items in the specified order: api-builder-agent first, then docs, generate-tests, debug. Run npm ls to verify no peer dependency conflicts between generated code and test framework.

### Documentation generation fails after installing debug command

Ensure all items share compatible Node.js versions. Check package.json engines field across agent and commands. Reinstall docs command after verifying Node 18+ is active.

### Missing test dependencies when using generate-tests command

Install testing framework before collection setup. Run npm install jest @types/jest or your preferred test runner. Then reinstall generate-tests command to detect framework.

### Installation order not followed causing endpoint conflicts

Uninstall all collection items using Claude Code settings. Reinstall strictly following installationOrder array: api-builder-agent, docs, generate-tests, debug. Restart Claude after each.

### Debug command cannot trace requests from API Builder agent

Enable request logging in API Builder agent settings first. Install debug command last to allow proper hook integration. Verify both items are enabled in Claude Code preferences.