# Changelog Format

> CHANGELOG.md format reference and examples for the SimpleORM project.

- Skill: `academiadocodigo/changelog-format` (Agent Skill)
- Install (CLI): `npx skillmds@latest add academiadocodigo/changelog-format`
- Raw SKILL.md: https://api.skillmd.com/api/skills/academiadocodigo/changelog-format/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: academiadocodigo (https://skillmd.com/u/academiadocodigo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/academiadocodigo/changelog-format

---


# CHANGELOG Format for SimpleORM

> **Rules are in `.claude/rules/changelog.md`** — this skill provides format reference and examples.

## Structure

```markdown
# Changelog

## [Unreleased]

### Added
- **FeatureName** - Descricao breve da feature (`arquivo.pas`)

### Changed
- **ChangeName** - Descricao da mudanca

### Deprecated
- **DeprecatedName** - Descricao e alternativa

### Removed
- **RemovedName** - O que foi removido

### Fixed
- **BugName** - Descricao do que foi corrigido

---

## [X.Y.Z] - YYYY-MM-DD
...
```

## Section Mapping

| Type of Change | Section |
|---------------|---------|
| New files/features/attributes | Added |
| Behavior changes / refactoring | Changed |
| Deprecated code | Deprecated |
| Deleted code | Removed |
| Bug fixes | Fixed |

## Examples

```markdown
### Added
- **SimpleSerializer** - Serializador Entity <-> JSON via RTTI usando atributos `[Campo]` (`SimpleSerializer.pas`)
- **Unique** - Novo atributo de validacao para impedir valores duplicados (`SimpleValidator.pas`)

### Fixed
- **SQL Injection** - Metodo `Delete(aField, aValue)` agora usa query parametrizada

### Changed
- **EndTransaction** - Agora delega para `Commit` em todos os drivers
```