Skip to main content
subagent CX Codex

project-architect — Claude Code subagent

project-architect analyzes project requirements, recommends a tech stack, and scaffolds folder structure for new projects or architecture refactoring. Handles web apps, microservices, monorepos, and backend services.

no license ★ 1,357 updated 2026-03-01

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

What project-architect does

project-architect guides you through requirements analysis and recommends an appropriate technology stack—from frontend choices like React or Vue to backends in Node.js, Go, or Python. It covers common architectures: monolithic web apps, microservices, monorepos, and CLI tools.

Includes pre-built project templates, TypeScript and ESLint configurations, and sample docker-compose setups for local development. The subagent operates with Read, Write, Edit, Bash, and Glob tools, creating files, running setup scripts, and automating initialization.

Use it when starting a new project, adding a substantial feature that changes architecture, or restructuring existing code. Ensures consistent standards across your team: naming conventions, code organization, environment management.

What it helps with

  • select technology stack based on project requirements
  • create correct folder structure and configuration files
  • set up linters, formatters, and pre-commit hooks
  • prepare docker-compose for local development environment
  • automate project initialization with setup scripts

Example prompts for the agent

  • Create a new React app structure with TypeScript and Vite for a startup MVP
  • Help me restructure the backend—what should change for a microservices architecture?
  • Set up ESLint, Prettier, and pre-commit hooks for a team of five developers

How to install project-architect

Manually: put the files in place

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

How do I install project-architect in Claude Code?

Copy the content from .claude/agents/project-architect.md into that folder in your project. Create the folder if it doesn't exist. Reload Claude Code, and the subagent will appear in your available agents list.

What does project-architect do?

It analyzes your project requirements, recommends a suitable tech stack (frontend, backend, database, tooling), creates a folder structure following best practices, generates TypeScript and ESLint configs, and automates the initial project setup.

When should I use this subagent?

When starting a new project from scratch, adding a major feature that requires architectural changes, or refactoring an existing codebase. The subagent proactively suggests using itself to maintain consistent standards across these scenarios.

Similar subagents

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

From the same set112

The whole set →
audit-dependencies audit-dependencies audits dependency direction in Rust projects and flags layer violations. Use it when reviewing architecture or preparing a refactor. CX Codex +1 ★ 1,357repo stars build-skill build-skill walks a new Claude skill through four agents: requirement questions, file generation, validation, docs. You approve the spec before any file appears. CX Codex +1 ★ 1,357repo stars spec-elicitation spec-elicitation conducts a rigorous interview to turn rough feature concepts into detailed technical specifications before writing code. CX Codex +1 ★ 1,357repo stars audit-ports-adapters The audit-ports-adapters command audits ports and adapters in Rust code, checking trait placement, implementations, and whether use cases depend on abstractions. CX Codex +1 ★ 1,357repo stars parallel-tasks parallel-tasks pulls task queues from issue trackers and assigns independent items across multiple parallel agents without file conflicts. CX Codex +1 ★ 1,357repo stars code-reviewer-pro code-reviewer-pro — a Claude Code subagent that reviews code for quality, security and best practices. Runs right after you write or modify code. CX Codex ★ 1,357repo stars audit-env-variables audit-env-variables scans environment variables in a JS/TS codebase, flags unused ones, guesses the service behind each variable name, and maps where it's referenced in code. CX Codex +1 ★ 1,357repo stars release-manager release-manager handles SemVer bumps, drafts changelog records, and verifies checklists before production deployment. CX Codex ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open