Skip to content

tibursocampos/agent-dev-toolkit / core/skills/ef-add-migration

ef-add-migration

Verified

Add an EF Core migration in the open workspace. Discovers startup project, DbContext, and migrations folder. Use when adding a migration or invoking /ef-add-migration.

STOP - Read before ANY tool call

Read _shared/skill-boilerplate.md first. It holds the guardrails read, the session gate rule, the user sim rule, the one-step rule, the gate check, and the user chat language rule. The steps below are skill-specific only.


Skill: ef-add-migration

Trigger

Negative signal: applies as defined in _shared/skill-boilerplate.md; the skill-specific signals are listed below.

Invoke when the user asks for: /ef-add-migration, add migration, /ef-add-migration, or when a PLAN step requires a new EF Core migration.

Optional argument: migration name in PascalCase. If omitted, infer from pending model changes and confirm with the user.

Outcome

A new EF Core migration in the target workspace (not this toolkit repo unless that repo has a DbContext). User sees detected projects, final migration name, and created file paths.

Lazy-load

WhenPath
Reference index (routing only)skills/ef-add-migration/reference.md or {{TOOLKIT_ROOT}}/skills/ef-add-migration/reference.md after sync
Process step detail (lazy)skills/ef-add-migration/references/<section>.md
.NET layering{{TOOLKIT_ROOT}}/skills/_shared/dotnet-guidelines/clean-architecture.md
.NET test patterns (when adding tests){{TOOLKIT_ROOT}}/skills/_shared/dotnet-guidelines/dotnet-test-patterns.md

Never by default: do not preload all references/*.md, full EF docs, or unrelated dotnet guideline packs. Load one references/<section>.md per Process step (SKILL-REFERENCE-RETRIEVAL.md).

Process

Read references/<section>.md for discovery/commands — not full reference.md.

0. Workspace

Confirm the target .NET repository (.sln or *.csproj with DbContext). If the workspace is the toolkit only, stop and ask which repo to open.

1. Discover project layout

Use Glob and Grep (not hardcoded paths). Full checklist: references/discovery.md.

Summarize before running dotnet ef:

SettingDetected value
Solution rootpath to .sln or repo root
Startup projectAPI/Host/Web/Worker with Program.cs
Target project.csproj containing DbContext
DbContext classe.g. ApplicationDbContext
Migrations folderexisting Migrations/ or default under target

If any value is ambiguous, ask the user once. Free text: the answer is a path or name, not a fixed id set; the question stays open until answered.

2. Migration name

  • Name provided: normalize to PascalCase.
  • Name omitted: inspect git diff / git status, infer from entity/schema changes (see references/naming.md), present the suggested name, then ask once. Single select; ids confirm (use the name), adjust (free-text name instead), cancel (no migration). Render labels in the user chat language; answer mapping: {{TOOLKIT_ROOT}}/skills/_shared/agents/QUESTIONS.md.

3. Ensure dotnet-ef

dotnet ef --version

If missing, follow references/ef-tool.md (global or local tool-path; no fixed version in this skill body).

4. Add migration

From solution root:

dotnet ef migrations add <MigrationName> -s <StartupProject> -p <TargetProject> -c <DbContext>

Use ./dotnet-ef instead of dotnet ef when a repo-local tool is documented in references/ef-tool.md or repo README. Command details: references/commands.md.

5. Verify and summarize

Confirm new *.cs + *.Designer.cs and updated *ModelSnapshot.cs under the migrations folder (references/artifacts.md). Do not hand-edit generated migration code in ways that violate structure-and-quality.md / csharp-patterns.md. Optionally note how to apply locally (database update - details in references/commands.md). SDD handoff: references/sdd-cross-cut.md.

Must not

  • Hardcode EF tool package versions in SKILL.md (use references/ef-tool.md)
  • Assume corporate feeds or organization-specific URLs
  • Run migrations against production without explicit user request
  • Modify this toolkit repo when the user intended a consumer repo

Handoff

SituationNext
PLAN step with EFContinue /sdd-develop - <full-plan-path> - Step N (path from implement handoff; SDD locations per STORAGE.md)
Build/test failures after migration/repair-dotnet-build
Commit/commit
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall