Files
calendar/specs
Benny JooGitHubDevin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
ab21c7f805 refactor: Cal.diy (#28903)
* feat: Cal.diy — community-driven MIT-licensed fork of Cal.com

This squashed commit contains all Cal.diy changes applied on top of calcom/cal.com main:

- Rebrand Cal.com to Cal.diy across the entire codebase
- Remove Enterprise Edition (EE) features, license checks, and AGPL restrictions
- Switch license from AGPL-3.0 to MIT
- Remove docs/ directory (migrated to Nextra at cal.diy)
- Remove dead code: org tests, EE tips, platform nav, premium username, SAML/SSO, etc.
- Clean up .env.example for self-hosted Cal.diy
- Update Docker image references to calcom/cal.diy
- Update README, CONTRIBUTING.md, and issue templates for Cal.diy community fork
- Add PR welcome bot for Cal.diy contributors
- Fix API v2 breaking changes oasdiff ignore entries
- Replace Blacksmith CI runners with default GitHub Actions

3893 files changed, 20789 insertions(+), 411020 deletions(-)

Co-Authored-By: benny@cal.com <sldisek783@gmail.com>

* refactor: remove org-specific /organizations/:orgId endpoints from API v2 atoms controllers (#1701)

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

* fix: revert Cal.diy Inc to Cal.com, Inc. in license files, copyright notices, and package metadata (#1702)

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

* rip out org related comments in api v2

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-04-15 09:52:36 -03:00
..
2026-02-10 19:06:31 +00:00

Spec-First Development

This folder contains design documents for features in development. Claude reads these to understand what to build and track progress.

How It Works

  1. Before implementing a feature, create a spec folder with design docs
  2. Claude reads the design before writing any code
  3. Progress is tracked in implementation.md for session continuity
  4. Decisions are recorded in decisions.md for future reference
  5. Docs are generated with screenshots when feature is complete

Starting a New Feature

cp -r specs/_templates specs/{feature-name}

Then tell Claude:

"I want to build {feature}. Here's my idea: [description].
Review the codebase and fill in specs/{feature}/design.md"

File Structure

Each feature has:

File/Folder Purpose
CLAUDE.md Instructions for Claude when working on this feature
design.md Source of truth - what to build and how
implementation.md Progress tracking - what's done, in progress, blocked
decisions.md Architecture Decision Records (ADRs)
prompts.md Reusable prompts for common tasks
future-work.md Deferred ideas and enhancements
docs/ Internal documentation with screenshots
docs/screenshots/ Screenshots captured during development

Session Continuity

When starting a new Claude session:

"Continue working on {feature}"

Claude will read implementation.md to pick up where it left off.

Generating Documentation

When a feature is ready for documentation:

"Generate docs with screenshots for {feature}"

Claude will:

  1. Open the feature in browser
  2. Take screenshots of key UI states
  3. Save to specs/{feature}/docs/screenshots/
  4. Update specs/{feature}/docs/README.md

Promoting to Public Docs

When internal docs are ready for customers:

"Promote {feature} docs to public"

Claude will:

  1. Copy content to docs/{feature}.mdx (Mintlify format)
  2. Move screenshots to docs/images/{feature}/
  3. Update docs/mint.json navigation
  4. Adjust language for customer audience

The Most Important Rule

Every PR must be reviewable in under 10 minutes:

  • Max 5-7 files changed (excluding tests)
  • Max 500 lines changed
  • One focused change per PR

If your change is bigger, split it into multiple PRs.