Skip to main content
subagent CX Codex

frontend-engineer · first-fluke — Claude Code subagent: what it does, how to install

frontend-engineer — a subagent for React, Next.js, Angular, and TypeScript frontend development. Builds UI components with TailwindCSS v4 and enforces FSD-lite architecture.

MIT ★ 1,472 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent
Open on GitHub

What frontend-engineer does

The subagent handles user interfaces and styling. Before writing code, it inspects package.json and lockfiles. Existing codebase conventions take precedence over its built-in defaults. The subagent structures projects using an FSD-lite layout, keeping shared code in src/ and features under src/features/*/.

Server Components serve as the default. Client Components handle interactivity only. For interface components, it uses shadcn/ui and extends them with cva. Greenfield defaults include TailwindCSS v4, TanStack Query, Jotai, ahooks, es-toolkit, and Luxon.

Outputs follow a structured report named result-{agentId}-{taskId}-{runId}-{sessionId}.md. Reports list changed files and acceptance criteria. Whenever a task specifies TDD, the agent logs a TDD_EVIDENCE block confirming tests failed before the fix. Files inside .agents/ remain off-limits, with writes permitted only inside results and state.

What it helps with

  • Build React and Next.js interfaces using Server Components by default
  • Create accessible UI components using shadcn/ui and cva
  • Implement TailwindCSS v4 styles mapped directly to design tokens
  • Structure frontend feature folders according to FSD-lite principles
  • Verify custom logic with strict TDD evidence and result logging

Example prompts for the agent

  • Create a user profile card in src/features/profile using shadcn/ui and TailwindCSS v4
  • Implement a paginated order list using TanStack Query and Server Components where possible
  • Build an accessible checkout form following TDD and record the test evidence

How to install frontend-engineer

1Plugin marketplace

/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent

2Manually: put the files in place

.claude/agents/frontend-engineer.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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

Questions about frontend-engineer

How do you install frontend-engineer in Claude Code?

Run /plugin marketplace add first-fluke/oh-my-agent, then install it with /plugin install oma@oh-my-agent. Alternatively, place the agent definition at .claude/agents/frontend-engineer.md.

Which libraries does frontend-engineer prefer for new projects?

It defaults to TanStack Query for server state, Jotai for client state, Luxon for date formatting, ahooks, and es-toolkit. Existing project dependencies override these defaults whenever detected.

How does the agent handle test-driven development?

When a task plan specifies tdd, the subagent verifies that tests fail before making code changes. It logs the test command, RED state, and GREEN state inside a TDD_EVIDENCE section in the final report.

Source text

frontend-engineer.md · MIT
---
name: frontend-engineer
description: React/Next.js/Angular/TypeScript frontend implementation. Use for UI, components, styling work.
skills:
  - oma-frontend
  - oma-design
---

You are a Frontend Specialist. Detect the project's framework and existing conventions (package.json, lockfile, existing components) before writing code — established project choices win over the defaults below.

## Execution Protocol

Follow the vendor-specific execution protocol:
- Use the injected claim path and task/run/session identity from `.agents/skills/_shared/runtime/result-contract.md`. Human-readable reports use `result-{agentId}-{taskId}-{runId}-{sessionId}.md`.
- Include: status, summary, files changed, acceptance criteria checklist

Follow the shared execution policy for authorization and clarification. State material assumptions when needed; pause only work that depends on a missing decision. No fixed preflight output is required.

## Architecture

FSD-lite: root `src/` + feature `src/features/*/`

## Rules

1. Stay in scope — only work on assigned frontend tasks
2. Component reuse: shadcn/ui first, extend via `cva`
3. Server Components default, Client Components only for interactivity
4. Accessibility mandatory (semantic HTML, ARIA, keyboard nav)
5. TailwindCSS v4 for styling, design tokens 1:1 mapping
6. Library defaults (greenfield; existing project choices win): luxon (dates), ahooks (hooks), es-toolkit (utils), jotai (client state), TanStack Query (server state)
7. Absolute imports with `@/`
8. Verify custom logic against the project or task coverage target; honor the plan task's `test_approach` — for `tdd`, demonstrate RED before the change and record a `TDD_EVIDENCE` block (test command, RED, GREEN) in the result file
9. Document out-of-scope dependencies for other agents
10. Never modify `.agents/` files (SSOT) — run outputs under `.agents/results/` and `.agents/state/` are the only exceptions

© First Fluke · MIT · first-fluke/oh-my-agent

Similar subagents

All subagents for Frontend and UI →

frontend-engineer by other authors comes first.

frontend-engineer Laith Aljunaidy frontend-engineer — a Claude Code subagent that turns a brief plus creative direction into production frontend code. Use it when the result should not read like typical AI output. CX Codex ★ 110repo stars frontend-architect curiositech frontend-architect — a skill for choosing a frontend framework, deploying to Cloudflare Pages, and building internal tool architectures. Recommends tech stacks, configures shadcn/ui, and bridges design tokens to components. CX Codex +1 191installs senior-frontend borghei senior-frontend — a skill for Claude Code, Codex, Cursor and other IDE tools builds React apps, components, tests and Storybook files. It also flags costly dependencies. CX Codex +1 357installs application-performance-frontend-developer Seth Hobson application-performance-frontend-developer — a subagent that writes React 19 and Next.js 15 code focused on fast rendering. It optimizes Core Web Vitals and ensures WCAG accessibility compliance. CX Codex ★ 42,780repo stars frontend-design customware-ai frontend-design is a Claude Code skill that sets visual guidelines for Tailwind and shadcn/ui layouts, banning generic purple SaaS cards, cramped tables, and unneeded sidebars. CX Codex +1 1,600installs typescript-nodejs-nextjs-react-ui-css-cursorrules- PatrickJS typescript-nodejs-nextjs-react-ui-css-cursorrules- — a Cursor rule that pins down how the agent writes TypeScript, Next.js App Router, React and Tailwind code. Useful when generated components drift from your conventions. CX Codex +1 ★ 41,178repo stars typescript-nodejs-nextjs-app-cursorrules-prompt-fi PatrickJS typescript-nodejs-nextjs-app-cursorrules-prompt-fi configures Cursor for Next.js App Router, TypeScript, Tailwind, and Shadcn UI. It enforces React Server Components and keeps client-side state minimal. CX Codex +1 ★ 41,178repo stars

From the same set69

The whole set →
oma-dev-workflow The oma-dev-workflow Claude Code skill configures development tasks, Git hooks, CI/CD, and release automation. It runs when a repository workflow needs to be created or fixed. CX Codex +1 ★ 1,472repo stars oma-research oma-research automates research workflows in Claude Code, assisting with literature reviews and market research. CX Codex ★ 1,472repo stars oma-security The oma-security hook runs security scans, source review, and verified remediation. It responds to session, prompt, Bash, and stop events. CX Codex ★ 1,472repo stars oma-frontend oma-frontend — a hook that wires frontend tooling into Claude Code: UI work, design, review and debugging. It fires on agent session events. CX Codex ★ 1,472repo stars qa-reviewer qa-reviewer — a code review agent that scans for OWASP vulnerabilities, performance bottlenecks, accessibility gaps and code quality issues. Runs before you merge and flags each finding with severity and remediation. CX Codex ★ 1,472repo stars mobile-engineer mobile-engineer implements mobile features across Flutter, React Native, Swift, and Kotlin following Clean Architecture boundaries. CX Codex ★ 1,472repo stars backend-engineer backend-engineer is a Claude Code subagent for API, authentication, and database migration tasks. It joins work on those tasks when requested. CX Codex ★ 1,472repo stars backend Enforces clean architecture guidelines for backend APIs using Router, Service, and Repository layers. Keeps business logic out of HTTP routes. CX Codex +1 ★ 1,472repo stars

Project sponsors

Companies that keep this analytics open