crossfit/AGENTS.md

Qwen Code Agent Configuration

This file configures the behavior and preferences for the Qwen Code agent for this specific project.

Project Context

• Name: CrossFit Scheduler
• Primary Language: Python
• Key Technologies: Python scripts, JSON, Docker
• Purpose: Automates booking CrossFit classes based on user preferences.

Agent Interaction Preferences

Code Style & Conventions

• Follow PEP 8 for Python code.
• Use clear, descriptive variable and function names.
• Prefer explicit over implicit code.
• Use docstrings for modules, classes, and functions.
• Keep functions small and focused on a single task.

Project Structure Awareness

• main.py: Entry point for the application.
• execute_book_session.py: Alternative execution script for booking sessions.
• preferred_sessions.json: User preferences for session booking.
• src/: Directory for source code modules.
  • auth.py: Authentication handling with bearer token management.
  • booker.py: Main booking logic with time-based booking windows.
  • session_manager.py: Session fetching, filtering, and booking operations.
  • session_notifier.py: Email and Telegram notifications for booking status.
  • session_config.py: Configuration for preferred session matching.
  • test_book_session.sh: Shell script for testing session booking.
• requirements.txt: Python dependencies.
• Dockerfile and docker-compose.yml: Container configuration.

Preferred Tools & Commands

• Use pytest for running tests.
• Use docker compose for container orchestration.
• Use python for running scripts.
• Refer to requirements.txt for dependencies.

Communication Style

• Be concise and direct.
• Use markdown for formatting responses.
• Prioritize clarity and correctness.
• Avoid unnecessary explanations or chit-chat.

Testing & Verification

• Always run tests after making changes.
• Use pytest.ini for test configuration.
• Ensure Docker containers are properly configured before running.
• Verify JSON files are correctly formatted.

Security & Best Practices

• Never commit sensitive information like passwords or API keys.
• Use .env files for environment variables.
• Follow Docker best practices for containerization.
• Keep dependencies up to date.

Custom Instructions

• When modifying preferred_sessions.json, ensure the structure remains valid.
• When writing shell scripts, ensure they are executable and follow best practices.
• When creating new Python files, ensure they are properly formatted and tested.
• Environment variables required: CROSSFIT_USERNAME, CROSSFIT_PASSWORD, plus optional email/telegram settings.
• Booking window controlled by TARGET_RESERVATION_TIME (default: "20:01") and BOOKING_WINDOW_END_DELTA_MINUTES (default: 10).