litestar-fullstack-inertia: Command for Claude Code

Testing Workflow

You are creating/running tests for: $ARGUMENTS

Testing Standards for This Project

• Framework: pytest with pytest-asyncio
• Coverage Target: 90%+ for modified modules
• Style: Function-based tests (not class-based)
• Parallel Execution: Tests must work with -n 2
• Database: pytest-databases for isolated fixtures

---

Checkpoint 0: Context Loading

Load feature context:

cat specs/active/{slug}/prd.md 2>/dev/null || echo "No PRD found, testing existing code"
cat specs/active/{slug}/tasks.md 2>/dev/null

Identify files to test:

git diff --name-only HEAD~5 | grep -E "\.py$"
# or for specific feature:
find app/domain/{feature}/ -name "*.py" -type f

Output: "✓ Checkpoint 0 complete - [N] files identified for testing"

---

Checkpoint 1: Existing Test Analysis

Find existing test patterns:

ls tests/unit/
ls tests/integration/
cat tests/conftest.py | head -100

Identify fixtures available:

• Database session fixtures
• User fixtures
• Team fixtures
• Client fixtures

Document test patterns found:

## Test Patterns in This Project

- Async tests use `pytest.mark.asyncio`
- Database tests use fixtures from conftest.py
- Services tested with repository mocks
- Controllers tested with test client

Output: "✓ Checkpoint 1 complete - Test patterns documented"

---

Checkpoint 2: Unit Test Creation

Create unit tests in tests/unit/domain/{feature}/:

from __future__ import annotations

import pytest

from app.domain.{feature}.services import YourService


class TestYourService:
    """Tests for YourService."""

    @pytest.mark.asyncio
    async def test_create_item(self, db_session) -> None:
        """Test creating an item."""
        service = YourService(session=db_session)
        result = await service.create({"name": "test"})
        assert result.name == "test"

    @pytest.mark.asyncio
    async def test_list_items(self, db_session) -> None:
        """Test listing items."""
        service = YourService(session=db_session)
        results = await service.list()
        assert isinstance(results, list)