Skip to content

About

A senior Angular/TypeScript implementation agent for typed, accessible, tested frontend changes with minimal diffs.

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

7 Commits

Folders and files

Repository files navigation

Angular TypeScript Developer — Claude Code & Codex

Version: 1.1.0 · License: MIT · Maintainer: dimitriskl

Part of MyDevFactory. Its one-command installer sets up this agent, the other seven and the workflow skill together. You can also install this agent on its own (below).

A senior Angular/TypeScript implementation agent for typed, accessible, tested frontend changes with minimal diffs, ready for MyDevFactory slices.

What problem does it solve?

Implement focused Angular changes that are strictly typed, accessible, consistent with the codebase and verified by real builds and tests. It gives Claude Code and Codex a focused specialist with explicit boundaries, a practical workflow, and evidence-based reporting. No additional dependencies, accounts, model downloads, or MCP servers are required beyond the host coding tool.

Primary responsibilities: Angular components, services, routing, state (Signals/NgRx), RxJS, typed API clients, accessibility, and frontend tests.

This is an agent definition, not an executable app or a guarantee of correctness. The host tool, model, workspace permissions, available integrations, and user instructions determine what can actually run.

Included files

File Purpose
.claude/agents/angular-typescript-developer.md Claude Code custom subagent (install-ready name).
.codex/agents/angular-typescript-developer.toml Codex custom subagent (install-ready name).
releases/v1.1.0/angular-typescript-developer-v1.1.0.md Versioned Claude Code release snapshot.
releases/v1.1.0/angular-typescript-developer-v1.1.0.toml Versioned Codex release snapshot.
VERSION and CHANGELOG.md Release version and history.

The .md and .toml files are alternatives for different tools, not two agents that must run together. Install one or both depending on what you use. All agent definitions in this release declare version 1.1.0 in a comment; the release snapshots also contain the version in their filename. Do not rename the install-ready files to include a version suffix: the stable filenames are intentional for reliable upgrades.

Installation — project scope (recommended)

Clone the repository:

git clone https://github.com/dimitriskl/angular-typescript-developer.git
cd angular-typescript-developer

Copy the relevant definition into the root of your actual target code project, not into the agent's source repository.

Windows PowerShell

$Target = "C:\path\to\your-project"  # replace with your project directory
New-Item -ItemType Directory -Force "$Target/.claude/agents", "$Target/.codex/agents" | Out-Null
Copy-Item ".claude/agents/angular-typescript-developer.md" "$Target/.claude/agents/angular-typescript-developer.md"
Copy-Item ".codex/agents/angular-typescript-developer.toml" "$Target/.codex/agents/angular-typescript-developer.toml"

macOS / Linux / WSL

TARGET="/path/to/your-project"  # replace with your project directory
mkdir -p "$TARGET/.claude/agents" "$TARGET/.codex/agents"
cp ".claude/agents/angular-typescript-developer.md" "$TARGET/.claude/agents/angular-typescript-developer.md"
cp ".codex/agents/angular-typescript-developer.toml" "$TARGET/.codex/agents/angular-typescript-developer.toml"

If you only use Claude Code, copy only the .md file. If you only use Codex, copy only the .toml file.

Installation — personal scope (all projects)

Run from the cloned agent repository's root.

Windows PowerShell:

New-Item -ItemType Directory -Force "$HOME/.claude/agents", "$HOME/.codex/agents" | Out-Null
Copy-Item ".claude/agents/angular-typescript-developer.md" "$HOME/.claude/agents/angular-typescript-developer.md"
Copy-Item ".codex/agents/angular-typescript-developer.toml" "$HOME/.codex/agents/angular-typescript-developer.toml"

macOS / Linux / WSL:

mkdir -p "$HOME/.claude/agents" "$HOME/.codex/agents"
cp ".claude/agents/angular-typescript-developer.md" "$HOME/.claude/agents/angular-typescript-developer.md"
cp ".codex/agents/angular-typescript-developer.toml" "$HOME/.codex/agents/angular-typescript-developer.toml"

These are the exact locations read by Claude Code (.claude/agents or ~/.claude/agents) and Codex (.codex/agents or ~/.codex/agents). Your project's existing CLAUDE.md, AGENTS.md, tools and permissions still apply. If a new agents directory was created while Claude Code was already open, restart that session if the agent isn't recognized.

Use

Claude Code:

Use the angular-typescript-developer agent to add the Approve button to the invoice list. Match the existing API contract, handle loading/empty/error states, and run the relevant tests.

Codex CLI / IDE:

Delegate this task to the angular-typescript-developer custom agent: Use the angular-typescript-developer agent to add the Approve button to the invoice list. Match the existing API contract, handle loading/empty/error states, and run the relevant tests.

Codex normally discovers custom agents when they are configured in the recognized agent directories. To use subagents, request delegation explicitly in your Codex conversation. If your client or workspace restricts custom agents, check its available configuration.

MyDevFactory

This agent works as the frontend role of the MyDevFactory skill. Map it in your project's .engineering-workflow.json:

{ "agents": { "frontend": { "name": "angular-typescript-developer" } } }

Behavior and boundaries

  • Inspect project context and installed versions rather than assume the latest APIs exist.
  • Keep recommendations or edits within the requested scope and respect the repository's rules.
  • Do not invent tool access, test results, benchmarks, data or validation evidence.
  • Do not commit, push, deploy or change production resources without appropriate authorization.
  • Follow the agent instructions for role-specific checks, trade-offs, handoffs and reporting.

Codex custom agents inherit the parent's sandbox and approval policy; the TOML file cannot force a new sandbox. Even a read-only instruction is behavioral rather than enforceable isolation.

Updates and release policy

The current release is v1.1.0. Versioned snapshots are immutable. For future updates, edit the stable .md and .toml source definitions, bump VERSION, document changes in CHANGELOG.md, add corresponding releases/vX.Y.Z/ snapshots and create a Git tag vX.Y.Z. We use semantic versioning as a documentation convention (MAJOR = breaking instruction/behavior changes, MINOR = new capabilities, PATCH = corrections).

To upgrade, replace your installed stable .md/.toml files with the files from the desired tagged release. Check diffs before replacing custom local modifications.

Official documentation

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md. Please do not post private source code, credentials, sensitive dataset values or proprietary architecture in reports or examples.

License

MIT © 2026 Dimitris Klis. See LICENSE.

About

A senior Angular/TypeScript implementation agent for typed, accessible, tested frontend changes with minimal diffs.

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors