claudekit

### Claudekit Code Generation & Optimization for a Python REST API

**Task:** Build a scalable FastAPI backend for a task management app with PostgreSQL integration.

**Step 1: Generate Initial Code Structure**
```bash
claude generate-api --framework fastapi --db postgresql --name task-manager
```
Output:
```python
# task_manager/main.py
from fastapi import FastAPI
from task_manager.routers import tasks

app = FastAPI()
app.include_router(tasks.router)
```

**Step 2: Optimize Performance**
```bash
claude optimize-code --language python --target performance --file task_manager/main.py
```
Optimized output:
```python
# Added async support and connection pooling
from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware
from task_manager.routers import tasks
from task_manager.db import get_db

app = FastAPI()
app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],
    allow_methods=["*"],
)
```

**Step 3: Generate Unit Tests**
```bash
claude generate-tests --language python --coverage 90 --file task_manager/routers/tasks.py
```
Test output:
```python
# tests/test_tasks.py
from fastapi.testclient import TestClient
from task_manager.main import app

client = TestClient(app)

def test_create_task():
    response = client.post("/tasks", json={"title": "Test Task"})
    assert response.status_code == 201
    assert response.json()["title"] == "Test Task"
```

**Step 4: Generate Documentation**
```bash
claude generate-docs --format openapi --file task_manager/main.py --output docs/api.yaml
```
Documentation snippet:
```yaml
# docs/api.yaml
paths:
  /tasks:
    post:
      summary: Create a new task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Task'
      responses:
        '201':
          description: Task created successfully
```

**Final Output:**
- Generated 8 API endpoints
- Optimized database queries with async/await
- Achieved 92% test coverage
- Auto-generated OpenAPI 3.1 docs