mcpField
A
atlas-best-practices

atlas-best-practices

github.com/alleneubankData & databases50211 installsUpdated 18w ago
Repository

About atlas-best-practices

Atlas Best Practices is a reference skill for choosing and safely running Atlas database schema workflows. It covers declarative, versioned, and baseline approaches, with guidance on planning, validation, and deployment safeguards.

Key features

  1. 01Choose declarative, versioned, or baseline workflows
  2. 02Plan before applying schema changes
  3. 03Lint, test, and validate migrations
  4. 04Use CI/CD or approved production deployment
  5. 05Apply safeguards for credentials and destructive changes

Use cases

  1. 01Select a schema workflow for a project
  2. 02Onboard an existing database
  3. 03Review migrations before deployment
  4. 04Avoid unsafe production schema changes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/alleneubank/claude-code --skill atlas-best-practices

After installing, type/atlas-best-practicesin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
atlas-v1-1-features.md
cli-agent-gaps.md
core-workflows.md
safety-and-quality.md

Details

From the project README

Atlas Best Practices

Atlas supports declarative and versioned schema workflows. Keep this file minimal and load only the reference file needed for the current task.

Workflow Selection

  • Use declarative workflow when desired schema state is the source of truth.
  • Use versioned workflow when migration files are required for auditing and staged deployments.
  • Use baseline workflow when onboarding an existing database.

Default Execution Flow

  1. Confirm the target env in atlas.hcl.
  2. Confirm dev is configured and isolated from production.
  3. Plan first, then lint/test/validate, then apply.
  4. Run production changes through CI/CD or approved deployment workflow.

Quick Commands

# Declarative
atlas schema apply --env local

# Versioned
atlas migrate diff add_change --env local
atlas migrate lint --env local --latest 1
atlas migrate apply --env local

# Integrity
atlas migrate validate --env local
atlas migrate status --env local

Reference Map

  • core-workflows.md Use for environment config, schema-as-code patterns, declarative vs versioned workflows, baselining, and ORM provider loading.
  • safety-and-quality.md Use for lint analyzers, transaction modes, schema tests, pre-execution checks, and CI patterns.
  • atlas-v1-1-features.md Use for Atlas v1.1 coverage (released on 2026-02-03), including security as code, declarative data, new drivers/platform support, Slack integration, schema exporters, and MySQL TLS.
  • cli-agent-gaps.md Use for Atlas CLI capabilities and edge cases agents often miss: planning workflows, migration directory maintenance commands, URL/TLS pitfalls, feature availability, and version policy constraints.

Guardrails

  • Keep credentials out of source files; prefer Atlas data sources and input variables.
  • Require explicit review for destructive or data-dependent migrations.
  • Fail loudly on unsupported drivers, missing dev URLs, or unknown environment names.

Comments

Markdown supported