by Hainrixz
The Architect — A Claude Code meta-agent that designs complete software blueprints. Describe what you want to build, get a self-contained .md file that Claude Code can build autonomously.
# Add to your Claude Code skills
git clone https://github.com/Hainrixz/the-architectImagine you want to build a house. Before anyone picks up a hammer, you need a blueprint — a detailed plan that shows every room, every wall, every pipe, and every wire. Without it, the builders wouldn't know what to do.
The Architect does this for software.
You open this project in Claude Code, tell it what you want to build (a website, an app, a SaaS, an API — anything), and The Architect:
.md) so detailed that another Claude Code instance can build the whole thing — step by step, without asking you anythingThink of it like this:
You: "I want to build a project management app like Trello"
↓
The Architect: asks questions, designs everything
↓
Blueprint.md: complete plan with tech stack, database schema,
API routes, component hierarchy, build order...
↓
Claude Code: reads the blueprint → builds the entire app
You describe the idea. The Architect creates the plan. Claude Code builds it.
The Architect follows a 4-phase workflow:
"What are you building? Who is it for? How big should it be?"
The Architect asks 2-3 questions to understand your idea. Based on your answers, it classifies your project into one of 6 archetypes (project types).
No comments yet. Be the first to share your thoughts!
"Do you need user accounts? Payments? Real-time features?"
Now it asks questions specific to YOUR type of project. It also researches best practices using skills like /deep-research.
"Here's what I'd build: Next.js + Supabase + Clerk + Stripe on Vercel..."
The Architect presents the complete tech stack and architecture with reasons for every decision. You confirm or adjust. For frontend projects, it designs a full visual system (colors, fonts, spacing) using /ui-ux-pro-max.
The Architect produces the final blueprint — a single .md file with 16 sections covering everything Claude Code needs to build your project from zero to deployed.
Every blueprint The Architect generates includes:
| # | Section | What It Contains | |---|---------|-----------------| | 1 | Project Overview | Vision, goals, success metrics | | 2 | Tech Stack | Every technology with rationale | | 3 | Directory Structure | Full file tree with explanations | | 4 | Data Model | Entities, fields, relationships, SQL schema | | 5 | API Design | Routes, endpoints, request/response shapes | | 6 | Frontend Architecture | Pages, components, state management | | 7 | Design System | Colors, fonts, spacing, component style | | 8 | Auth & Authorization | Login flow, roles, permissions | | 9 | Build Order | Step-by-step: what to build first, second, third... | | 10 | Environment Setup | Prerequisites, env vars, initial commands | | 11 | Dependencies | Every package with its purpose | | 12 | Deployment | Hosting, CI/CD, domains | | 13 | Testing | What to test, which tools, when | | 14 | Skills to Use | Which Claude Code skills help during the build | | 15 | CLAUDE.md | Complete instructions for the builder — ready to paste | | 16 | Rules | Non-negotiable constraints for the build |
Section 9 (Build Order) is the most important. It tells Claude Code exactly what to build and in what order — so it can work autonomously without asking you questions.
The Architect knows how to design 6 types of projects, each with its own default stack, directory structure, and build order:
| Type | Examples | Default Stack | |------|----------|--------------| | SaaS / Web App | Trello, Notion, Slack | Next.js + Supabase + Clerk + Stripe + Vercel | | Marketing Site | Landing pages, portfolios | Astro + Tailwind + Sanity + Vercel | | Mobile App | iOS/Android apps | Expo (React Native) + Supabase + NativeWind | | API / Backend | REST APIs, microservices | Hono + Drizzle + PostgreSQL + Railway | | Internal Tool | Admin panels, dashboards | Next.js + shadcn/ui + Prisma + Recharts | | Content Platform | Blogs, docs, CMS | Next.js + Sanity + Algolia + Vercel |
Don't see your project type? The Architect adapts — these are starting points, not limits.
# Clone this repo
git clone https://github.com/Hainrixz/the-architect.git
# Open the project in Claude Code
cd the-architect
claude
That's it. Claude Code reads the CLAUDE.md file and becomes The Architect.
Step 1: Tell The Architect what you want to build:
You: I want to build a SaaS for managing restaurant reservations
with team accounts, Stripe payments, and a customer-facing booking page.
Step 2: Answer the questions (2-3 at a time, conversational).
Step 3: Review the proposed architecture. Confirm or adjust.
Step 4: The Architect generates your blueprint at output/<project-name>-blueprint.md.
Step 5: Use the blueprint to build your project:
# Create your new project
mkdir ~/my-restaurant-saas
cp output/restaurant-saas-blueprint.md ~/my-restaurant-saas/CLAUDE.md
# Open it in Claude Code — it builds everything from the blueprint
cd ~/my-restaurant-saas
claude
Don't want to answer many questions? Say:
You: Build me a SaaS for restaurant reservations. Just build it.
The Architect asks only 3 essential questions and uses smart defaults for everything else.
the-architect/
├── CLAUDE.md # The brain — makes Claude become The Architect
├── knowledge/
│ ├── archetypes/ # 6 project type templates
│ │ ├── saas-webapp.md # SaaS apps
│ │ ├── marketing-site.md # Landing pages
│ │ ├── mobile-app.md # Mobile apps
│ │ ├── api-backend.md # APIs & backends
│ │ ├── internal-tool.md # Admin panels
│ │ └── content-platform.md # Blogs & CMS
│ ├── building-blocks/ # 8 cross-cutting decision guides
│ │ ├── auth-patterns.md # Authentication options
│ │ ├── database-patterns.md # Database & ORM choices
│ │ ├── deployment-patterns.md # Hosting & CI/CD
│ │ ├── api-design-patterns.md # REST vs tRPC vs GraphQL
│ │ ├── frontend-stacks.md # Framework comparisons
│ │ ├── testing-patterns.md # Testing strategies
│ │ ├── styling-systems.md # CSS & design tokens
│ │ └── state-management.md # State & real-time patterns
│ ├── skills-registry.md # Maps Claude Code skills to blueprint sections
│ └── stack-compatibility.md # What works together (and what doesn't)
├── templates/
│ ├── blueprint-template.md # The 16-section output skeleton
│ └── claude-md-template.md # Template for the target project's CLAUDE.md
├── questions/
│ ├── phase-1-discovery.md # Universal discovery questions
│ ├── phase-2-branches.md # Archetype-specific deep dives
│ └── phase-3-confirmation.md # Architecture confirmation
└── output/ # Generated blueprints go here
The Architect leverages Claude Code skills during the design process:
| Skill | Used For |
|-------|----------|
| /deep-research | Researching technologies and best practices |
| /ui-ux-pro-max | Designing visual systems (colors, fonts, spacing) |
| /find-skills | Discovering skills to recommend for the build phase |
| /playwright-cli | Analyzing reference sites |
And recommends skills for the build phase in the blueprint:
| Skill | Recommended For |
|-------|----------------|
| /frontend-design | Building production-grade UIs |
| /shadcn-ui | Setting up component libraries |
| /seo-audit | SEO auditing after build |
| /humanizer | Making content sound natural |
Contributions are welcome! You can help by:
knowledge/archetypes/MIT License. See LICENSE for details.
Imagina que quieres construir una casa. Antes de que alguien agarre un martillo, necesitas un plano — un plan detallado que muestre cada cuarto, cada pared, cada tuberia y cada cable. Sin el, los constructores no sabrian que hacer.