[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79XRFC2SD3547DP35AJQGX4":3,"skill-same:01M79XRFC2SD3547DP35AJQGX4":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M79XRFC2SD3547DP35AJQGX4","evolving-database-schemas",null,"Guides changing a stored schema without breaking a running version: expand, migrate, verify, then contract, each step shipped and proven before the next, with migrations explicit and reversible until the contract.","wahidyankf\u002Fbeaver-nest","wahidyankf","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F10843406?v=4","01M79XPZPDMM2D076E49HRJT8A","Wahidyan Kresna Fridayoka","01M79XPZQGDA87TNY0HYDREYDP",2,"MIT","https:\u002F\u002Fgithub.com\u002Fwahidyankf\u002Fbeaver-nest\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fevolving-database-schemas\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: evolving-database-schemas\ndescription: >-\n  Guides changing a stored schema without breaking a running version: expand, migrate, verify, then contract, each step\n  shipped and proven before the next, with migrations explicit and reversible until the contract.\nwhen_to_use: >-\n  Use when designing or writing a change that adds, renames, splits, or removes a column, table, index, or constraint,\n  or that backfills stored data.\ncompatibility: Requires read access to the schema, its migrations, and the code that reads and writes the store.\n---\n\n# Evolving Database Schemas\n\nThe standards own the rules.\n[Release Cutover](..\u002F..\u002F..\u002Frepo-governance\u002Fdevelopment\u002Flive-service-continuity.md)\nrequires migrations to be explicit, never run at startup, and a release that carries one to wait for an expand, migrate,\nand verify sequence that keeps the previous version able to read.\n[Test-Driven Development](..\u002F..\u002F..\u002Frepo-governance\u002Fdevelopment\u002Ftest-driven-development.md) governs the\ntests each step adds. This skill covers the judgement of sequencing a schema change so that both the old and the new\nversion of the code keep working at every moment.\n\n## Two Versions Run at Once\n\nDuring any rollout the previous version and the new one read and write the same store, and a rollback brings the\nprevious version back. A schema change is safe only when every version that can be running at that moment understands\nthe store. Renaming a column in one step breaks whichever version expects the other name.\n\n## Expand, Migrate, Verify, Contract\n\n1. **Expand.** Add the new shape beside the old: a new nullable column, a new table, a new index built without blocking\n   writes. Nothing reads it yet, and the previous version ignores it. This release is safe to roll back.\n2. **Migrate.** Ship code that writes both shapes, then backfill existing rows in bounded, idempotent batches that can\n   stop and resume. Reads still come from the old shape.\n3. **Verify.** Prove the shapes agree with a deterministic check, such as matching counts or a query that finds no row\n   where they differ, then switch reads to the new shape in its own release.\n4. **Contract.** Only once no running or rollback-eligible version reads the old shape, remove it in a later release.\n   This is the one step that cannot be rolled back, so it waits until the verification has held through a release.\n\nEach step is its own release, and each is proven before the next begins. Collapsing two steps into one release removes\nthe point at which the previous version could still run.\n\n## Make Each Migration Explicit and Testable\n\nA migration is a named, ordered, checked-in artifact the release declares, run by a deliberate command, never as a side\neffect of a process starting. Test it test-first against a copy of the schema at the version it starts from: the\nmigration fails before it exists and passes after, and a second run changes nothing. A data backfill also gets a test\nthat its result matches the verification query.\n\n## Constraints Come Last\n\nA new not-null, unique, or foreign-key constraint is added only after the data already satisfies it, and is validated\nseparately from being declared where the store allows, so adding it does not lock the table while it scans.\n\n## Before Calling It Ready\n\n- the change is split into expand, migrate, verify, and contract releases, each named;\n- every running and rollback-eligible version understands the store at each step;\n- every migration is explicit, ordered, tested from its starting schema, and safe to run twice;\n- the verification is a command with an expected result, not an inspection; and\n- the contract step waits until no version that reads the old shape can run again.\n","# Evolving Database Schemas\n\nThe standards own the rules.\n[Release Cutover](..\u002F..\u002F..\u002Frepo-governance\u002Fdevelopment\u002Flive-service-continuity.md)\nrequires migrations to be explicit, never run at startup, and a release that carries one to wait for an expand, migrate,\nand verify sequence that keeps the previous version able to read.\n[Test-Driven Development](..\u002F..\u002F..\u002Frepo-governance\u002Fdevelopment\u002Ftest-driven-development.md) governs the\ntests each step adds. This skill covers the judgement of sequencing a schema change so that both the old and the new\nversion of the code keep working at every moment.\n\n## Two Versions Run at Once\n\nDuring any rollout the previous version and the new one read and write the same store, and a rollback brings the\nprevious version back. A schema change is safe only when every version that can be running at that moment understands\nthe store. Renaming a column in one step breaks whichever version expects the other name.\n\n## Expand, Migrate, Verify, Contract\n\n1. **Expand.** Add the new shape beside the old: a new nullable column, a new table, a new index built without blocking\n   writes. Nothing reads it yet, and the previous version ignores it. This release is safe to roll back.\n2. **Migrate.** Ship code that writes both shapes, then backfill existing rows in bounded, idempotent batches that can\n   stop and resume. Reads still come from the old shape.\n3. **Verify.** Prove the shapes agree with a deterministic check, such as matching counts or a query that finds no row\n   where they differ, then switch reads to the new shape in its own release.\n4. **Contract.** Only once no running or rollback-eligible version reads the old shape, remove it in a later release.\n   This is the one step that cannot be rolled back, so it waits until the verification has held through a release.\n\nEach step is its own release, and each is proven before the next begins. Collapsing two steps into one release removes\nthe point at which the previous version could still run.\n\n## Make Each Migration Explicit and Testable\n\nA migration is a named, ordered, checked-in artifact the release declares, run by a deliberate command, never as a side\neffect of a process starting. Test it test-first against a copy of the schema at the version it starts from: the\nmigration fails before it exists and passes after, and a second run changes nothing. A data backfill also gets a test\nthat its result matches the verification query.\n\n## Constraints Come Last\n\nA new not-null, unique, or foreign-key constraint is added only after the data already satisfies it, and is validated\nseparately from being declared where the store allows, so adding it does not lock the table while it scans.\n\n## Before Calling It Ready\n\n- the change is split into expand, migrate, verify, and contract releases, each named;\n- every running and rollback-eligible version understands the store at each step;\n- every migration is explicit, ordered, tested from its starting schema, and safe to run twice;\n- the verification is a command with an expected result, not an inspection; and\n- the contract step waits until no version that reads the old shape can run again.\n",{"name":5,"description":7,"when_to_use":24,"compatibility":25},"Use when designing or writing a change that adds, renames, splits, or removes a column, table, index, or constraint, or that backfills stored data.","Requires read access to the schema, its migrations, and the code that reads and writes the store.","main","e6a21f0c020e81a73b28f6923bd898af898f17e4",".agents\u002Fskills\u002Fevolving-database-schemas",0,"https:\u002F\u002Fgithub.com\u002Fwahidyankf\u002Fbeaver-nest","https:\u002F\u002Fgithub.com\u002Fwahidyankf","Software Engineer","2026-11-15 04:32:43",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add wahidyankf\u002Fbeaver-nest --skill evolving-database-schemas",{"tool":40,"command":41},"bunx","bunx skills add wahidyankf\u002Fbeaver-nest --skill evolving-database-schemas",{"tool":43,"command":44},"pnpm","pnpm dlx skills add wahidyankf\u002Fbeaver-nest --skill evolving-database-schemas","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fwahidyankf\u002Fbeaver-nest\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fevolving-database-schemas\u002FSKILL.md",true,[],[49,56,63,70,77,84],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M79Y04GAQQJXY8N9BD749WDJ","writing-browser-e2e-tests","Guides writing browser end-to-end tests that find elements as users do, wait on what the action produced, keep page knowledge in page objects, organize one feature per file, and run scenario-backed suites from generated specs.","https:\u002F\u002Fgithub.com\u002Fwahidyankf\u002Fbeaver-nest\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-browser-e2e-tests\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"publishedAt":19},"01M79Y0001QFQM6ZZQMG91MMN6","usability-heuristic-evaluation","Guides judging a running interface as a first-time user would, without its specifications: citing a named principle for every finding, walking each task step, reading labels and addresses for scent, and rating severity.","https:\u002F\u002Fgithub.com\u002Fwahidyankf\u002Fbeaver-nest\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fusability-heuristic-evaluation\u002FSKILL.md",[],[],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":19},"01M79XZX1AF54RXJRYZZ5KRA3Z","tooling-nx","Guides Nx workspace work under the Nx standard: selecting projects by the graph, adding a target only where a capability exists, tracing a stale cached pass to its missing input, and answering a module-boundary finding.","https:\u002F\u002Fgithub.com\u002Fwahidyankf\u002Fbeaver-nest\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftooling-nx\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M79XZT0D49C6D7DHBE0960H6","programming-typescript","Guides the procedure for writing or changing TypeScript: loading the TypeScript standard first, driving each increment test-first, finding which rule a decision falls under, and confirming the gates before handing off.","https:\u002F\u002Fgithub.com\u002Fwahidyankf\u002Fbeaver-nest\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fprogramming-typescript\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":19},"01M79XZPYGRRJ4CK2EGA3P5RYP","programming-shell","Guides shell work under the shell standards: checking the declared dialect first, deciding whether logic belongs in shell at all, tracing where exit-on-error does not reach, and testing the script as its callers run it.","https:\u002F\u002Fgithub.com\u002Fwahidyankf\u002Fbeaver-nest\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fprogramming-shell\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M79XZKN2R9RR0MX66DEM5W2Z","programming-javascript","Guides JavaScript work under the JavaScript standard: confirming the file is type-checked, typing through JSDoc, validating input the checker cannot see, and noticing floating promises and swallowed errors before handing off.","https:\u002F\u002Fgithub.com\u002Fwahidyankf\u002Fbeaver-nest\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fprogramming-javascript\u002FSKILL.md",[],[]]