Claudacity Development Guide

A comprehensive development workflow skill for the Claudacity project (Claude Ollama API Server). This skill ensures proper testing, service management, and adherence to project-specific patterns when working on the codebase.

What This Skill Does

This skill guides AI agents through the specific development practices required for the Claudacity project, including:

Instructions

When working on the Claudacity codebase, follow these guidelines strictly:

1. Testing Protocol

**CRITICAL**: After making any code changes, always test A/B against Ollama.

Example testing workflow:

```bash

Run unified tests

python tests/unified_test.py

Or run specific test suites

python tests/test_ollama_compat.py

python tests/test_claude_integration.py

```

2. Service Management

**CRITICAL**: Always use the service scripts for service operations. Never manually kill processes or use ad-hoc commands.

Correct service management:

```bash

Restart the service (REQUIRED before testing)

python claude_service.py --restart

Start the service

python claude_service.py --start

Stop the service

python claude_service.py --stop

```

3. Log Management

When debugging or checking logs:

4. Code Patterns

**CRITICAL**: All code must be async.

Example - WRONG:

```python

import requests

response = requests.get(url)

```

Example - CORRECT:

```python

import aiohttp

async with aiohttp.ClientSession() as session:

async with session.get(url) as response:

data = await response.json()

```

5. Context Documentation

The `context/` directory contains critical documentation. Always read relevant context files before making changes:

**Before modifying code**:

1. Identify which context files are relevant

2. Read them thoroughly

3. Follow established patterns

6. Port Information

Be aware of port assignments when testing:

7. Development Workflow

Complete workflow for making changes:

1. **Read context** - Review relevant `.md` files in `context/` directory

2. **Make changes** - Follow async patterns, use `aiohttp`

3. **Restart service** - `python claude_service.py --restart`

4. **Clear logs** - `rm logs/*.log` (optional but recommended)

5. **Run tests** - Execute unified testing framework

6. **Check logs** - Review `logs/` directory for errors

7. **Verify A/B** - Ensure both Ollama and Claude work correctly

8. Testing Framework

Use the unified testing framework to ensure compatibility:

Constraints

Notes

This skill is specifically designed for the Claudacity project. The strict testing and service management requirements exist because: