Cerply Development Rules

Cerply is an adaptive learning platform built around the core principle: **Turn information into knowledge**.

Product Context

**Version:** 4.1 (Curator + Adaptive + Trust Labels + Analytics)

Core Features

1. **Curator Dashboard** - Content curation and management

2. **Adaptive Engine** - Personalized learning paths

3. **Trust Labels** - Content credibility system

4. **Analytics** - Learning insights and pilot metrics

Feature Flags

All new features must be gated behind environment variables:

Always check feature flags before implementing or modifying related code.

Definition of Done (DoD)

Every feature must meet these criteria before being considered complete:

1. Documentation

2. Database Layer

- `artefacts` - Learning content items

- `objectives` - Learning goals

- `items` - Discrete learning units

- `reviews` - User review records

- `attempts` - Learning attempt tracking

- `spaced` - Spaced repetition scheduling

- `QA groups` - Quality assurance groupings

3. API Routes

Implement required endpoints:

4. Services & Testing

5. Web Pages

Frontend pages must be created:

6. Demo Data

Development Workflow

When implementing new features:

1. **Check feature flags** - Verify the relevant feature flag is enabled

2. **Review RFC** - Ensure you understand the design decisions

3. **Database first** - Create migrations before implementing logic

4. **API layer** - Build and test API routes

5. **Service layer** - Implement business logic with unit tests

6. **Frontend** - Build UI components that consume the API

7. **Seed data** - Create demo data to showcase the feature

8. **Verify DoD** - Ensure all DoD criteria are met

When reviewing code:

Architecture Guidelines

Database Migrations

API Design

Service Layer

Frontend

Common Patterns

Feature Flag Check (Backend)

```typescript

if (!process.env.FF_CURATOR_DASHBOARD_V1) {

return res.status(404).json({ error: 'Feature not enabled' });

}

```

Feature Flag Check (Frontend)

```typescript

{process.env.NEXT_PUBLIC_FF_ADAPTIVE_ENGINE_V1 && (

<AdaptiveEngineComponent />

)}

```

Important Notes

Core Principle

Remember: **Turn information into knowledge**

Every feature should support this mission by helping users: