# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

This is a Django 5.2.7 project named "executor" using Python 3.13+ with a minimal configuration. It's a fresh Django project with only the default Django applications installed and no custom apps yet.

## Development Commands

### Environment Setup
```bash
# Activate virtual environment (if using .venv)
source .venv/bin/activate

# Install dependencies
uv sync
```

### Django Commands
```bash
# Run development server
python manage.py runserver

# Database migrations
python manage.py makemigrations
python manage.py migrate

# Create superuser
python manage.py createsuperuser

# Django shell
python manage.py shell

# Run tests
python manage.py test

# Collect static files
python manage.py collectstatic
```

## Project Structure

- **executor/**: Main Django project directory containing settings, URLs, and WSGI/ASGI configuration
- **templates/**: Global template directory (currently empty)
- **db.sqlite3**: SQLite database file
- **manage.py**: Django management script
- **pyproject.toml**: Project dependencies managed by uv
- **uv.lock**: Dependency lock file

## Architecture Notes

- Uses SQLite as the default database
- Templates directory is configured at the project root level
- Standard Django project layout with no custom applications yet
- Secret key is currently set to Django's insecure default (should be changed for production)
- Debug mode is enabled (development configuration)

## Development Workflow

This appears to be a new Django project. When adding new functionality:
1. Create Django apps using `python manage.py startapp <app_name>`
2. Add new apps to `INSTALLED_APPS` in `executor/settings.py`
3. Create models, views, and URL patterns within the apps
4. Run migrations after model changes
5. Add templates to either app-specific template directories or the global `templates/` directory