Cal.diy Agent Documentation Index

• ../AGENTS.md - Main guide (structure, tech stack, commands, examples)
• commands.md - Command reference
• knowledge-base.md - Domain knowledge and business rules

Rules Index

Architecture

• architecture-vertical-slices - Vertical slice architecture
• architecture-feature-boundaries - Feature boundaries
• architecture-page-level-auth - Auth in page.tsx, not layout.tsx
• architecture-features-modules - packages/features vs apps/web/modules

Quality

• quality-avoid-barrel-imports - Avoid index.ts barrel imports
• quality-simplicity - Keep code simple
• quality-no-followup-prs - Complete work in PR
• quality-thorough-code-review - Code review standards
• quality-error-handling - ErrorWithCode vs TRPCError
• quality-imports - Import patterns and named exports
• quality-pr-creation - PR best practices
• quality-code-comments - Comment guidelines
• quality-code-review - Code review focus

Data Layer

• data-prefer-select-over-include - Use select in Prisma queries
• data-repository-pattern - Repository pattern
• data-repository-methods - Repository method standards
• data-dto-boundaries - DTO boundaries
• data-prisma-migrations - Schema changes and migrations
• data-prisma-feature-flags - Feature flag seeding

API

• api-no-breaking-changes - API stability
• api-thin-controllers - Thin controller pattern

Performance

• performance-avoid-quadratic - Avoid O(n²) algorithms
• performance-dayjs-usage - Day.js optimization
• performance-scheduling-complexity - Scheduling performance

Testing

• testing-coverage-requirements - Test coverage standards
• testing-playwright - Playwright test execution
• testing-mocking - Mock services and integrations
• testing-timezone - Timezone handling (TZ=UTC)
• testing-incremental - Incremental test fixing

CI/CD

• ci-check-failures - Handling CI failures
• ci-type-check-first - Type-check before tests
• ci-git-workflow - Git and CI workflow

Patterns

• patterns-dependency-injection - DI patterns
• patterns-factory-pattern - Factory pattern
• patterns-workflow-triggers - Workflow implementation
• patterns-app-store - App store integration patterns
• patterns-trigger-dev - Trigger.dev task implementation

Culture

• culture-accountability - Engineering accountability
• culture-leverage-ai - AI tooling practices

Reference

• reference-file-locations - Key file paths
• reference-local-dev - Local development setup