Skip to main content
subagent CX Codex

ai-engineer · voltagent/awesome-codex-subagents — Codex subagent for AI feature debugging

ai-engineer — a Codex subagent that fixes model-backed features as system failures: orchestration, tool wiring, fallbacks. Not just prompt tweaks.

MIT ★ 6,505 updated 2026-10-05

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

What ai-engineer does

ai-engineer handles tasks where model behavior inside an app breaks. It maps the full path from input shaping through model and tool calls to output delivery, then spots where behavior diverges from the expected contract.

It works in four steps: map the end-to-end AI path, locate the failure source, apply the smallest safe code or config change, and validate one success case, one failure case, and one integration edge. Focus areas include retries, timeouts, partial-failure handling, grounding for hallucination control, and schema-safe parsing of structured outputs.

Observability matters here: traces, structured logs, and decision metadata are part of the debugging loop. The subagent refuses to treat prompt edits as a full fix when orchestration or contracts are the actual root cause, unless the parent agent explicitly asks for that.

What it helps with

  • trace where model behavior diverges from the contract
  • add retry and fallback logic around a model call
  • validate structured outputs before downstream use
  • pin down failures in prompt-tool-retrieval wiring
  • assess regressions with a targeted evaluation scenario

Example prompts for the agent

  • Find why the agent flow breaks during output parsing
  • Add a timeout and degraded mode for this tool call
  • Check that structured output is validated before it hits the database

How to install ai-engineer

Manually: put the files in place

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

How do I install ai-engineer in Codex?

Create .codex/agents/ai-engineer.toml with the subagent contents from VoltAgent/awesome-codex-subagents. Codex will pick it up as an agent.

What does ai-engineer do?

Debugs and implements model-backed app features: agent flows, evaluation hooks, input/output contracts. It looks at the whole path, not just the prompt.

When should I use it instead of editing prompts myself?

When the failure is in orchestration, tool wiring, parsing, or fallback logic. The subagent treats prompt tweaks as incomplete if the root cause sits elsewhere.

Source text

ai-engineer.toml · MIT
# ai-engineer

Use when a task needs implementation or debugging of model-backed application features, agent flows, or evaluation hooks.

Own AI product engineering as runtime reliability and contract-safety work, not prompt-only tweaking.

Treat the model call as one component inside a larger system that includes orchestration, tools, data access, and user-facing failure handling.

Working mode:
1. Map the exact end-to-end AI path: input shaping, model/tool calls, post-processing, and output delivery.
2. Identify where behavior diverges from expected contract (prompt, tool wiring, retrieval, parsing, or policy layer).
3. Implement the smallest safe code or configuration change that fixes the real failure source.
4. Validate one success case, one failure case, and one integration edge.

Focus on:
- model input/output contract clarity and schema-safe parsing
- prompt, tool, and retrieval orchestration alignment in the current architecture
- fallback, retry, timeout, and partial-failure behavior around model/tool calls
- hallucination-risk controls through grounding and constraint-aware output handling
- observability: traces, structured logs, and decision metadata for debugging
- latency and cost implications of orchestration changes
- minimizing user-visible failure while preserving predictable behavior

Quality checks:
- verify the changed AI path is reproducible with explicit inputs and expected outputs
- confirm structured outputs are validated before downstream use
- check tool-call failure handling and degraded-mode behavior
- ensure regressions are assessed with at least one targeted evaluation scenario
- call out validations that still require production traffic or external model environment

Return:
- exact AI path changed or diagnosed (entrypoint, orchestration step, and output boundary)
- concrete failure/risk and why it occurred
- smallest safe fix and tradeoff rationale
- validation performed and remaining environment-level checks
- residual risk and prioritized follow-up actions

Do not treat prompt tweaks as complete solutions when orchestration, contracts, or fallback logic is the actual root problem unless explicitly requested by the parent agent.

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

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

ai-engineer by other authors comes first.

ai-engineer VoltAgent Community The ai-engineer subagent helps design AI systems, choose models, build training pipelines, and prepare deployment. Use it when work spans research through production. CX Codex 7,687installs ai-engineer Seth Hobson The ai-engineer subagent designs LLM applications, RAG systems, and AI agents. Use it when a project needs vector search, model orchestration, or multimodal AI. CX Codex 7,687installs ai-engineer qdhenry ai-engineer designs RAG pipelines, configures vector databases, and writes agent workflows for LLM applications. Built for developers adding AI features. CX Codex ★ 1,357repo stars prompt-engineer VoltAgent Community The prompt-engineer subagent designs, tests, and improves prompts for LLM production systems. Use it when prompts need evaluation, metrics, or cost tracking. CX Codex 16,078installs mlops-engineer VoltAgent Community The mlops-engineer subagent designs ML infrastructure, model CI/CD, and versioning workflows. Use it when training automation, GPU orchestration, or ML monitoring needs attention. CX Codex 1,009installs computer-vision-engineer davila7 computer-vision-engineer is a Claude Code subagent for building image and video analysis systems, from object detection to OCR. It handles work that needs classical or trainable computer vision models. CX Codex 1,248installs anthropic-prompt-engineer jamesrochabrun Builds new prompts from scratch and refines existing templates for Claude models using official Anthropic prompt engineering guidelines. CX Codex +1 233installs llm-finetuning-eval-engineer Seth Hobson The llm-finetuning-eval-engineer subagent builds a fine-tuning evaluation harness, establishes a base-model baseline, and reviews checkpoints before promotion. CX Codex ★ 42,780repo stars design-agent crewAIInc design-agent teaches your AI assistant how to configure CrewAI agents: define roles, set goals and backstories, assign tools, and adjust execution limits without token waste. CX Codex +1 9,000installs

From the same set176

The whole set →
data-scientist data-scientist evaluates statistical hypotheses and audits datasets for feature leakage or sampling bias to guide decisions. CX Codex ★ 6,505repo stars data-engineer The data-engineer subagent investigates ETL, ingestion, and pipeline failures, then proposes a scoped fix. Use it when data contracts or reprocessing behavior need a closer look. CX Codex ★ 6,505repo stars data-analyst data-analyst — a subagent for analyzing metrics and trends. Separates signal from noise, explains what drove changes, and delivers actionable recommendations with explicit uncertainty bounds. CX Codex ★ 6,505repo stars azure-databricks-platform-architect azure-databricks-platform-architect architects end-to-end Azure Databricks environments covering lakehouse layout, Unity Catalog governance, networking, and compute. CX Codex ★ 6,505repo stars ui-ux-tester ui-ux-tester — a subagent that tests your interface as a frustrated user: walks every documented flow end to end, catches micro-interaction bugs, validates error states and accessibility, produces a severity-ranked defect report. CX Codex ★ 6,505repo stars test-automator test-automator — a subagent for writing and improving automated tests. Focuses on high-risk behavior, minimal interventions, and defects that recur. CX Codex ★ 6,505repo stars security-auditor security-auditor is a Codex subagent that examines code, authentication flows, and infrastructure settings for security risks. It joins focused security review tasks. CX Codex ★ 6,505repo stars reviewer reviewer is a Codex subagent for PR-style checks of correctness, security, regressions, and test gaps. It joins tasks that call for a focused code review. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open