executor/CLAUDE.md

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

# Activate virtual environment (if using .venv)
source .venv/bin/activate

# Install dependencies
uv sync

Django Commands

# 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