migration-architect

migration-architect is a skill for Claude Code, Codex from event4u-app/agent-config. It costs 41 tokens per session (1,041 once invoked), scanned A, original, MIT.

A planning guide for complex migrations that change data, services, or APIs across multiple deployments.

In plain words
What is it for?
Use it to define migration phases, temporary compatibility periods, service update order, and the process for retiring old fields, tables, or APIs.
Why use it?
It reduces the risk of breaking users or dependent systems during backfills, dual writing, cutovers, deprecations, and coordinated releases.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/event4u-app/agent-config/migration-architect
Any agent
npx skills add event4u-app/agent-config --skill migration-architect
Clone the repo
git clone --depth 1 https://github.com/event4u-app/agent-config

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for migration-architect

README.md
[![agentmods](https://agentmods.dev/badge/skills/event4u-app/agent-config/migration-architect.svg)](https://agentmods.dev/skills/event4u-app/agent-config/migration-architect)
Your own site
<a href="https://agentmods.dev/skills/event4u-app/agent-config/migration-architect"><img src="https://agentmods.dev/badge/skills/event4u-app/agent-config/migration-architect.svg" alt="Measured on agentmods" height="20"></a>
Per session 41 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,041 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00041 $0.01041
Opus 5 $0.00020 $0.00521
Sonnet 5 $0.00008 $0.00208
Haiku 4.5 $0.00004 $0.00104

Measured yesterday against content hash 55dff9be628a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

migration-architect scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

src/skills/migration-architect/SKILL.md · 126 lines

How it starts

The opening of the file, as written. The whole thing — 126 lines — stays where its author put it; the contents beside it link to each section on GitHub.

migration-architect

Shape the rollout strategy for a migration before any DDL or code is written. Plans phases, dual-write windows, cutover sequencing, deprecation cycles, and cross-service coordination. Hands off to laravel-migration (or the framework-native equivalent) for tactical DDL once the plan is locked.

When to use

  • A schema change spans more than one deploy.
  • A change requires a dual-write or backfill window.
  • The migration touches multiple services, queues, or consumers whose order of update matters.
  • A column / table / API is being deprecated and the cycle needs shape (announce → soft-fail → hard-fail → remove).

Do NOT use when:

  • The change is a single additive migration safe in one deploy → route to laravel-migration (or framework-native equivalent).
  • The decision is whether to migrate at all → route to decision-record first.
  • The concern is data correctness during the migration → route to data-flow-mapper and feed findings back here.

Procedure

1. Anchor on the goal

Write one sentence: "State X must become state Y across systems Z without breaking consumers W." If you cannot, the migration is not ripe — stop.

2. Identify the participating systems

List every service, queue, batch job, third-party consumer, and client that reads or writes the affected schema. A system you forget is a cutover surprise.

3. Pick a rollout shape

Shape When to pick
Expand → migrate → contract Schema additive first, code switches reads, then drop old shape
Dual-write + backfill Both shapes written for a window; backfill closes the gap
Strangler fig New path runs alongside old; traffic ramps over time
Big-bang cutover Rare; only when downtime is acceptable AND coordination cost is trivial

State why the shape fits — not just which one was picked.

Read the full file on GitHub · 126 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 126 lines · 41 tokens per session scan A 55dff9be628a

Subscribe to this mod's changes

migration-architect is a skill published in the GitHub repository event4u-app/agent-config (10 stars, last pushed today), licensed MIT. It adds 41 tokens to every session and 1,041 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-04.

Related

Other skills, from other repositories

architect/data-api-design

Skill "architect/data-api-design" from echoVic/boss-skill, covering 数据模型与api设计方法论, 适用场景, 数据模型设计, 1. 实体识别 and 2. 关系识别.

echoVic/boss-skill · 26 tokens

mongodb-schema-design

MongoDB schema design patterns and anti-patterns. Use when designing data models, reviewing schemas, migrating from SQL, or troubleshooting performance issues caused by schema problems. Triggers on "design schema", "embed vs reference", "MongoDB data model", "schema review", "unbounded arrays", "one-to-many", "tree…

fcakyon/claude-codex-settings · 127 tokens

solr-semantic-search

To build Solr phrase-tagging semantic search: concept tagging, taxonomy, graph paths.

griddynamics/rosetta · 24 tokens

qdrant-hybrid-search-prefetches

Constructing prefetch queries for hybrid retrieval, including sparse/dense and multi-field setups, and choosing a sparse embedding model. Use when someone asks 'dense and sparse in one search?', 'how to combine multiple fields for retrieval?', 'payloads or sparse vectors for lexical?', 'which sparse embedding model to…

qdrant/skills · 81 tokens

qdrant-multitenancy

Guides tenant isolation architecture in Qdrant for multi-tenant or multi-user applications. Use when someone asks 'how to isolate customer data', 'how to build multi-tenant search/RAG', 'how many collections should I create', 'how to partition tenants by payload', 'a customer's data legally has to stay in a certain…

qdrant/skills · 109 tokens

qdrant-sliding-time-window

Guides sliding time window scaling in Qdrant. Use when someone asks 'only recent data matters', 'how to expire old vectors', 'time-based data rotation', 'delete old data efficiently', 'social media feed search', 'news search', 'log search with retention', or 'how to keep only last N months of data'.

qdrant/skills · 76 tokens