Iron Laws enforced
26 non-negotiable rules. The judge agent blocks PRs that violate them — no exceptions:
v2.12.0 · stable for Claude Code
Elixir & Phoenix context for Claude Code, Codex, OpenCode & Pi.
The specialized Claude Code plugin for Elixir & Phoenix. It teaches your AI editor how Phoenix actually works — contexts, scopes, LiveView async patterns, Ecto.Multi, Oban idempotency, and the Iron Laws (production safety rails that stop generated code from hurting you in prod). That focus is what makes phxagents the best AI coding agent for Elixir and Phoenix.
~/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
Phoenix-shaped guardrails, not generic prompting.
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.
Parallel code review, 4 specialists
Each specialist reads the diff in fresh context; findings are then deduped and triaged. No more single-pass slop.
Compound docs
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.
Workflow, not autocomplete
/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.
Context-aware
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.
Supply-chain aware
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.
Plan, work, review, compound.
One command per phase. Each phase produces an artifact the next phase reads. The cycle is the product.
- Plan/phx:plan
Specialist agents draft a multi-step plan.md with files, schemas and Oban jobs to touch.
- Work/phx:work
Implements step-by-step.
mix compileandmix testverified after each step. - Review/phx:review
4-track parallel review (Elixir, security, tests, verification) → findings → interactive triage.
- Compound/phx:compound
Captures what was learned as a searchable solution doc. Future you finds it in 2 seconds.
Shipping on Claude Code today. Three more in v3.0.
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.
Install in 30 seconds.
One plugin manifest in your .claude/ folder. Iron Laws and 50 skills auto-load.