a57fac7a78
* docs: add code comment guidelines to AGENTS.md Co-Authored-By: eunjae@cal.com <hey@eunjae.dev> * docs: extract comment guidelines into agents/rules and reference from AGENTS.md Co-Authored-By: eunjae@cal.com <hey@eunjae.dev> --------- Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Cal.com 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