Skip to main content
subagent CX Codex

vue-expert · voltagent/awesome-codex-subagents — Codex subagent: Vue component debugging

vue-expert — a subagent for fixing Vue component issues, reactivity, and state problems. Maps execution boundaries and proposes minimal safe fixes that preserve project architecture.

MIT ★ 6,505 updated 2026-10-05

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

What vue-expert does

vue-expert handles Vue component behavior, Composition API patterns, routing, and state or rendering issues. It works as a production expert: first maps the exact execution boundary (entry point, data path, dependencies), finds the root cause, then proposes the smallest fix that won't break surrounding code.

It inspects reactivity — refs, reactive, computed, watch — examines prop and event contracts between components, tracks async data lifecycles. It validates the changed path through initial render, updates, and errors; catches watcher loops, checks parent-child compatibility, ensures forms and accessibility stay predictable. For Nuxt or SSR projects, it checks hydration boundaries.

Returns the exact module analyzed, what was observed or is at risk, the safest fix with tradeoff reasoning, what was verified directly and what still needs environment-level checks.

What it helps with

  • trace reactivity leaks in Composition API
  • fix watcher loops or stale reads
  • verify prop and event contracts between components
  • debug async data lifecycle and loading states
  • keep template rendering stable across conditional branches

Example prompts for the agent

  • Component stays pending after fetch, no console errors
  • Watcher spins in an infinite loop when a computed value updates
  • Form submits empty values even though v-model bindings look correct in the template

How to install vue-expert

Manually: put the files in place

.codex/agents/vue-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 vue-expert

How do I install vue-expert for Codex?

Add .codex/agents/vue-expert.toml to your project root with the subagent config. Codex will pick it up on the next run.

What does vue-expert do?

It analyzes Vue component, reactivity, routing, and state issues. It maps the exact problem boundary, identifies the root cause, and recommends the smallest fix that preserves the rest of the codebase.

What kinds of problems does vue-expert handle best?

Composition API issues, incorrect reactivity, async lifecycle bugs, component contracts, and rendering problems. If your project uses Nuxt or SSR, it will also check hydration boundaries.

Source text

vue-expert.toml · MIT
# vue-expert

Use when a task needs Vue expertise for component behavior, Composition API patterns, routing, or state and rendering issues.

Own Vue 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, 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:
- component state ownership and Composition API correctness
- reactivity boundaries (refs/reactive/computed/watch) in touched flows
- route/store integration behavior and async data lifecycle
- template rendering correctness and conditional branch stability
- event emission/prop contract consistency between components
- user-visible loading/error states and form interactions
- alignment with established Vue conventions in the repository

Quality checks:
- verify changed flow through initial render, update, and failure states
- confirm watchers/effects do not create loops or stale reads
- check prop/event contracts for parent-child compatibility
- ensure form and accessibility behavior remain predictable
- call out SSR or hydration checks if Nuxt/SSR boundaries are involved

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 global state or architecture changes for localized issues unless explicitly requested by the parent agent.

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

Similar subagents

All subagents for Frontend and UI →

vue-expert by other authors comes first.

vue-expert VoltAgent Community vue-expert — a Claude Code subagent focused on Vue 3, Composition API, and Nuxt 3. Invoke it for component architecture, reactivity tuning, or full Nuxt builds. CX Codex 577installs vue-expert 0xfurai vue-expert is a Claude Code subagent for Vue.js application development. It builds Single File Components and configures Vue Router and Vuex. CX Codex ★ 1,029repo stars vue Anthony Fu vue is a Claude Code skill for building Vue 3 components with the Composition API. It activates for Vue SFCs, script setup macros, watchers, and built-in components. CX Codex +1 36,900installs vue-debug-guides github.com/vuejs-ai vue-debug-guides — a skill for diagnosing Vue 3 errors: reactivity, watchers, components, templates, and hydration. When the agent sees a Vue bug, it looks up the cause in a catalog of common issues. CX Codex +1 28,400installs vue-best-practices github.com/vuejs-ai vue-best-practices enforces Vue 3 guidelines using Composition API and TypeScript. Helpful for structuring SFCs, managing reactivity, and writing composables. CX Codex +1 45,800installs vuejs-development manutej vuejs-development — a skill that gives your coding agent a Vue 3 reference: reactivity, Composition API, single-file components and directives. Useful when building an SPA or moving off the Options API. CX Codex +1 512installs vue-development travisjneuman vue-development — a Claude Code skill for building Vue 3 applications with the Composition API and Script Setup. Guides state setup in Pinia, custom composables, and Nuxt 3 full-stack tasks. CX Codex +1 143installs Expert Vue.js Frontend Engineer official github Expert Vue.js Frontend Engineer — a GitHub Copilot subagent for building Vue 3 frontends with TypeScript. It handles components, Pinia stores, tests and rendering performance as part of your coding session. CX Codex +1 ★ 41,430repo stars

From the same set176

The whole set →
deployment-engineer deployment-engineer reviews deployment changes, release strategy, and rollout or rollback risks. Use it when a release plan needs operational checks before the change goes live. CX Codex ★ 6,505repo stars database-administrator database-administrator — a subagent that reviews your database readiness: backups and recovery, replication, access control, performance, and risk. Catches issues that cause data loss or downtime. CX Codex ★ 6,505repo stars cloud-architect Reviews cloud architecture across compute, storage, and networking. Helps catch single points of failure and plan safe rollbacks. CX Codex ★ 6,505repo stars azure-infra-engineer The azure-infra-engineer subagent reviews and changes Azure infrastructure with security, reliability, and rollback in mind. Delegate work on resources, networking, identity, or automation. CX Codex ★ 6,505repo stars typescript-pro typescript-pro — a Codex subagent that fixes TypeScript compiler errors, interfaces, and types using minimal safe code edits. CX Codex ★ 6,505repo stars symfony-specialist symfony-specialist — a Codex subagent for Symfony work across routing, services, Doctrine, security, and application structure. Use it when a focused change must preserve existing behavior. CX Codex ★ 6,505repo stars swift-expert swift-expert — a subagent for Swift work on iOS and macOS. Treats production code as a contract, not a checklist: maps execution boundaries, identifies root causes, applies minimal changes, and validates impact on the rest of the codebase. CX Codex ★ 6,505repo stars sql-pro sql-pro designs SQL queries, reviews execution plans, debugs schema mismatches, and evaluates database migrations. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open