Add GitHub Copilot instructions and agent configuration for Celery/Django patterns

[Copilot]

Documents repository conventions for the Django+Celery task processing system to enable better AI-assisted development and faster developer onboarding.

Files Added

.github/copilot-instructions.md (271 lines)

• Repository architecture: Django app with Celery workers, MySQL, Redis
• Task organization: impresso/tasks/ for Celery decorators, impresso/utils/tasks/ for helpers
• Job tracking pattern: update_job_progress(), is_task_stopped()
• Logging convention: f"[job:{job.pk} user:{user.pk}] message"

.github/agents/celery-tasks.md (424 lines)

• Task definition patterns with retry logic and exponential backoff
• Job progress tracking through database and Redis state updates
• User access control via bitmap masks and group membership

.github/agents/testing.md (590 lines)

• TestCase vs TransactionTestCase usage for signal/transaction testing
• Email testing with mail.outbox inspection patterns
• Celery task testing with synchronous execution in test environment
• Mocking strategies for SMTP dependencies

.github/agents/django-development.md (666 lines)

• Model patterns with Profile/UserBitmap relationships
• Admin customization: list displays, actions, field organization
• Management command structure with argument parsing and error handling
• Signal registration for user creation (Profile/UserBitmap auto-creation)

.github/agents/documentation.md (677 lines)

• Google-style docstring conventions for Python code
• Environment variable documentation tables
• Setup/deployment guide structure
• Troubleshooting patterns for common issues (DB connection, Redis, Celery workers)

.github/README.md (94 lines)

• Overview of instruction file purposes and usage

Key Patterns Documented

Celery Task Structure:

@shared_task(
    bind=True,
    autoretry_for=(Exception,),
    exponential_backoff=2,
    retry_kwargs={"max_retries": 5},
    retry_jitter=True,
)
def task_name(self, job_id: int):
    job = Job.objects.get(pk=job_id)
    update_job_progress(task=self, job=job, progress=0.5, ...)
    if is_task_stopped(task=self, job=job, ...):
        return

User Permission Enforcement:

user_bitmask = BitMask64(job.creator.profile.user_bitmap_key)
# User bitmap access controls for permissions

Documentation focuses on current active tasks: user account management, email notifications, user permissions (UserBitmap), special membership requests, and plan change requests.

Updates

Updated documentation to reflect removal of collection and export tasks from develop branch. Removed references to:

• Solr integration patterns
• Collection management tasks
• CSV/ZIP export functionality
• Related pagination helpers and utility modules

Total: ~2,400 lines documenting conventions specific to this Django+Celery architecture for user management and background task processing.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>setup AGENTS and copilot instructions</issue_title>
<issue_description>
This repository uses Celery as the background task processing system for the Django application (see tasks and related modules)
This document describes the available agents (workers), their responsibilities, and conventions for adding new tasks.
</issue_description>

<agent_instructions>add convenient files for Agents and specify relevant sections. You can use tests to see potentialities of this repository.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes setup AGENTS and copilot instructions #131

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[danieleguido]

@copilot develop branch changed, I've removed all tasks related to collections and exports, can you update the agents?

[danieleguido]

@copilot develop branch changed, I've removed all tasks related to collections and exports, can you update the agents?

[Copilot]

@copilot develop branch changed, I've removed all tasks related to collections and exports, can you update the agents?

Updated the agent documentation to remove all collection and export task references. The changes include:

• Removed Solr integration documentation
• Removed collection management and CSV/ZIP export patterns
• Updated task module lists to only include active tasks (account, userBitmap, email, userSpecialMembershipRequest)
• Removed references to deleted utility modules (collection.py, export.py, textreuse.py)
• Updated management commands to only list existing ones

Commit: af69589