oliver-kriska/claude-elixir-phoenix / targets/codex/skills/phx-deps-update
phx-deps-update
VerifiedUpdate Hex dependencies safely. Use for upgrades; use $elixir-phoenix:phx-investigate for deps.get failures.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.2 KB |
| references/changelog-sources.md | markdown | 2.0 KB |
| references/coupled-groups.md | markdown | 2.7 KB |
| references/pr-strategy.md | markdown | 2.1 KB |
| references/update-mechanics.md | markdown | 2.5 KB |
references/pr-strategy.md
View on GitHub# PR Splitting Strategy + Scratch Layout
## Default grouping (override with `--pr-per`)
| Update class | Default grouping | Rationale |
|--------------|------------------|-----------|
| Patch (x.y.Z) | ONE bundled PR ("Bump N patch deps") | Low risk; reviewer skims the lock diff |
| Minor (x.Y.z) | Grouped by area | Back-compatible features; area grouping keeps review coherent |
| Major (X.y.z) | ONE PR each, changelog excerpt in body | Breaking; each needs focused review and its own revert unit |
| Coupled group | ONE PR for the whole group, regardless of class | Must move together (Iron Law 4) |
`--pr-per area` (default) · `--pr-per major` (majors separate, all minors
bundled) · `--pr-per none` (single branch, no split — solo repos).
## Area buckets (heuristic by package name)
`web` (phoenix*, plug*, bandit, cowboy) · `data` (ecto*, postgrex,
decimal) · `json` (jason, poison) · `test` (`:only` test — ex_machina,
mox, wallaby) · `obs` (telemetry*, opentelemetry*) · `bg` (oban*) ·
`auth` (guardian, bcrypt*, argon2*) · `misc` (rest).
## PR body template
Built from the scratch changelog deltas:
```markdown
## Dependency update: <pkg> <old> → <new> [<class>]
<changelog delta excerpt — the CHANGELOG hunk from hex.package diff>
- Full diff: https://diff.hex.pm/diff/<pkg>/<old>..<new>
- Verification: mix compile + mix test PASS
- Security: $elixir-phoenix:phx-deps-audit risk band <band>
```
## Commit discipline
Per commit: `mix.lock` + any `mix.exs` edit + (Phoenix-family)
`assets/package-lock.json` — never a lock alone (Iron Law 5). Stage
specific files; never `git add -A`.
## Scratch layout
`.claude/deps-update/{YYYY-MM-DD}/` — per-run, never committed:
```
inventory.md # parsed hex.outdated table, classified
before/<pkg>-CHANGELOG.md # snapshot of the current changelog (pre-update)
<pkg>-<old>-<new>.md # per-package changelog delta + notes
lock-diff.patch # git diff mix.lock for the whole run
pr-plan.md # grouping decisions + PR bodies
```
PR bodies are the only content that leaves the dir (into `gh pr create`).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |