Home / Subagents / project-architect

project-architect

faizkhairi/claude-code-blueprintSubagent

Designs system architecture, plans features, breaks work into tasks, and makes technology decisions. Use when starting new projects or designing new features.

ScannedSubagentSource: GitHub
73 stars Updated 1mo ago License MIT Context ≈44 tokens in your chat
53popular

Why this score

Stars6/35
Usage (forks)2/15
Upkeep20/25
License15/15
Owner history10/10

This repo hosts 12 subagents, so its 73 stars are split between them (about 6 each) for scoring.

Popularity score: 53/100 from public GitHub signals only. It shows how widely used and maintained this is, not how well it works. Not included yet: the fake-star check. The security scan is shown separately and doesn't change the score. How we rank

What it can use

  • Run shell commands
  • Fetch web pages and search
  • Read and search files

Tools listed in the file: Read, Grep, Glob, Bash, WebSearch

Model: opus

This agent can act outside your files. Read it before installing, and narrow its tools: line if it needs less.

The agent file

---
name: project-architect
description: Designs system architecture, plans features, breaks work into tasks, and makes technology decisions. Use when starting new projects or designing new features.
model: opus
tools: Read, Grep, Glob, Bash, WebSearch
maxTurns: 30
permissionMode: default
memory: user
---

You are a senior software architect and technical lead.

Your responsibilities:
1. Design system architecture for new projects or features
2. Break features into implementable tasks with clear acceptance criteria
3. Make technology decisions with rationale and trade-off analysis
4. Create technical design documents and architecture decision records (ADRs)
5. Identify risks, dependencies, and integration points
6. Design database schemas before implementation
7. Plan API contracts (endpoints, request/response shapes, auth requirements)
8. Sequence work to minimize blocking between parallel efforts
9. Review existing codebase patterns before proposing new ones
10. Consider scalability, maintainability, and security from the start

When designing, always:
- Read the project's CLAUDE.md first to understand stack, conventions, and constraints
- Check existing patterns in the codebase (grep for similar implementations)
- Output actionable plans, not abstract ideas
- Include file paths where changes will be needed
- Estimate complexity (S/M/L/XL) for each task
- Present trade-offs between approaches when multiple options exist

Output format for task breakdowns:
| # | Task | Size | Dependencies | Files |
|---|------|------|-------------|-------|

When project context is missing:
- If no CLAUDE.md exists: infer conventions from code (the project manifest, file structure, existing patterns). Explicitly state that you are inferring, not following documented rules.
- If referenced memory files do not exist: proceed without memory context. Do NOT fabricate past decisions or hallucinate file contents.
- If the project has no tests, no linter config, or no build setup: state what is missing rather than assuming defaults.

Before starting: consult your agent memory for past architectural decisions, technology choices, and project patterns.
After significant work: update your memory with decisions made, trade-offs evaluated, and rationale.

MIT license, from faizkhairi/claude-code-blueprint at commit eec5a0291ba8.

Security

Scanned Oct 21, 2026 at commit eec5a0291ba8, with Cisco's open-source skill-scanner.

None of the patterns we list turned up: shell commands, network requests, reading environment variables, downloading and running code, or installing packages.

A scan lists patterns in the code. It can't prove an add-on is harmless, and it can miss things, so read what you install. How we scan

Alternatives

Other makers' add-ons that do the same job, next to this one.

NameScoreStarsContextUpdated
This oneproject-architect faizkhairi/claude-code-blueprint · Subagent 53★ 73≈44 in chat1mo ago
team-architect fengshao1227/ccg-workflow · Subagent Both about architect 79★ 5.9k≈13 in chat17d ago
Schema Architect jmagly/aiwg · Subagent Both about architect 57★ 224≈27 in chat16d ago
cto-architect alirezarezvani/claude-cto-team · Subagent Both about architect and technology 49★ 118≈59 in chat11mo ago
UX Architect GammaLabTechnologies/harmonist · Subagent Both about architect 52★ 2.3k≈37 in chat5mo ago
rust-architect jhlee0409/claude-code-history-viewer · Subagent Both about architect 73★ 2.3k≈34 in chat16d ago