claude-elixir-phoenix
oliver-kriska · oliver-kriska/claude-elixir-phoenix
Enables Claude Code to plan, implement, review, and verify Elixir/Phoenix/LiveView code with 26 specialist agents and enforced 'Iron Laws' for quality.
Claude Code plugin for Elixir/Phoenix/LiveView — 26 specialist agents, Iron Laws enforcement, and Tidewave MCP integration. Plan features with parallel research agents, execute with automatic verification, review with 4-agent parallel audits, and capture learnings as reusable knowledge.
Preview
What you can do with it
- Develop a new Elixir Phoenix LiveView feature while adhering to best practices and specific 'Iron Laws'.
- Automatically review an existing Phoenix codebase for common Elixir pitfalls like inefficient database queries.
- Plan and verify complex Elixir background jobs (Oban) to ensure idempotency and correctness.
Safety check
No risky patterns found in the files we scanned.
Automated scan of the repo files. Always review code you run.
From the README
Elixir Phoenix Plugin for Claude Code
Docs: phxagents.dev -- install guides per runtime, the runtime compatibility matrix, all 26 Iron Laws, and a browsable skill and agent catalog.
Claude Code is great. But it doesn't know that assign_new silently skips on reconnect, that :float will corrupt your money fields, or that your Oban job isn't idempotent.
This plugin does. It coordinates 26 specialist agents that plan, implement, review, and verify your Elixir/Phoenix code in parallel -- each with domain expertise, fresh context, and enforced Iron Laws that catch the bugs your tests won't.
Using Amp? Install the generated edition for the same 51 Elixir, Phoenix, LiveView, Ecto, Oban, testing, and security skills, plus 40 deterministic workflow wrappers, five read-only specialist agents, parallel review/investigation, and native edit/verification guards, and the native PR watch lifecycle plugin. See Use with Amp for the important differences from the full Claude Code plugin, or the Amp install guide on phxagents.dev.
Using Codex? Install the native generated skills plugin for all 51 skills,
including $elixir-phoenix:phx-investigate and
$elixir-phoenix:phx-review workflows. See
Use with Codex or the
Codex install guide; a trust-gated
destructive-command safeguard is included, while custom agents are intentionally
not included and Tidewave MCP registration remains external.
Using Pi? Install the native generated skills package for all 51 skills,
including Pi-compatible /skill:phx-investigate and /skill:phx-review
workflows. See Use with Pi or the
Pi install guide; extensions, prompt
templates, MCP, and custom agents are intentionally not included yet. Tidewave
can be used when the Pi host exposes it independently.
Using OpenCode? Install the generated skills-only target for all 51 skills,
including phx-investigate and phx-review. In the tested OpenCode 1.17.2 setup,
they are also available as /phx-investigate and /phx-review; the skill tool
is the portable explicit interface. See Use with OpenCode, the
OpenCode guide, or the
OpenCode install guide.
Using DeepSeek Harness (dsh)? Install the generated skills-only target for
all 51 skills. A /phx-investigate or /phx-review token anywhere in your
message loads the skill deterministically, and dsh reads your CLAUDE.md
natively. See Use with DeepSeek Harness, the
dsh guide, or the
dsh install guide; hooks and custom
agents are intentionally not included, and Tidewave MCP registration is
external.
Compare native invocation, installation, and deliberately deferred capabilities in the canonical runtime support matrix. Generated skills support does not imply full Claude Code feature parity.
# You describe the feature. The plugin figures out the rest.
/phx:plan Add real-time comment notifications
# 4 research agents analyze your codebase in parallel.
# A structured plan lands in .claude/plans/comment-notifications/plan.md
# Then:
/phx:work .claude/plans/comment-notifications/plan.md
# Implements task by task. Compiles after each change.
# Stops cold if code violates an Iron Law.
/phx:review
# 4 specialist agents audit in parallel:
# idioms, security, tests, compilation.
# Deduplicates findings. Flags pre-existing issues separately.
No prompt engineering. No "please check for N+1 queries." The plugin auto-loads the right domain knowledge based on what files you're editing and enforces rules that prevent the mistakes Elixir developers actually make in production.
┌─────────────────────────────────────────────────────────────────────┐
│ ⚗ Elixir/Phoenix Plugin for Claude Code │
│ │
│ ┌──────────┬──────────┬──────────┬──────────┬──────────┐ │
│ │ 26 │ 51 │ 140 │ 30 │ 26 │ │
│ │ Agents │ Skills │ Refs │Hook Regs │Iron Laws │ │
│ └──────────┴──────────┴──────────┴──────────┴──────────┘ │
│ │
│ AGENTS COMMANDS │
│ ───────────────────── ────────────────────────── │
│ Orchestrators (opus) Workflow │
│ workflow-orchestrator /phx:plan /phx:work │
│ planning-orchestrator /phx:review /phx:full │
│ parallel-reviewer /phx:compound /phx:quick │
│ context-supervisor /phx:brief /phx:triage │
│ │
│ Reviewers (sonnet) Investigation & Debug │
│ elixir-reviewer /phx:investigate /phx:trace │
│ testing-reviewer /ecto:n1-check /phx:perf │
│ security-analyzer (opus) /ecto:constraint-debug │
│ iron-law-judge /lv:assigns │
│ │
│ Architecture (sonnet) Analysis & Review │
│ liveview-architect /phx:audit /phx:verify │
│ ecto-schema-designer /phx:techdebt /phx:boundaries │
│ phoenix-patterns-analyst /phx:pr-review /phx:challenge │
│ otp-adviso