CLAUDE.md

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

Camera Collector Agent Prompt

You are an expert software assistant working on the Camera Collector application, a FastAPI-based system for cataloging and managing vintage camera collections. Your task is to help analyze, debug, maintain, and enhance this codebase.

Documentation References

Before starting work, please review these important reference documents:

```
docs/agents/ARCHITECTURE.md
```
: Contains the system architecture, component structure, patterns, and best practices
```
docs/agents/API.md
```
: Details all API endpoints, request/response formats, and error handling
```
docs/agents/ENVIRONMENTS.md
```
: Describes all deployment environments and their configurations

Project Structure

The Camera Collector follows a layered architecture with these key components:

API Layer (
```
camera_collector/api/
```
): FastAPI routes and endpoints
Service Layer (
```
camera_collector/services/
```
): Business logic implementation
Repository Layer (
```
camera_collector/db/repositories/
```
): Data access abstraction
Models (
```
camera_collector/models/
```
): Core domain models
Schemas (
```
camera_collector/schemas/
```
): API request/response schemas

Development Guidelines

When working on this project:

Code Style: Follow PEP 8 guidelines with type annotations
API Changes: Maintain backward compatibility; document any breaking changes
Testing: Write tests for all new functionality or fixes
Error Handling: Use custom exception classes from
```
core/exceptions.py
```
Authentication: Understand the JWT authentication flow
Database: Use repository pattern for all database operations
Dependency Injection: Follow FastAPI's dependency injection pattern
Documentation: Update documentation when making significant changes

Common Tasks

Analysis

When analyzing the code:

Check the appropriate layer for the relevant functionality
Understand how components interact with each other
Review the existing patterns and follow them
Identify potential performance or security concerns

Debugging

When debugging issues:

Check the logs for error messages
Verify configurations across environments
Test endpoints with proper authentication
Check the database connection and queries
Validate request data against schemas
Review error handling across layers

Maintenance

When maintaining the codebase:

Refactor while preserving functionality
Upgrade dependencies with care
Improve test coverage for critical paths
Fix security vulnerabilities promptly
Enhance error handling and logging
Keep documentation up to date

Enhancement

When adding new features:

Follow existing architectural patterns
Implement in the appropriate layer(s)
Add comprehensive tests
Document new endpoints in API documentation
Update schemas for new data structures
Ensure backward compatibility
Consider cross-cutting concerns like security

Commands Reference

Setup:
```
poetry install --with dev
```

Run server:

poetry run python -m camera_collector.main

Format code:
```
poetry run black camera_collector tests
```

Lint:

poetry run ruff check camera_collector tests

Type check:
```
poetry run mypy camera_collector tests
```
Run all tests:
```
poetry run pytest
```

Run single test:

poetry run pytest tests/path/to/test_file.py::TestClass::test_function -v

Test with coverage:

poetry run pytest --cov=camera_collector --cov-report=term-missing

Project-Specific Conventions

Error Handling: All API errors use standardized format from
```
core/exceptions.py
```
Authentication: JWT tokens stored in Authorization header
Database: MongoDB accessed through repository pattern
Validation: All data validated with Pydantic models
Dependencies: Managed through FastAPI dependency injection
Configuration: Environment variables with
```
.env
```
files

Using these guidelines and the documentation references, you can effectively analyze, debug, maintain, and enhance the Camera Collector codebase while ensuring consistency and quality.

CLAUDE.md

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

Camera Collector Agent Prompt

Documentation References

Before starting work, please review these important reference documents:

```
docs/agents/ARCHITECTURE.md
```
: Contains the system architecture, component structure, patterns, and best practices
```
docs/agents/API.md
```
: Details all API endpoints, request/response formats, and error handling
```
docs/agents/ENVIRONMENTS.md
```
: Describes all deployment environments and their configurations

Project Structure

The Camera Collector follows a layered architecture with these key components:

API Layer (
```
camera_collector/api/
```
): FastAPI routes and endpoints
Service Layer (
```
camera_collector/services/
```
): Business logic implementation
Repository Layer (
```
camera_collector/db/repositories/
```
): Data access abstraction
Models (
```
camera_collector/models/
```
): Core domain models
Schemas (
```
camera_collector/schemas/
```
): API request/response schemas

Development Guidelines

When working on this project:

Code Style: Follow PEP 8 guidelines with type annotations
API Changes: Maintain backward compatibility; document any breaking changes
Testing: Write tests for all new functionality or fixes
Error Handling: Use custom exception classes from
```
core/exceptions.py
```
Authentication: Understand the JWT authentication flow
Database: Use repository pattern for all database operations
Dependency Injection: Follow FastAPI's dependency injection pattern
Documentation: Update documentation when making significant changes

Common Tasks

Analysis

When analyzing the code:

Check the appropriate layer for the relevant functionality
Understand how components interact with each other
Review the existing patterns and follow them
Identify potential performance or security concerns

Debugging

When debugging issues:

Check the logs for error messages
Verify configurations across environments
Test endpoints with proper authentication
Check the database connection and queries
Validate request data against schemas
Review error handling across layers

Maintenance

When maintaining the codebase:

Refactor while preserving functionality
Upgrade dependencies with care
Improve test coverage for critical paths
Fix security vulnerabilities promptly
Enhance error handling and logging
Keep documentation up to date

Enhancement

When adding new features:

Follow existing architectural patterns
Implement in the appropriate layer(s)
Add comprehensive tests
Document new endpoints in API documentation
Update schemas for new data structures
Ensure backward compatibility
Consider cross-cutting concerns like security

Commands Reference

Setup:
```
poetry install --with dev
```

Run server:

poetry run python -m camera_collector.main

Format code:
```
poetry run black camera_collector tests
```

Lint:

poetry run ruff check camera_collector tests

Type check:
```
poetry run mypy camera_collector tests
```
Run all tests:
```
poetry run pytest
```

Run single test:

poetry run pytest tests/path/to/test_file.py::TestClass::test_function -v

Test with coverage:

poetry run pytest --cov=camera_collector --cov-report=term-missing

Project-Specific Conventions

Error Handling: All API errors use standardized format from
```
core/exceptions.py
```
Authentication: JWT tokens stored in Authorization header
Database: MongoDB accessed through repository pattern
Validation: All data validated with Pydantic models
Dependencies: Managed through FastAPI dependency injection
Configuration: Environment variables with
```
.env
```
files

Using these guidelines and the documentation references, you can effectively analyze, debug, maintain, and enhance the Camera Collector codebase while ensuring consistency and quality.

CLAUDE.md

CLAUDE.md

Camera Collector Agent Prompt

Documentation References

Project Structure

Development Guidelines

Common Tasks

Analysis

Debugging

Maintenance

Enhancement

Commands Reference

Project-Specific Conventions

Related Skills

Nano Banana Pro

Markdown Converter

1password

CLAUDE.md

Camera Collector Agent Prompt

Documentation References

Project Structure

Development Guidelines

Common Tasks

Analysis

Debugging

Maintenance

Enhancement

Commands Reference

Project-Specific Conventions