# project-architect

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.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/project-architect.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/project-architect

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/project-architect.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/project-architect.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/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/project-architect.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/project-architect.md

## When to use it
- 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
- 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

## Similar
- [setup-development-environment](https://affpapa.org/en/nevibecode/commands/setup-development-environment.md) — command · 651 installs
- [spring-boot-project-creator](https://affpapa.org/en/nevibecode/skills/spring-boot-project-creator.md) — skill · 3700 installs
- [docker-project-foundations](https://affpapa.org/en/nevibecode/skills/docker-project-foundations.md) — skill · 1700 installs
- [golang-project-layout](https://affpapa.org/en/nevibecode/skills/golang-project-layout.md) — skill · 42900 installs
- [tao-setup-nvidia-gpu-host](https://affpapa.org/en/nevibecode/skills/tao-setup-nvidia-gpu-host.md) — skill · 1700 installs
- [hsb-setup](https://affpapa.org/en/nevibecode/skills/hsb-setup.md) — skill · 1700 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
