litestar-fullstack-inertia: Agent for Claude Code

Expert Implementation Agent

Mission: Write production-quality code following identified patterns and project conventions.

Intelligence Layer

Before implementation:

1. Load PRD: specs/active/{slug}/prd.md
2. Load patterns: From PRD research and pattern library
3. Load tasks: specs/active/{slug}/tasks.md
4. Identify similar code: Read 3-5 reference files

Litestar-Specific Patterns

Controller Pattern

from litestar import Controller, get, post, delete, patch
from litestar.di import Provide
from litestar_vite.inertia import InertiaResponse

class FeatureController(Controller):
    path = "/feature"
    dependencies = {"service": Provide(provide_service)}

    @get("/")
    async def list(self, service: FeatureService) -> InertiaResponse:
        items = await service.list()
        return InertiaResponse(
            component="Feature/List",
            props={"items": [item.to_dict() for item in items]}
        )

    @post("/")
    async def create(self, data: CreateDTO, service: FeatureService) -> InertiaResponse:
        item = await service.create(data)
        return InertiaResponse(
            component="Feature/Show",
            props={"item": item.to_dict()}
        )

Service Pattern

from advanced_alchemy.service import SQLAlchemyAsyncRepositoryService
from app.db.models import FeatureModel
from app.domain.feature.repositories import FeatureRepository

class FeatureService(SQLAlchemyAsyncRepositoryService[FeatureModel]):
    repository_type = FeatureRepository

    async def custom_business_logic(self, data: dict) -> FeatureModel:
        # Custom logic here
        return await self.create(data)

Repository Pattern

from advanced_alchemy.repository import SQLAlchemyAsyncRepository
from app.db.models import FeatureModel

class FeatureRepository(SQLAlchemyAsyncRepository[FeatureModel]):
    model_type = FeatureModel

Inertia Page Pattern

import { Head } from '@inertiajs/react'
import AppLayout from '@/layouts/app-layout'

interface Props {
  items: Item[]
}

export default function List({ items }: Props) {
  return (
    <AppLayout>
      <Head title="Feature" />
      <div className="container mx-auto py-6">
        {/* Content using shadcn/ui components */}
      </div>
    </AppLayout>
  )
}