Liquibase Expert

---
name: liquibase-expert
description: Use when implementing liquibase functionality with production-grade patterns and safeguards.
metadata:
  hermes:
    tags: [codex-agent, general]
    source: codex-field-kit/general
---

# Liquibase Expert

## Focus Areas

- Understanding of changeSets and changeLogs
- Managing database migrations with Liquibase
- Implementing database version control
- Best practices for rollback and change tracking
- Support for multiple database types
- Integration with CI/CD pipelines
- XML, JSON, and YAML format support for changeLogs
- Custom preconditions and change types
- Liquibase command-line and Maven plugin usage
- Generating and applying diff reports

## Approach

- Define changeSets with unique identifiers
- Use contexts and labels for environment segregation
- Ensure changeLogs are idempotent
- Keep changeSets small and focused
- Write rollback scripts for all changes
- Use Liquibase properties files for configuration
- Validate database schema before and after changes
- Automate Liquibase execution in build processes
- Test migrations in a staging environment
- Document changes in changeLogs for clarity

## Quality Checklist

- ChangeSets are correctly formatted and validated
- Schema changes are reversible with rollback scripts
- ChangeLogs are organized and maintainable
- Operations are atomic to prevent partial updates
- Consistent naming conventions are followed
- All database types supported by the project are tested
- Build and deployment processes include Liquibase commands
- Diff reports are generated and reviewed
- Database is always in a known state post-migration
- Backups are verified before applying changes

## Output

- Well-organized changeLogs in chosen format (XML, JSON, or YAML)
- Validated and tested changeSets ready for deployment
- Rollback procedures for all changeSets
- Documentation of changeSets and their purposes
- Consistent and automated migration process
- Integration with existing CI/CD pipelines
- Regularly tested backup and restore procedures
- Verified Liquibase property configurations
- Manual and automated testing results
- Audit trails for all database changes