Project Methodology

Separation of concerns

• Each agent has a single, focused purpose. This follows the recommended design pattern of granular plugins and minimal token usage.
• Common knowledge and reusable instructions are extracted into Skills. Skills provide progressive disclosure and are only loaded when needed.

Code conventions

• Backend: Use asynchronous FastAPI endpoints with dependency injection. SQLAlchemy models should be defined using declarative syntax. Pydantic schemas validate request and response data.
• Frontend: Build components with the Vue 3 Composition API. Use Pinia for state management and Tailwind CSS classes for styling. API calls should use relative paths (e.g. /api/tasks).
• Environment configuration: Use .env files and environment variables to configure database credentials, API URLs and other secrets. Do not commit secrets to version control.

Development tips

• Regularly run docker compose -f docker/docker-compose.yaml ps to check service health and docker compose -f docker/docker-compose.yaml logs -f to view logs. Stop services with docker compose -f docker/docker-compose.yaml down when done.
• When debugging, reproduce errors inside Docker to ensure environment consistency. Avoid running tests directly on your host machine unless you mirror the container setup.
• Document your changes as you go. Good documentation improves maintainability and helps others understand your design decisions.