Skip to main content
subagent CX Codex

architect · justxor — Claude Code subagent: planning and setup

The architect subagent examines a project before implementation, compares design options, and lays out a change plan. Use it to scope a feature or a major refactor.

MIT ★ 353 updated 2026-10-01

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/architect.md
Open on GitHub

What architect does

The architect subagent examines relevant code, existing patterns, and project constraints, including CLAUDE.md, configuration, and dependencies. It lays out 2–3 approaches, with affected files, trade-offs, risks, and an S/M/L effort estimate. Then it recommends one approach and explains the choice.

Its plan breaks the work into steps, each intended as a separate commit, while keeping the project working and naming tests. The agent has Read, Grep, Glob, and Bash tools, and uses the opus model. It does not write or edit code, so implementation must happen separately.

What it helps with

  • plan a feature before implementation begins
  • compare implementation options and their risks
  • identify files affected by a large change
  • break work into commits and name tests
  • collect open design questions for the developer

Example prompts for the agent

  • Ask architect to plan a notification feature by examining existing patterns and comparing implementation options.
  • Have architect assess the risks of moving to a new storage schema and outline the changes as separate commits.
  • Ask architect to read CLAUDE.md and propose ways to implement this change without writing code.

How to install architect

Manually: put the files in place

.claude/agents/architect.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 architect

How do I install architect in Claude Code?

Add the subagent definition to .claude/agents/architect.md.

What does the architect subagent do?

It studies the project, weighs architecture options, and recommends an approach with a step-by-step plan, tests, and open questions. It does not write or edit code.

Which tools does architect use?

It can use Read, Grep, Glob, and Bash, and runs on the opus model.

Source text

architect.md · MIT
---
name: architect
description: Архитектор-планировщик. Используй для проектирования новых фич, оценки вариантов реализации и планов крупных изменений ДО написания кода.
tools: Read, Grep, Glob, Bash
model: opus
---

Ты software architect. Ты НЕ пишешь и не редактируешь код — только исследуешь и планируешь.

При вызове:
1. Изучи релевантный код, существующие паттерны и ограничения (CLAUDE.md, конфиги, зависимости).
2. Предложи 2–3 варианта решения. Для каждого: суть, затрагиваемые файлы, плюсы, минусы, риски, оценка объёма (S/M/L).
3. Порекомендуй один вариант и обоснуй.
4. Дай пошаговый план реализации: каждый шаг — отдельный коммит, проект остаётся рабочим, указаны тесты.
5. Перечисли открытые вопросы к человеку.

Предпочитай простые решения, соответствующие существующим паттернам проекта.

© justxor · MIT · justxor/claude-code-pro-course

Similar subagents

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

architect by other authors comes first.

architect Pranay Yadav The architect subagent reads the project brief and guardrails, then writes a step-by-step implementation plan. It pauses for human approval before coding starts. CX Codex ★ 42,780repo stars architect Affaan Mustafa An opus-powered subagent for designing scalable software architecture, analyzing technical trade-offs, and drafting Architecture Decision Records. CX Codex ★ 6,739repo stars architect parcadei architect — a Claude Code subagent that studies your repo and saves a phased plan for a new feature or a third-party API integration. CX Codex ★ 3,951repo stars architect josstei architect is a Claude Code subagent for system design, component boundaries, trade-off analysis, and stack evaluation before coding begins. CX Codex ★ 489repo stars architect yahor-punko Architecture and task decomposition subagent that inspects codebases and prepares structured design briefs before coding begins. CX Codex ★ 121repo stars code-architect official Anthropic code-architect analyzes codebase patterns to produce architectural blueprints with file lists, component interfaces, data flows, and phased build sequences. CX Codex 1,439installs senior-architect sickn33 senior-architect — a skill for designing and reviewing system architecture based on explicit requirements, tradeoffs and evidence. Helps you choose an approach by examining current state, alternatives and risks. CX Codex +1 2,200installs solution-architect zebbern solution-architect is a subagent for Claude Code, Codex, and Cursor that compares architectural options and recommends one based on constraints. It is used when requirements are set but several designs are viable. CX Codex ★ 4,719repo stars systems-architect alirezarezvani The systems-architect subagent reviews system architecture, weighs design options, and helps document decisions. Use it when planning a system or reviewing an existing design. CX Codex ★ 788repo stars think tw93 think is a Claude Code skill that turns an idea into a concrete plan before coding starts. It activates for architecture decisions, build-or-drop judgments, and task handoffs. CX Codex +1 15,400installs Excalidraw Architect BV-Venky Excalidraw Architect is an MCP server for Claude Code that turns a system description into a laid-out .excalidraw file ready for editing. CX Codex +1 ★ 164repo stars

From the same set15

The whole set →
test-runner test-runner runs tests on modified files, diagnoses failures, and distinguishes real code bugs from outdated test suites. CX Codex ★ 353repo stars debugger The debugger subagent reproduces errors and failing tests, tracks down their cause, then checks the fix. Use it when a stack trace or unexpected behavior needs investigation. CX Codex ★ 353repo stars docs-writer docs-writer — a subagent that updates README, API docs, code comments, and ADRs whenever your code changes. It verifies actual behavior and keeps examples aligned with reality. CX Codex ★ 353repo stars pr-description pr-description generates clear pull request titles and descriptions by inspecting branch commits and diffs against main. CX Codex +1 ★ 353repo stars code-reviewer code-reviewer reads your diff, flags security holes, missing tests and edge cases, then returns a severity-sorted report with a file and line for each fix. CX Codex ★ 353repo stars write-tests write-tests generates unit tests for a chosen file or function while matching existing project patterns. It runs new checks and flags discovered bugs instead of bending assertions. CX Codex +1 ★ 353repo stars commit This skill reviews your working changes and creates a git commit in Conventional Commits format. Use it when you want an agent to make a commit that follows the repository’s message style. CX Codex +1 ★ 353repo stars refactor Runs refactoring as a sequence of small, behavior-preserving steps. Use it when you ask the agent to split a module or remove duplication. CX Codex +1 ★ 353repo stars

Project sponsors

Companies that keep this analytics open