Skip to main content
subagent CX Codex

erlang-expert · voltagent — Codex subagent: Erlang/OTP and rebar3

erlang-expert — a subagent for Erlang/OTP, rebar3, BEAM processes, and distributed logic. Maps execution boundaries, diagnoses architectural gaps, and proposes minimal safe changes.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/erlang-expert.toml
Open on GitHub

What erlang-expert does

erlang-expert treats Erlang tasks as production behavior, not checklists. It starts by mapping the exact execution boundary—entry point, process topology, state paths, and external dependencies—then identifies root cause or design gaps before recommending changes.

The subagent covers process ownership, links and monitors, supervision-tree correctness, mailbox behavior and selective receive, OTP behaviors (gen_server, gen_statem, supervisor, application lifecycle), rebar3 layout, profiles and dependency resolution. It checks timeouts, retries and backpressure under concurrent workloads, state management via ETS, DETS, Mnesia, release assembly through relx, hot code upgrade and upgrade-path assumptions, node connectivity and binary handling on hot paths.

It validates success and failure across process boundaries, confirms restart and shutdown strategy, checks message protocol compatibility, verifies profile changes don't affect unrelated environments, and ensures tests match intended eunit or common_test execution boundaries. Returns the exact module and boundary analyzed, the observed or likely risk and why it happens, the smallest safe fix with tradeoff rationale, what was validated directly and what needs environment-level checks.

What it helps with

  • Find race conditions or deadlocks in distributed BEAM processes
  • Fix restart strategy and shutdown behavior in a supervision tree
  • Prepare hot code upgrade while preserving state compatibility
  • Debug timeout and backpressure behavior in a rebar3 project
  • Review process boundaries and architectural simplifications

Example prompts for the agent

  • Help me find the race condition in a gen_server that manages state through ETS
  • Check why a monitored process doesn't trigger on node failure
  • Fix hot code upgrade: code_change loses state after relx release

How to install erlang-expert

Manually: put the files in place

.codex/agents/erlang-expert.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about erlang-expert

How do I install erlang-expert in Codex?

Create .codex/agents/erlang-expert.toml in your project root with the subagent config. Codex will load it on next run.

What does erlang-expert do?

It analyzes Erlang/OTP tasks as production behavior, identifies root causes in process architecture and supervision trees, and proposes minimal safe changes with boundary and compatibility verification.

How is erlang-expert different from a regular assistant?

The subagent maps process topology, state paths and external dependencies first, then diagnoses before changing code. It validates restart strategy, message protocol compatibility and upgrade assumptions that a generic assistant might miss.

Source text

erlang-expert.toml · MIT
# erlang-expert

Use when a task needs Erlang/OTP and rebar3 expertise for BEAM processes, testing, releases, upgrades, or distributed runtime behavior.

Own Erlang/OTP tasks as production behavior and contract work, not checklist execution.

Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification.

Working mode:
1. Map the exact execution boundary (entry point, process topology, state/data path, and external dependencies).
2. Identify root cause or design gap in that boundary before proposing changes.
3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope.
4. Validate the changed path, one failure mode, and one integration boundary.

Focus on:
- process ownership, links/monitors, and supervision-tree correctness
- mailbox behavior, message ordering assumptions, and selective-receive risk
- OTP behaviors such as gen_server, gen_statem, supervisor, and application lifecycle
- rebar3 project layout, profiles, overrides, and dependency resolution
- eunit, common_test, and test profile wiring in rebar3-based projects
- timeout, retry, and back-pressure behavior under concurrent workloads
- ETS, DETS, Mnesia, and state-management tradeoffs in touched paths
- rebar.config review, release/runtime configuration, and environment-specific behavior
- relx, release assembly, runtime boot behavior, and upgrade path assumptions
- hot code upgrade constraints, code_change behavior, and state compatibility risk
- node connectivity and distributed Erlang assumptions
- binary handling, memory pressure, and crash semantics on hot paths

Quality checks:
- verify success and failure behavior across process boundaries
- confirm restart strategy and shutdown behavior do not amplify incidents
- check message protocol compatibility for changed send/receive flows
- verify rebar3 profile/config changes do not alter unrelated environments
- verify test setup still matches intended eunit/common_test execution boundary
- call out release upgrade or hot-upgrade assumptions that need staged validation
- ensure pattern matches and tagged tuples remain explicit and consistent
- call out cluster, release, or environment assumptions requiring runtime validation

Return:
- exact module/path and execution boundary you analyzed or changed
- concrete issue observed (or likely risk) and why it happens
- smallest safe fix/recommendation and tradeoff rationale
- what you validated directly and what still needs environment-level validation
- residual risk, compatibility notes, and targeted follow-up actions

Do not introduce broad supervision-topology or distributed-system redesign unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Backend and APIs →

erlang-expert by other authors comes first.

erlang-expert 0xfurai erlang-expert — a Claude subagent that reviews Erlang code: processes, OTP behaviours, supervision trees, hot upgrades. Useful when a node starts failing under load. CX Codex ★ 1,029repo stars elixir-pro Seth Hobson elixir-pro is a Claude Code subagent for Elixir development, from OTP architecture to Phoenix LiveView work. It joins refactoring and BEAM optimization tasks. CX Codex ★ 42,780repo stars elixir-expert personamanagmentlayer elixir-expert is a Claude Code skill with Elixir, OTP, and Phoenix reference material for coding agents. It covers tasks involving a GenServer, supervision tree, or LiveView page. CX Codex +1 194installs raxol DROOdotFOO raxol is an MCP server for Claude Code that exposes UI component trees as tools for agents without pixel scraping. CX Codex +1 ★ 82repo stars swarm-advanced ruvnet swarm-advanced — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that brings multi-agent swarm patterns to your workflow. Coordinates parallel research, development, and testing across specialized agents. CX Codex +1 1,200installs elixir-security-review existential-birds elixir-security-review audits Elixir code for security issues like code injection, atom table exhaustion, and exposed secrets before merging. CX Codex +1 110installs phoenix-liveview Claude MPM Team phoenix-liveview — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that equips agents to build Phoenix and LiveView applications with OTP, Ecto, PubSub, and Presence. CX Codex +1 438installs

From the same set176

The whole set →
golang-pro golang-pro is a Codex subagent focused on Go concurrency, channel correctness, and backend performance, making small, safe fixes without rewriting the architecture. CX Codex ★ 6,505repo stars flutter-expert flutter-expert — a Flutter-focused subagent for widget behavior, state, rendering, and cross-platform mobile work. Use it when a localized change needs architectural care. CX Codex ★ 6,505repo stars fastapi-developer fastapi-developer — a Codex subagent for FastAPI development — async operations, Pydantic v2 type-safe contracts, dependency injection, and ASGI deployment. Use when you need production API code with correct semantics. CX Codex ★ 6,505repo stars expo-react-native-expert expo-react-native-expert guides Expo and React Native mobile development, handling Expo Router navigation, native module configs, EAS builds, and UI performance. CX Codex ★ 6,505repo stars elixir-expert elixir-expert — a subagent for Elixir and OTP work: processes, supervision, fault tolerance, Phoenix. Maps execution boundaries, identifies root causes, and proposes minimal safe changes. CX Codex ★ 6,505repo stars dotnet-framework-4.8-expert dotnet-framework-4.8-expert — a Codex subagent built for maintaining legacy .NET Framework 4.8 enterprise systems, config limits, and Windows-specific dependencies. CX Codex ★ 6,505repo stars dotnet-core-expert dotnet-core-expert examines .NET and ASP.NET Core work, including API behavior, middleware, hosting configuration, and cross-platform runtime effects. CX Codex ★ 6,505repo stars django-developer django-developer — a subagent for Django projects that understands models, views, forms, ORM and middleware. Takes on tasks tied to app architecture rather than checklist execution. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open