# Add Generation Event

> This skill covers the creation and management of Generation and GenerationEvent ORM models. Trigger: When working with generation data in the backend.

- Skill: `jnzader/add-generation-event` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jnzader/add-generation-event`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jnzader/add-generation-event/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: JNZader (https://skillmd.com/u/jnzader)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/jnzader/add-generation-event

---


<!-- L1:START -->
# add-generation-event

This skill covers the creation and management of Generation and GenerationEvent ORM models.

**Trigger**: When working with generation data in the backend.
<!-- L1:END -->

<!-- L2:START -->
## Quick Reference

| Task | Pattern |
|------|---------|
| Create a Generation | `create-generation` |
| Log a GenerationEvent | `log-generation-event` |

## Critical Patterns (Summary)
- **Create a Generation**: Use the Generation model to create new generation records.
- **Log a GenerationEvent**: Utilize the GenerationEvent model to log events related to generations.
<!-- L2:END -->

<!-- L3:START -->
## Critical Patterns (Detailed)

### Create a Generation

This pattern demonstrates how to create a new Generation record using the Generation model.

```python
from apps.server.app.models.generation import Generation
from uuid import uuid4
from datetime import datetime

new_generation = Generation(
    id=uuid4(),
    created_at=datetime.utcnow(),
    updated_at=datetime.utcnow()
)
```

### Log a GenerationEvent

This pattern shows how to log a GenerationEvent related to a specific Generation.

```python
from apps.server.app.models.generation import GenerationEvent
from uuid import uuid4
from datetime import datetime

event = GenerationEvent(
    id=uuid4(),
    generation_id=new_generation.id,
    event_time=datetime.utcnow(),
    description="Generation created"
)
```

## When to Use

- When you need to create a new generation record in the database.
- When logging events related to a specific generation for tracking purposes.

## Commands

```bash
python -m apps.server.app.models.generation
```

## Anti-Patterns

### Don't: Create Generation without Validation

Creating a Generation without proper validation can lead to data integrity issues.

```python
# BAD
new_generation = Generation(id=None)  # Missing required fields
```
<!-- L3:END -->
