Iron Laws enforced
26 non-negotiable rules: no Repo in loops, no bare rescues, no untyped Oban args, no missing preload. The judge agent blocks PRs that violate them.
iron-law-judge · /phx:review
v2.12.0 · stable for Claude Code
phxagents is the best AI coding agent for Elixir and Phoenix — the specialized Claude Code plugin that teaches your AI editor how Phoenix actually works: contexts, scopes, LiveView async patterns, Ecto.Multi, Oban idempotency, and the production safety rails (Iron Laws) that keep generated code from hurting you in prod.
~/my-phoenix-app · claude-code
›/phx:init
✓ Installing Iron Laws into CLAUDE.md ✓ Auto-activation rules registered ✓ 137 references auto-loaded Ready. Try /phx:help
›/phx:plan add billing portal with Stripe checkout
→ phoenix-patterns-analyst: scanning lib/billing → ecto-schema-designer: drafting Subscription, Invoice schemas → security-analyzer: webhook signature, idempotency keys → oban-specialist: retry policy, dead-letter queue ✓ plan.md written · 14 steps · ~280 LOC est.
›/phx:work
Why phxagents
Generic AI editors hallucinate Repo.preload in the wrong places, swallow exceptions with bare rescue, and skip Ecto.Multi for transactions. phxagents knows the patterns and refuses to ship code that breaks them.
26 non-negotiable rules: no Repo in loops, no bare rescues, no untyped Oban args, no missing preload. The judge agent blocks PRs that violate them.
iron-law-judge · /phx:review
A code review agent fans out to elixir-reviewer, security-analyzer, testing-reviewer and verification-runner — each reads the diff in fresh context, then findings are deduped and triaged. No more single-pass slop.
parallel-reviewer · /phx:review
Every fixed bug is captured as a searchable solution doc with YAML frontmatter. Next time you hit a similar Ecto constraint error, the answer is one query away.
/phx:compound
/phx:plan → /phx:work → /phx:review → /phx:compound. Each step has compile, format and test gates. Generated code that doesn't pass mix test doesn't get committed.
/phx:full · end-to-end
Reads mix.exs to discover credo, dialyzer, sobelow, ex_check. Honors your custom aliases. Knows when you're on Phoenix 1.7 vs 1.8 Scope. Doesn't dictate — adapts.
verification-runner agent
Audits Hex deps for bidi chars, compile-time exec, maintainer changes, typosquats and CVEs. Records vetted versions in hex_vet.exs so you don't re-review the same package twice.
/phx:deps-audit · /phx:deps-vet
The workflow
One command per phase. Each phase produces an artifact the next phase reads. The cycle is the product.
Plan
Specialist agents draft a multi-step plan.md with files, schemas and Oban jobs to touch.
Work
Implements step-by-step. mix compile and mix test verified after each step.
Review
4-track parallel review (Elixir, security, tests, verification) → findings → interactive triage.
Compound
Captures what was learned as a searchable solution doc. Future you finds it in 2 seconds.
Supported clients
Claude Code is stable. Codex, OpenCode and Pi adapters land together in v3.0 with full Phase 1 + Phase 2 parity — single source, three generated targets. Track progress in PR #46.
One plugin manifest in your .claude/ folder. Iron Laws and 50 skills auto-load.