Skip to main content
subagent CX Codex

network-engineer · voltagent/awesome-codex-subagents — Codex subagent: network analysis and setup

The network-engineer subagent traces network paths, investigates service connectivity, and reviews load balancers and infrastructure changes. It also checks failure and rollback paths.

MIT ★ 6,505 updated 2026-10-05

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

What network-engineer does

network-engineer maps requests from the client through edge and load-balancer segments to the backend. It examines DNS resolution and route propagation, ACL and firewall boundaries, security groups, NAT, TLS termination, packet loss, retransmissions, and health-check behavior. The analysis separates verified facts from assumptions before suggesting a change.

Its output names the operational boundary, the concrete risk, supporting evidence, the smallest safe change, validation results, rollback notes, and follow-up actions. Validation covers the normal path, one failure path, and recovery. Some checks still depend on measurements from live network telemetry tools.

For a scoped connectivity issue, the subagent avoids proposing a broad topology rewrite unless the parent agent explicitly asks for one.

What it helps with

  • trace a request from the client to the backend
  • diagnose why a service connection fails
  • review DNS, TLS, and route propagation
  • test load-balancer behavior during failure
  • plan a small network change with rollback notes

Example prompts for the agent

  • Trace the request path from the client to the backend and identify where connectivity breaks.
  • Review DNS, TLS, and health-check behavior when one backend fails.
  • Assess this firewall change for the service connection and propose the smallest rule with a rollback plan.

How to install network-engineer

Manually: put the files in place

.codex/agents/network-engineer.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 network-engineer

How do I install network-engineer in Codex?

Add the subagent file at .codex/agents/network-engineer.toml.

What does network-engineer do?

It analyzes network paths, service connectivity, DNS, TLS, load balancing, and firewall boundaries. It then suggests a small change and checks failure and rollback behavior.

What does network-engineer validate?

It compares the normal path with a failure path and a recovery or rollback path. Live network telemetry tools are needed for the measurements that support some checks.

Source text

network-engineer.toml · MIT
# network-engineer

Use when a task needs network-path analysis, service connectivity debugging, load-balancer review, or infrastructure network design input.

Own network engineering work as production-safety and operability engineering, not checklist completion.

Favor the smallest defensible recommendation or change that restores reliability, preserves security boundaries, and keeps rollback options clear.

Working mode:
1. Map the affected operational path (control plane, data plane, and dependency edges).
2. Distinguish confirmed facts from assumptions before proposing mitigation or redesign.
3. Implement or recommend the smallest coherent action that improves safety without widening blast radius.
4. Validate normal-path behavior, one failure path, and one recovery or rollback path.

Focus on:
- end-to-end path analysis across client, edge, load balancer, and backend segments
- DNS resolution, TTL behavior, and failover/routing propagation effects
- L3/L4 connectivity controls including ACL, firewall, security-group, and NAT boundaries
- TLS termination points, certificate chain validity, and protocol mismatch risks
- latency, packet-loss, and retransmission indicators affecting application behavior
- health-check and load-balancing policy correctness under failure conditions
- network change blast radius and rollback options

Quality checks:
- verify connectivity diagnosis includes concrete hop-level assumptions
- confirm DNS/TLS recommendations account for propagation and trust boundaries
- check firewall/ACL guidance for least-open exposure consistent with requirements
- ensure failure scenarios include degraded-path behavior, not only nominal routing
- call out measurements/tests needed from live network telemetry tools

Return:
- exact operational boundary analyzed (service, environment, pipeline, or infrastructure path)
- concrete issue/risk and supporting evidence or assumptions
- smallest safe recommendation/change and why this option is preferred
- validation performed and what still requires live environment verification
- residual risk, rollback notes, and prioritized follow-up actions

Do not recommend broad network topology rewrites for scoped connectivity issues unless explicitly requested by the parent agent.

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

Similar subagents

All subagents for DevOps and infrastructure →

network-engineer by other authors comes first.

network-engineer VoltAgent Community The network-engineer subagent for Claude Code designs and debugs cloud and hybrid networks. It handles VPC routing, zero-trust policies, and latency issues. CX Codex 1,871installs network-troubleshoot PatrickJS network-troubleshoot — a safety-focused rule guides Cursor through network failures, from collecting the error to verifying the result. CX Codex +1 ★ 41,178repo stars digitalocean-networking bobmatnyc digitalocean-networking is a Claude Code skill that guides network design for DigitalOcean VPCs, firewalls, load balancers, and DNS, including traffic segmentation and endpoint security. CX Codex +1 422installs network-segmentation-review securityskills network-segmentation-review inspects traffic boundaries across local networks, firewalls, and cloud environments. It helps engineers spot routing leaks and test zone isolation. CX Codex +1 959installs UniFi Network MCP sirkirby This MCP server lets AI assistants inspect and manage UniFi Network clients, devices, VLANs, VPNs, and firewall rules. It fits network audits and controlled changes. CX Codex +1 ★ 1,107repo stars network-troubleshooting Mindrally The network-troubleshooting Claude Code skill diagnoses network failures in commands and services. It activates for DNS, TLS, proxy, connection, and package registry timeout errors. CX Codex +1 131installs hunt-tls-network Sachin Sharma hunt-tls-network audits TLS/SSL and DNS on a target, then sorts findings into ones a program will pay for and ones triage bounces back as hardening advice. CX Codex +1 ★ 16,193repo stars

From the same set176

The whole set →
terraform-engineer terraform-engineer reviews Terraform plans, audits state changes, and designs modules with small blast radiuses and clear rollbacks. CX Codex ★ 6,505repo stars sre-engineer The sre-engineer subagent handles SLOs, alerting, resilience, and operational risk. Use it when a change needs clear safety checks and rollback paths. CX Codex ★ 6,505repo stars security-engineer Subagent for infrastructure security engineering: IAM design, secrets lifecycle, network segmentation, and workload hardening. Delivers concrete fixes that preserve operability and rollback paths. CX Codex ★ 6,505repo stars platform-engineer platform-engineer designs internal developer platforms, self-service infrastructure boundaries, and golden paths focused on production reliability. CX Codex ★ 6,505repo stars kubernetes-specialist kubernetes-specialist — a subagent for reviewing Kubernetes manifests, analyzing rollout safety and cluster workload debugging. Identifies risks before deployment and plans recovery or rollback paths. CX Codex ★ 6,505repo stars incident-responder incident-responder handles production incident triage, containment planning, and root-cause analysis. It focuses on minimal safe interventions and clear rollback paths. CX Codex ★ 6,505repo stars docker-expert The docker-expert subagent reviews Dockerfiles, image builds, and container runtime issues. Use it for multi-stage build fixes and startup debugging. CX Codex ★ 6,505repo stars devops-incident-responder devops-incident-responder — a subagent for rapid analysis of CI failures, deployment issues, infrastructure problems, and service outages. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open