Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
The Architect는 Claude Code를 활용하여 사용자의 아이디어를 상세한 소프트웨어 설계도로 변환해주는 메타 에이전트입니다. 탐색, 심층 조사, 설계, 설계도 생성의 4단계 워크플로를 통해 데이터베이스, API, 프론트엔드 등을 포함한 완전한 시스템 아키텍처를 구축합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Coding Assistants의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기완전한 소프트웨어 설계도(blueprint)를 설계하는 Claude Code 메타 에이전트.
무엇을 만들고 싶은지 설명하세요. 완전한 설계도를 얻으세요. Claude Code가 당신을 위해 그것을 구축하게 하세요.
tododeia.com · 영어 · 스페인어
당신이 집을 짓고 싶다고 상상해 보세요. 누군가 망치를 들기 전에, 모든 방, 모든 벽, 모든 파이프, 그리고 모든 전선을 보여주는 상세한 계획인 **설계도 (blueprint)**가 필요합니다. 설계도가 없다면 건축가들은 무엇을 해야 할지 모를 것입니다.
The Architect는 소프트웨어를 위해 이 역할을 수행합니다.
Claude Code에서 이 프로젝트를 열고, 당신이 무엇을 만들고 싶은지(웹사이트, 앱, SaaS, API — 무엇이든) 말하면, The Architect가 다음을 수행합니다:
.md)을 생성합니다이렇게 생각하면 쉽습니다:
당신: "Trello 같은 프로젝트 관리 앱을 만들고 싶어요"
↓
The Architect: 질문을 던지고, 모든 것을 설계합니다
...
당신은 아이디어를 설명합니다. The Architect는 계획을 만듭니다. Claude Code는 그것을 구축합니다.
The Architect는 4단계 워크플로 (workflow)를 따릅니다:
1단계: 탐색 (Discovery)
"무엇을 만들고 계신가요? 누구를 위한 것인가요? 규모는 어느 정도여야 하나요?"
The Architect는 당신의 아이디어를 이해하기 위해 2~3개의 질문을 던집니다. 당신의 답변을 바탕으로, 프로젝트를 6가지 아키타입 (6 archetypes, 프로젝트 유형) 중 하나로 분류합니다.
2단계: 심층 조사 (Deep Research)
"사용자 계정이 필요한가요? 결제가 필요한가요? 실시간 기능이 필요한가요?"
이제 당신의 프로젝트 유형에 특화된 질문을 던집니다. 또한 /deep-research와 같은 기술을 사용하여 모범 사례 (best practices)를 조사합니다.
3단계: 설계 (Design)
"제가 구축할 내용은 다음과 같습니다: Vercel 기반의 Next.js + Supabase + Clerk + Stripe..."
The Architect는 모든 결정에 대한 이유와 함께 완전한 기술 스택 (tech stack) 및 아키텍처 (architecture)를 제시합니다. 당신은 이를 확인하거나 조정합니다. 프론트엔드 프로젝트의 경우, /ui-ux-pro-max를 사용하여 전체 시각적 시스템 (visual system, 색상, 글꼴, 간격)을 설계합니다.
4단계: 설계도 생성 (Blueprint Generation)
The Architect는 최종 설계도인 단일 .md 파일을 생성합니다.
Claude Code가 프로젝트를 처음부터 배포 단계까지 구축하는 데 필요한 모든 것을 다루는 **16개 섹션 (16 sections)**의 단일 .md 파일을 생성합니다.
The Architect가 생성하는 모든 설계도 (Blueprint)에는 다음 내용이 포함됩니다:
| # | 섹션 (Section) | 포함 내용 |
|---|---|---|
| 1 | 프로젝트 개요 (Project Overview) | 비전, 목표, 성공 지표 |
| ... | 단계별 안내 (Step-by-step): 무엇을 먼저, 두 번째로, 세 번째로 구축할 것인가... | |
| 10 | 환경 설정 (Environment Setup) | 선결 조건, 환경 변수 (env vars), 초기 명령어 |
| 11 | 의존성 (Dependencies) | 용도별 모든 패키지 |
| 12 | 배포 (Deployment) | 호스팅, CI/CD, 도메인 |
| ... | 빌더 (Builder)를 위한 완전한 지침 — 바로 붙여넣기 가능 | |
| 16 | 규칙 (Rules) | 구축을 위한 타협 불가능한 제약 사항 |
섹션 9 (빌드 순서, Build Order)가 가장 중요합니다. 이 섹션은 Claude Code에게 무엇을 어떤 순서로 구축해야 하는지 정확히 알려주며, 이를 통해 Claude Code가 사용자에게 질문하지 않고도 자율적으로 작업할 수 있게 합니다.
The Architect는 각각 고유한 기본 스택 (Default Stack), 디렉토리 구조, 빌드 순서를 가진 6가지 유형의 프로젝트를 설계하는 방법을 알고 있습니다:
| 유형 (Type) | 예시 (Examples) | 기본 스택 (Default Stack) |
|---|---|---|
| SaaS / 웹 앱 (Web App) | Trello, Notion, Slack | Next.js + Supabase + Clerk + Stripe + Vercel |
| 마케팅 사이트 (Marketing Site) | 랜딩 페이지, 포트폴리오 | Astro + Tailwind + Sanity + Vercel |
| 모바일 앱 (Mobile App) | iOS/Android 앱 | Expo (React Native) + Supabase + NativeWind |
| API / 백엔드 (Backend) | REST API, 마이크로서비스 (microservices) | Hono + Drizzle + PostgreSQL + Railway |
| 내부 도구 (Internal Tool) | 관리자 패널, 대시보드 | Next.js + shadcn/ui + Prisma + Recharts |
| 콘텐츠 플랫폼 (Content Platform) | 블로그, 문서, CMS | Next.js + Sanity + Algolia + Vercel |
원하는 프로젝트 유형이 보이지 않나요? The Architect는 적응합니다. 위 목록은 시작점일 뿐, 한계가 아닙니다.
# 이 리포지토리(repo)를 클론(Clone)하세요
git clone https://github.com/Hainrixz/the-architect.git
# Claude Code에서 프로젝트를 여세요
...
끝입니다. Claude Code가 CLAUDE.md 파일을 읽으면 The Architect가 됩니다.
1단계: The Architect에게 무엇을 구축하고 싶은지 말하세요:
사용자: 팀 계정, Stripe 결제, 고객용 예약 페이지를 갖춘 레스토랑 예약 관리용 SaaS를 구축하고 싶습니다.
2단계: 질문에 답변하세요 (한 번에 2~3개씩, 대화하듯이).
3단계: 제안된 아키텍처 (Architecture)를 검토하세요. 확인하거나 조정합니다.
4단계: The Architect가 output/<project-name>-blueprint.md 경로에 청사진 (Blueprint)을 생성합니다.
5단계: 청사진을 사용하여 프로젝트를 구축하세요:
# 새 프로젝트 생성
mkdir ~/my-restaurant-saas
cp output/restaurant-saas-blueprint.md ~/my-restaurant-saas/CLAUDE.md
...
많은 질문에 답변하고 싶지 않으신가요? 다음과 같이 말하세요:
사용자: 레스토랑 예약용 SaaS를 만들어줘. 그냥 바로 만들어.
The Architect는 단 3개의 필수 질문만 던지며, 그 외의 모든 사항에는 스마트 기본값 (Smart defaults)을 사용합니다.
the-architect/
├── CLAUDE.md # 두뇌 — Claude를 The Architect로 만듭니다
├── knowledge/
...
The Architect는 설계 과정에서 Claude Code의 기술을 활용합니다:
| 기술 | 용도 |
|---|---|
/deep-research | 기술 및 베스트 프랙티스 (Best practices) 조사 |
/ui-ux-pro-max | 시각적 시스템 (색상, 글꼴, 간격) 설계 |
/find-skills | 구축 단계에서 권장할 기술 탐색 |
/playwright-cli | 참조 사이트 분석 |
그리고 청사진에 **구축 단계 (Build phase)**를 위한 기술을 추천합니다:
| 기술 | 추천 용도 |
|---|---|
/frontend-design | 프로덕션급 UI 구축 |
/shadcn-ui | 컴포넌트 라이브러리 설정 |
/seo-audit | 구축 후 SEO 감사 |
/humanizer | 콘텐츠를 자연스럽게 만들기 |
기여 (Contributions)를 환영합니다! 다음과 같은 방법으로 도움을 줄 수 있습니다:
새로운 아키타입 (Archetypes) 추가 — knowledge/archetypes/에 새로운 프로젝트 유형 추가
빌딩 블록 (Building blocks) 개선 — 더 나은 의사결정 매트릭스, 최신 기술 옵션 제공
청사진 템플릿 강화 — 더 많은 섹션, 더 나은 구조
번역 — The Architect를 더 많은 언어로 사용할 수 있도록 지원
MIT License. 자세한 내용은 LICENSE를 참조하세요.
집을 짓고 싶다고 상상해 보세요. 누군가 망치를 들기 전에, 모든 방, 모든 벽, 모든 배관과 모든 케이블을 보여주는 상세한 계획인 **설계도 (plano)**가 필요합니다. 설계도가 없다면 건설업자들은 무엇을 해야 할지 모를 것입니다.
The Architect는 소프트웨어를 위해 이 역할을 수행합니다.
이 프로젝트를 Claude Code에서 열고, 당신이 만들고 싶은 것(웹사이트, 앱, SaaS, API 등 무엇이든)을 말하면, The Architect가 다음을 수행합니다:
당신의 아이디어에 대해 스마트한 질문을 던집니다
시스템 전체를 설계합니다— 데이터베이스 (database), API, 프론트엔드 (frontend), 인증 (authentication), 결제 (payments) 등 모든 것을 포함합니다
상세한 블루프린트 (blueprint) 파일 (.md)을 생성합니다— 다른 Claude Code 인스턴스가 당신에게 아무것도 묻지 않고 단계별로 모든 것을 구축할 수 있을 만큼 상세합니다
이렇게 생각해보세요:
당신: "Trello와 같은 프로젝트 관리 앱을 만들고 싶어요"
↓
The Architect: 질문을 하고, 모든 것을 설계합니다
...
당신은 아이디어를 설명합니다. The Architect는 설계도를 만듭니다. Claude Code는 그것을 구축합니다.
The Architect는 4단계 흐름을 따릅니다:
"무엇을 만들고 있나요? 누구를 위한 것인가요? 규모는 어느 정도여야 하나요?"
The Architect는 당신의 아이디어를 이해하기 위해 2~3개의 질문을 던집니다. 당신의 답변을 바탕으로 프로젝트를 6가지 아키타입 (archetypes) (프로젝트 유형) 중 하나로 분류합니다.
"사용자 계정이 필요한가요? 결제가 필요한가요? 실시간 기능이 필요한가요?"
이제 당신의 프로젝트 유형에 특화된 구체적인 질문을 던집니다. 또한 /deep-research와 같은 스킬을 사용하여 베스트 프랙티스 (best practices)를 조사합니다.
"제가 구축한다면 다음과 같이 하겠습니다: Vercel 기반의 Next.js + Supabase + Clerk + Stripe..."
The Architect는 각 결정에 대한 이유와 함께 전체 기술 스택 (tech stack) 및 아키텍처 (architecture)를 제시합니다. 당신은 이를 확인하거나 조정합니다. 프론트엔드가 포함된 프로젝트의 경우, /ui-ux-pro-max를 사용하여 완전한 시각적 시스템(색상, 글꼴, 간격)을 설계합니다.
The Architect는 최종 블루프린트를 생성합니다 — Claude Code가 프로젝트를 처음부터 배포까지 구축하는 데 필요한 모든 것을 다루는 16개 섹션으로 구성된 단일 .md 파일입니다.
The Architect가 생성하는 각 블루프린트에는 다음이 포함됩니다:
| # | 섹션 | 포함 내용 |
|---|---|---|
| 1 | 프로젝트 비전 (Vision del Proyecto) | 비전, 목표, 성공 지표 |
| ... | 단계별 안내: 무엇을 먼저, 두 번째, 세 번째로 구축할 것인가... | |
| 10 | 환경 설정 (Setup del Entorno) | 사전 요구 사항, 환경 변수, 초기 명령어 |
| 11 | 의존성 (Dependencies) | 각 패키지와 그 목적 |
| 12 | 배포 (Deployment) | 호스팅, CI/CD, 도메인 |
| ... | 빌더를 위한 완전한 지침 — 바로 붙여넣기 가능 | |
| 16 | 규칙 (Rules) | 구축을 위한 타협 불가능한 제약 사항 |
섹션 9 (구축 순서, Orden de Construccion)가 가장 중요합니다. 이 섹션은 Claude Code에게 무엇을 어떤 순서로 구축해야 하는지 정확히 알려주어, 사용자에게 질문하지 않고도 자율적으로 작업할 수 있게 합니다.
The Architect는 6가지 유형의 프로젝트를 설계할 수 있으며, 각 유형은 기본 스택, 디렉토리 구조 및 구축 순서를 가지고 있습니다:
| 유형 | 예시 | 기본 스택 |
|---|---|---|
| SaaS / 웹 앱 (Web App) | Trello, Notion, Slack | Next.js + Supabase + Clerk + Stripe + Vercel |
| 마케팅 사이트 (Sitio de Marketing) | 랜딩 페이지, 포트폴리오 | Astro + Tailwind + Sanity + Vercel |
| 모바일 앱 (App Movil) | iOS/Android 앱 | Expo (React Native) + Supabase + NativeWind |
| API / 백엔드 (Backend) | REST API, 마이크로서비스 | Hono + Drizzle + PostgreSQL + Railway |
| 내부 도구 (Herramienta Interna) | 관리자 패널, 대시보드 | Next.js + shadcn/ui + Prisma + Recharts |
| 콘텐츠 플랫폼 (Plataforma de Contenido) | 블로그, 문서, CMS | Next.js + Sanity + Algolia + Vercel |
원하는 프로젝트 유형이 보이지 않나요? The Architect는 적응합니다. 이것들은 시작점일 뿐, 제한 사항이 아닙니다.
# 이 리포지토리를 클론하세요
git clone https://github.com/Hainrixz/the-architect.git
# Claude Code에서 프로젝트를 엽니다
...
그게 전부입니다. Claude Code가 CLAUDE.md 파일을 읽으면
The Architect로 변신합니다.
1단계: The Architect에게 무엇을 만들고 싶은지 말하세요:
사용자: 팀 계정, Stripe 결제, 고객용 예약 페이지를 갖춘 레스토랑 예약 관리용 SaaS를 만들고 싶어.
단계 2: 질문에 답하세요 (한 번에 2~3개씩, 대화하듯이).
단계 3: 제안된 아키텍처 (Architecture)를 검토하세요. 확인하거나 수정합니다.
단계 4: The Architect가 output/<project-name>-blueprint.md 경로에 청사진 (Blueprint)을 생성합니다.
단계 5: 청사진을 사용하여 프로젝트를 구축하세요:
# 새 프로젝트 생성
mkdir ~/mi-saas-restaurante
cp output/restaurant-saas-blueprint.md ~/mi-saas-restaurante/CLAUDE.md
...
질문에 많이 답하고 싶지 않으신가요? 다음과 같이 말하세요:
사용자: 레스토랑 예약용 SaaS를 만들어줘. 그냥 바로 구축해.
The Architect는 필수적인 질문 3가지만 던지며, 그 외의 모든 것에는 지능적인 기본값 (Default values)을 사용합니다.
the-architect/
├── CLAUDE.md # 두뇌 — Claude를 The Architect로 변신시킵니다
├── knowledge/
...
The Architect는 설계 과정 중에 Claude Code의 스킬 (Skills)을 사용합니다:
| 스킬 | 용도 |
|---|---|
/deep-research | 기술 및 베스트 프랙티스 (Best practices) 조사 |
/ui-ux-pro-max | 시각적 시스템 (색상, 글꼴, 간격) 설계 |
/find-skills | 구축 단계에서 추천할 스킬 탐색 |
/playwright-cli | 참조 사이트 분석 |
그리고 청사진에 **구축 단계 (Construction phase)**를 위한 스킬을 추천합니다:
| 스킬 | 추천 대상 |
|---|---|
/frontend-design | 프로덕션급 (Production-grade) UI 구축 |
/shadcn-ui | 컴포넌트 라이브러리 설정 |
/seo-audit | 구축 후 SEO 감사 |
/humanizer | 콘텐츠를 자연스럽게 만들기 |
기여 (Contributions)는 언제나 환영합니다! 다음과 같은 도움을 주실 수 있습니다:
새로운 아키타입 (Archetypes) 추가 — knowledge/archetypes/에 새로운 프로젝트 유형 추가
빌딩 블록 (Building blocks) 개선 — 더 나은 의사결정 매트릭스, 더 최신의 기술 옵션 제공
청사진 템플릿 개선 — 더 많은 섹션, 더 나은 구조 구성
번역 — The Architect를 더 많은 언어로 접근 가능하게 지원
MIT 라이선스. 자세한 내용은 LICENSE를 참조하세요.