단계 1: Bootstrap - 제품 아이디어 구조화

Bootstrap은 Agent App Factory 파이프라인의 첫 번째 단계로, 모호한 제품 아이디어를 명확한 input/idea.md 문서로 정리하는 역할을 합니다. 이는 후속 PRD, UI, Tech 등 모든 단계의 출발점이며, 전체 프로젝트의 방향과 품질을 결정합니다.

학습 완료 후 할 수 있는 것

• 모호한 제품 아이디어를 표준 템플릿에 맞는 input/idea.md 문서로 정리
• Bootstrap Agent의 역할 범위 이해(정보만 수집, 요구사항을 창출하지 않음)
• superpowers:brainstorm 스킬을 사용하여 제품 아이디어를 심층 분석하는 방법
• Bootstrap 단계에 포함되어야 할 정보와 포함되지 않아야 할 정보를 판단하는 능력

현재의 어려움

제품 아이디어가 있지만 모호하게 설명하고 있을 수 있습니다:

• "피트니스 앱을 만들고 싶어요"(너무 광범위)
• "샤오홍슈 같은 앱을 만들어요"(차별화점이 없음)
• "사용자에게 더 나은 작업 관리 도구가 필요해요"(구체적인 문제가 없음)

이러한 모호한 설명은 후속 단계(PRD, UI, Tech)에 명확한 입력이 부족하게 만들어, 최종적으로 생성된 앱이 예상과 완전히 다를 수 있습니다.

언제 이 방법을 사용하나요

파이프라인을 시작할 준비가 되었고 다음 조건을 충족할 때:

1. 초기 제품 아이디어가 있음(한 문장이라도 괜찮음)
2. 아직 요구사항 문서를 작성하지 않음(PRD는 후속 단계)
3. 아직 기술 스택이나 UI 스타일을 결정하지 않음(이것들은 후속 단계)
4. 제품 범위를 통제하여 과도한 설계를 피하고 싶음(Bootstrap 단계에서 비목표를 명확히 함)

🎒 시작 전 준비

전제 조건

Bootstrap 단계를 시작하기 전에 다음을 확인하세요:

• ✅ 프로젝트 초기화 완료
• ✅ 7단계 파이프라인 개요 이해
• ✅ AI 어시스턴트 설치 및 구성 완료(Claude Code 권장)
• ✅ 제품 아이디어 준비 완료(모호해도 괜찮음)

핵심 개념

Bootstrap 단계란 무엇인가?

Bootstrap은 전체 파이프라인의 시작점으로, 유일한 책임은 조각난 제품 아이디어를 구조화된 문서로 정리하는 것입니다.

제품 관리자가 아님

Bootstrap Agent는 제품 관리자가 아니며, 요구사항을 창출하거나 기능을 설계하지 않습니다. 그 임무는:

• 이미 제공한 정보 수집
• 정보 정리 및 조직
• 표준 템플릿에 따라 제시

"어떤 기능이 있어야 하는지"를 결정하지 않고, "무엇을 원하는지"를 명확히 하는 것을 돕습니다.

왜 구조화가 필요한가?

상상해보세요, 요리사에게 "맛있는 것을 먹고 싶어요"라고 말하는 것을

• ❌ 모호한 설명: 요리사는 추측할 수밖에 없고, 완전히 먹고 싶지 않은 요리를 만들 수 있음
• ✅ 구조화된 설명: "매콤하고, 고수를 넣지 않은 사천 요리를 원해요, 밥 반찬으로 먹고 싶어요"

Bootstrap 단계는 "맛있는 것을 먹고 싶어요"를 "매콤하고, 고수를 넣지 않은 사천 요리"로 바꾸는 것입니다.

출력 문서 구조

Bootstrap 단계는 input/idea.md를 생성하며, 다음 장을 포함합니다:

장	내용	예시
간략한 설명	1-2문장으로 제품 요약	"모바일 가계부 앱으로, 젊은이들이 일일 지출을 빠르게 기록하도록 도움"
문제 (Problem)	사용자가 겪는 핵심 고통	"젊은이들이 월말에 초과 지출을 발견하지만, 돈이 어디에 쓰였는지 모름"
타겟 사용자 (Target User)	구체적인 인물 프로필	"18-30세 직장 초년생, 기술 능력 중간 수준"
핵심 가치 (Core Value)	왜 가치가 있는가	"3초 기록, 수동 조회보다 80% 시간 절약"
가정 (Assumptions)	2-4개의 검증 가능한 가정	"예산을 통제할 수 있다면, 사용자는 2분을 들여 앱을 배울 의향이 있음"
비목표 (Non-Goals)	명확히 하지 않을 것	"예산 계획 및 재무 조언은 하지 않음"

따라하기

1단계: 제품 아이디어 준비

파이프라인을 시작하기 전에 제품 아이디어를 명확히 하세요. 완전한 설명일 수도 있고, 단순한 생각일 수도 있습니다.

예시:

피트니스 앱을 만들고 싶어요. 피트니스 초보자가 훈련을 기록하는 것을 도와주고, 운동 유형, 시간, 칼로리를 포함하며, 이번 주 통계도 볼 수 있어요.

아이디어는 거칠어도 괜찮음

한 문장이라도 괜찮습니다. Bootstrap Agent는 superpowers:brainstorm 스킬을 통해 완전한 정보를 보충해 드립니다.

2단계: Bootstrap 단계로 파이프라인 시작

Factory 프로젝트 디렉토리에서 실행:

# 파이프라인 시작(아직 시작하지 않은 경우)
factory run

# 또는 bootstrap부터 직접 시작
factory run bootstrap

CLI는 현재 상태와 사용 가능한 단계를 표시합니다.

3단계: AI 어시스턴트가 Bootstrap Agent 정의 읽기

AI 어시스턴트(예: Claude Code)는 자동으로 agents/bootstrap.agent.md를 읽어 역할과 제약을 이해합니다.

Agent 역할

Bootstrap Agent는 다음만 할 수 있습니다:

• 대화에서 사용자가 제공한 제품 아이디어 읽기
• input/idea.md 쓰기

다음은 할 수 없습니다:

• 다른 파일 읽기
• 다른 디렉토리 쓰기
• 새 요구사항 창출

4단계: superpowers:brainstorm 스킬 강제 사용

이것이 Bootstrap 단계의 핵심 단계입니다. AI 어시스턴트는 반드시 superpowers:brainstorm 스킬을 호출해야 합니다. 정보가 이미 완전하다고 생각하더라도 마찬가지입니다.

brainstorm 스킬의 역할:

1. 문제 본질 심층 분석: 구조화된 질문을 통해 설명의盲点 발견
2. 타겟 사용자 프로필 명확화: "누구에게 팔 것인지" 명확히 하기
3. 핵심 가치 검증: 경쟁 제품과 비교하여 차별점 찾기
4. 암묵적 가정 식별: 기본적으로 설정했지만 검증되지 않은 가정 나열
5. 제품 범위 통제: 비목표를 통해 경계 명확히 하기

AI 어시스턴트가 할 일:

• superpowers:brainstorm 스킬 호출
• 원본 아이디어 제공
• 스킬이 생성한 질문을 통해 사용자에게 질문
• 답변 수집 및 아이디어 완성

이 단계를 건너뛰면 거부됨

Sisyphus 스케줄러는 brainstorm 스킬 사용 여부를 검증합니다. 사용하지 않으면 Bootstrap Agent가 생성한 산출물이 거부되고, 다시 실행해야 합니다.

5단계: idea.md 내용 확인

Bootstrap Agent가 완료되면 input/idea.md를 생성합니다. 다음을 주의 깊게 확인하세요:

체크포인트 ✅:

1. 간략한 설명이 명확한가?

   • ✅ 포함: 무엇을 하는가 + 누구를 위한가 + 어떤 문제를 해결하는가
   • ❌ 너무 광범위: "효율성을 높이는 도구"

2. 문제 설명이 구체적인가?

   • ✅ 포함: 상황 + 어려움 + 부정적인 결과
   • ❌ 공허함: "사용자 경험이 좋지 않음"

3. 타겟 사용자가 명확한가?

   • ✅ 구체적인 프로필(연령/직업/기술 능력)
   • ❌ 모호함: "모든 사람"

4. 핵심 가치가 정량화 가능한가?

   • ✅ 구체적인 이점(80% 시간 절약)
   • ❌ 공허함: "효율성 향상"

5. 가정이 검증 가능한가?

   • ✅ 사용자 조사를 통해 검증 가능
   • ❌ 주관적 판단: "사용자가 좋아할 것"

6. 비목표가 충분한가?

   • ✅ 하지 않을 기능 3가지 이상 나열
   • ❌ 누락 또는 너무 적음

6단계: 계속, 재시도 또는 일시 중지 선택

확인이 완료되면 CLI는 옵션을 표시합니다:

작업을 선택하세요:
[1] 계속(PRD 단계로 진입)
[2] 재시도(idea.md 다시 생성)
[3] 일시 중지(나중에 계속)

코드 편집기에서 먼저 확인 권장

AI 어시스턴트에서 확인하기 전에 코드 편집기에서 input/idea.md를 열어 글자별로 확인하세요. PRD 단계로 진입하면 수정 비용이 더 높아집니다.

함정 경고

함정 1: 아이디어 설명이 너무 모호함

잘못된 예시:

피트니스 앱을 만들고 싶어요

결과: Bootstrap Agent는 brainstorm 스킬을 통해 많은 질문을 하고 정보를 보충합니다.

권장: 처음부터 명확하게 설명:

모바일 피트니스 앱을 만들고 싶어요. 피트니스 초보자가 훈련을 기록하는 것을 도와주고, 운동 유형, 시간, 칼로리를 포함하며, 이번 주 통계도 볼 수 있어요.

함정 2: 기술 구현 세부사항 포함

잘못된 예시:

React Native로 구축하고, 백엔드는 Express, 데이터베이스는 Prisma를 사용하고 싶어요...

결과: Bootstrap Agent는 이 내용을 거부합니다(제품 아이디어만 수집하고, 기술 스택은 Tech 단계에서 결정).

권장: "무엇을 하는가"만 말하고, "어떻게 하는가"는 말하지 마세요.

함정 3: 타겟 사용자 설명이 너무 광범위함

잘못된 예시:

피트니스가 필요한 모든 사람

결과: 후속 단계에서 명확한 설계 방향을 제시할 수 없습니다.

권장: 명확한 프로필:

18-30세 피트니스 초보자, 체계적인 훈련을 막 시작했으며, 기술 능력 중간 수준, 간단한 기록과 통계 조회를 원함.

함정 4: 비목표 누락 또는 너무 적음

잘못된 예시:

비목표: 없음

결과: 후속 PRD 및 Code 단계에서 과도한 설계가 이루어져 기술 복잡성이 증가할 수 있습니다.

권장: 3가지 이상 나열:

비목표:
- 팀 협업 및 소셜 기능(MVP는 개인에 집중)
- 복잡한 데이터 분석 및 보고서
- 타사 피트니스 장비와의 통합

함정 5: 가정이 검증 불가능함

잘못된 예시:

가정: 사용자가 우리의 디자인을 좋아할 것

결과: 사용자 조사를 통해 검증할 수 없어 MVP가 실패할 수 있습니다.

권장: 검증 가능한 가정 작성:

가정: 체계적인 훈련 기록에 도움이 된다면, 사용자는 5분을 들여 앱을 배울 의향이 있음.

수업 요약

Bootstrap 단계의 핵심은 구조화입니다:

1. 입력: 모호한 제품 아이디어
2. 과정: AI 어시스턴트가 superpowers:brainstorm 스킬을 통해 심층 분석
3. 출력: 표준 템플릿에 맞는 input/idea.md
4. 검증: 설명이 구체적인지, 사용자가 명확한지, 가치가 정량화 가능한지 확인

핵심 원칙

• ❌ 하지 않는 것: 요구사항 창출, 기능 설계, 기술 스택 결정
• ✅ 하는 것: 정보 수집, 정리 및 조직, 템플릿에 따라 제시

다음 수업 예고

다음 수업에서는 **단계 2: PRD - 제품 요구사항 문서 생성**을 학습합니다.

배울 내용:

• idea.md를 MVP 수준 PRD로 변환하는 방법
• PRD에 포함되는 내용(사용자 스토리, 기능 목록, 비기능 요구사항)
• MVP 범위와 우선순위를 명확히 하는 방법
• PRD에 기술 세부사항을 포함하지 않는 이유

---

부록: 소스 코드 참조

클릭하여 소스 코드 위치 보기

업데이트 시간: 2026-01-29

기능	파일 경로	라인 번호
Bootstrap Agent 정의	agents/bootstrap.agent.md	1-93
Bootstrap Skill	skills/bootstrap/skill.md	1-433
파이프라인 정의(Bootstrap 단계)	pipeline.yaml	8-18
스케줄러 정의	agents/orchestrator.checkpoint.md	1-100+

핵심 제약:

• brainstorm 스킬 강제 사용: bootstrap.agent.md:70-71
• 기술 세부사항 금지: bootstrap.agent.md:47
• 여러 아이디어 병합 금지: bootstrap.agent.md:48
• 출력 파일은 input/idea.md에 저장: bootstrap.agent.md:50

종료 조건(pipeline.yaml:15-18):

• idea.md 존재
• idea.md가 일관된 제품 아이디어를 설명
• Agent가 superpowers:brainstorm 스킬을 사용하여 심층 분석 수행

Skill 내용 프레임워크:

• 사고 프레임워크: 추출 vs 창출, 문제 우선, 구체화, 가정 검증
• 질문 템플릿: 문제, 타겟 사용자, 핵심 가치, MVP 가정, 비목표에 관하여
• 정보 추출 기술: 기능에서 문제 역추적, 불만에서 요구사항 추출, 암묵적 가정 식별
• 품질 체크리스트: 완전성, 구체성, 일관성, 금지 항목
• 의사결정 원칙: 질문 우선, 문제 지향, 구체가 추상보다 우수, 검증 가능성, 범위 통제
• 일반적인 상황 처리: 사용자가 한 문장만 제공, 많은 기능 설명, 경쟁 제품 설명, 모순된 아이디어
• 예시 비교: 나쁜 idea.md vs 좋은 idea.md