Skip to content

docs: update migration documentation for registry pattern#2362

Merged
Yeraze merged 1 commit intomainfrom
docs/update-migration-docs
Mar 21, 2026
Merged

docs: update migration documentation for registry pattern#2362
Yeraze merged 1 commit intomainfrom
docs/update-migration-docs

Conversation

@Yeraze
Copy link
Copy Markdown
Owner

@Yeraze Yeraze commented Mar 21, 2026

Summary

Updates migration documentation across CLAUDE.md and ARCHITECTURE_LESSONS.md to reflect the current migration registry system (src/db/migrations.ts).

Changes

  • CLAUDE.md: Replaced outdated "add to 3 places in database.ts" instructions with migration registry pattern, including step-by-step guide and current migration count (013)
  • docs/ARCHITECTURE_LESSONS.md: Added new "Migration Registry System" section under Multi-Database Architecture with full architecture diagram, example migration code for all 3 backends, and key rules (idempotency, column naming, test updates)

Why

The old docs referenced a migration pattern that no longer exists (manual imports in database.ts). The project moved to a centralized MigrationRegistry system but the docs weren't updated, leading to confusion when adding new migrations.

🤖 Generated with Claude Code

- CLAUDE.md: Replace old "3 places in database.ts" pattern with
  migration registry instructions and current migration count (013)
- ARCHITECTURE_LESSONS.md: Add Migration Registry System section
  with full pattern, example code, and key rules

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@Yeraze Yeraze merged commit 4e26133 into main Mar 21, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant