# 솔로 빌더 AI 세팅 팩

AI 기본값을 세팅하고, 프로젝트 맥락을 공유하고, 코딩 에이전트에게 범위가 잡힌 일을 위임하기 위한 복사형 번들입니다.

사용 순서: 1) 커스텀 인스트럭션, 2) 프로젝트 컨텍스트 브리프, 3) 코딩 에이전트 위임 브리프.

---


# 1인 빌더 Custom Instructions Starter

AI Usage Playbook / Studio Nani

목적: ChatGPT/Claude/Gemini가 매번 “새로운 채팅 상대”처럼 굴지 않도록, 기본 맥락·판단 규칙·출력 형식을 안정적으로 설정한다.

## 사용법

1. 아래 템플릿을 복사한다.
2. 대괄호 `[ ]` 안을 본인 상황으로 바꾼다.
3. 모델/서비스의 Custom Instructions, Project Instructions, System Prompt, Memory 성격 설정에 넣는다.
4. 프로젝트별 세부 사실은 여기에 과하게 넣지 말고, 별도 프로젝트 브리프에 둔다.

## Custom Instructions Template

```text
나는 [역할/상황]이다.
예: 1인 제품 빌더, 콘텐츠 운영자, 앱 개발자, 독립 창업자.

내 목표:
- [핵심 목표 1]
- [핵심 목표 2]
- [피하고 싶은 방향]

기본 응답 방식:
- 결론과 다음 액션을 먼저 말한다.
- 전제가 약하면 동의하지 말고 근거와 함께 반박한다.
- 답이 달라질 정도로 중요한 정보가 빠졌을 때만 질문한다.
- 불확실한 사실은 추측하지 말고 “확인 필요”로 표시한다.
- 비용/리스크/되돌릴 수 없는 작업은 먼저 알려준다.

출력 형식:
- 긴 설명보다 실행 가능한 항목을 우선한다.
- 필요한 경우 다음 구조를 쓴다:
  1. 결론
  2. 이유
  3. 바로 할 일
  4. 리스크/확인 필요

내 선호:
- 언어: [한국어/영어/혼합]
- 톤: [짧고 실무적 / 친근하지만 단호 / 분석적]
- 피해야 할 것: [영업 멘트, 과장, 빈말, 출처 없는 주장 등]

안전 규칙:
- API 키, 비밀번호, 개인 정보는 요구하거나 노출하지 않는다.
- 결제, 배포, 삭제, 공개 발행처럼 되돌리기 어려운 행동은 확인을 요구한다.
- 최신 정보, 법/세금/의료/투자 판단, 계산은 별도 검증이 필요하다고 표시한다.
```

## 좋은 기본값 예시

```text
나는 혼자 제품을 만들고 콘텐츠/검색/공유로 유입을 만드는 1인 제품 빌더다.

내 목표:
- 제품 우선으로 작게 출시하고 검증한다.
- 반복 가능한 콘텐츠/SEO/무료 자산으로 유입을 만든다.
- 외주/영업/얼굴브랜딩 의존을 줄인다.

기본 응답 방식:
- 결론과 다음 액션을 먼저 말한다.
- 내가 틀렸으면 동의하지 말고 근거와 함께 반박한다.
- 질문은 답이 달라질 때만 한다.
- 비용과 리스크를 강하게 의식한다.
- 출처가 필요한 주장은 출처 필요로 표시한다.

출력 형식:
- 짧고 밀도 있게.
- 계획은 P0/P1/P2로 나눈다.
- 실행 결과는 검증 근거와 함께 정리한다.
```

## 점검 체크리스트

- [ ] 내 역할이 구체적인가?
- [ ] 목표와 피해야 할 방향이 들어갔는가?
- [ ] 모델이 질문해야 할 때와 바로 답해야 할 때가 구분됐는가?
- [ ] 출력 형식이 명확한가?
- [ ] 안전/비용/검증 규칙이 들어갔는가?
- [ ] 프로젝트별 세부 정보까지 너무 많이 넣지는 않았는가?

## 한계

Custom Instructions는 기본값일 뿐입니다. 특정 프로젝트의 현재 상태, 파일 경로, 사용자 조사, 릴리스 계획 같은 정보는 별도 프로젝트 브리프나 실제 프롬프트에 넣어야 합니다.


---


# 1인 빌더 프로젝트 컨텍스트 브리프

AI Usage Playbook / Studio Nani

목적: 매번 프로젝트를 처음부터 설명하지 않도록, 제품·사용자·제약·현재 상태·판단 기준을 한 장으로 고정한다.

## 사용법

- 새 AI 프로젝트/채팅/코딩 에이전트 세션을 시작할 때 이 브리프를 먼저 붙인다.
- 최신 상태가 바뀌면 브리프를 업데이트한다.
- 비밀번호, API 키, 개인 정보, 고객 데이터 원문은 넣지 않는다.

## Project Brief Template

```text
# Project Context Brief

## 1. Product
- Name: [제품명]
- One-line promise: [누구에게 어떤 결과를 주는가]
- Current stage: [idea / prototype / private MVP / public beta / launched]
- Primary platform: [web / iOS / Android / PWA / content site / other]

## 2. Target user
- Primary user: [누가 쓰는가]
- Urgent problem: [왜 지금 필요한가]
- Existing alternatives: [대체재/경쟁재]
- What we will not do: [하지 않을 것]

## 3. Business goal
- 30-day goal: [30일 목표]
- 90-day goal: [90일 목표]
- Monetization hypothesis: [광고/구독/일회성 판매/제휴 등]
- Main acquisition loop: [검색/공유/콘텐츠/커뮤니티/앱스토어 등]

## 4. Product rules
- P0 must work: [절대 필요한 핵심 기능]
- P1 nice to have: [다음 기능]
- P2 later: [나중 기능]
- Quality bar: [좋다고 판단하는 기준]
- Anti-goals: [피해야 할 제품 방향]

## 5. User experience / taste
- Tone: [차분한/재미있는/프리미엄/실용적 등]
- Visual references: [참고 사이트/앱]
- Avoid style: [피해야 할 느낌]
- Copy style: [짧게/친근하게/전문적으로 등]

## 6. Technical context
- Stack: [프레임워크/언어/호스팅]
- Important paths: [중요 파일/폴더]
- Local commands: [build/test/dev]
- Constraints: [비용, API, 배포, 성능, 보안]
- Do not touch: [민감 파일/금지 범위]

## 7. Current state
- What is already done:
  - [완료 1]
  - [완료 2]
- Known issues:
  - [이슈 1]
  - [이슈 2]
- Next likely task:
  - [다음 작업]

## 8. Decision rules
- If tradeoff appears, prefer: [속도/품질/비용/SEO/유지보수 등]
- Ask before: [결제, 배포, 삭제, 공개 발행, 민감정보 접근 등]
- Verify by: [테스트, 브라우저 QA, 사용자 피드백, 로그 등]

## 9. Output request
For this session, help with: [이번 세션에서 원하는 일]
Return:
- conclusion
- recommended next action
- risks / assumptions
- verification steps
```

## 좋은 브리프의 기준

- AI가 “무엇을 만들고 있는지”를 30초 안에 이해할 수 있다.
- 하지 않을 것과 제약이 명확하다.
- 현재 상태와 다음 작업이 분리되어 있다.
- 검증 방법이 들어 있다.
- 민감 정보가 없다.

## 한계

이 브리프는 프로젝트 기억을 돕는 문서입니다. 최신 수치, 배포 상태, API 동작, 경쟁사 가격, 법적 판단은 별도 검증해야 합니다.


---


# 코딩 에이전트 위임 브리프

AI Usage Playbook / Studio Nani

목적: Claude Code, Codex, ChatGPT 같은 코딩 에이전트에게 “알아서 고쳐줘”가 아니라, 범위·제약·검증 기준이 있는 작업 단위를 준다.

## 사용법

- 기능 추가, 버그 수정, UI 수정, 리팩터링을 맡길 때 먼저 이 브리프를 채운다.
- 작업 범위를 작게 유지한다.
- 허용 파일과 금지 파일을 명확히 적는다.
- 완료 기준에는 반드시 실제 검증 명령을 넣는다.

## Delegation Brief Template

```text
# Coding Agent Delegation Brief

## Task
[한 문장으로 작업을 정의]

## Goal
사용자/제품 관점에서 이 작업이 해결해야 하는 문제:
- [목표]

## Scope
Allowed files or folders:
- [수정 가능 경로 1]
- [수정 가능 경로 2]

Do not touch:
- [금지 경로/영역]
- [민감 파일/설정]

## Current problem
Observed behavior:
- [현재 문제]

Expected behavior:
- [원하는 동작]

Reproduction / entry point:
- [URL, 명령, 화면, 테스트, 로그]

## Constraints
- Keep changes minimal and focused.
- Do not introduce paid services, new cloud resources, secrets, or destructive commands.
- Do not rewrite unrelated architecture.
- Preserve existing public URLs and content unless explicitly required.
- If the task is ambiguous, state assumptions before editing.

## Acceptance criteria
- [수용 기준 1]
- [수용 기준 2]
- [수용 기준 3]

## Verification commands
Run:
```bash
[build/test/lint command]
```

If this is UI work, also verify:
- desktop browser render
- mobile width [예: 390px]
- console errors
- horizontal overflow

## Required final report
Return:
- files changed
- what changed
- exact verification commands and results
- screenshot or URL if UI changed
- remaining risks
```

## 예시: UI overflow 수정

```text
# Coding Agent Delegation Brief

## Task
Fix mobile horizontal overflow on the Korean home page.

## Goal
Users should be able to read the home page on 390px mobile width without sideways scrolling.

## Scope
Allowed files:
- src/pages/[lang]/index.astro
- src/components/PatternCard.astro

Do not touch:
- data content files
- deployment config
- analytics/ads files

## Current problem
Observed behavior:
- /ko/ has horizontal overflow on mobile.

Expected behavior:
- documentElement.scrollWidth equals clientWidth at 390px.

## Constraints
- Do not remove content.
- Preserve desktop layout.
- Prefer wrapping and width constraints over hiding important text.

## Acceptance criteria
- npm run build passes.
- /ko/ has no horizontal overflow at 390px.
- Browser console has no JS errors.

## Verification commands
Run:
```bash
npm run build
```

UI verify:
- open /ko/
- probe scrollWidth/clientWidth at 390px
- capture screenshot if available
```

## 위임 전 체크리스트

- [ ] 작업이 한 번에 끝낼 수 있는 작은 단위인가?
- [ ] 수정 가능 파일이 제한됐는가?
- [ ] 금지 범위가 적혀 있는가?
- [ ] 수용 기준이 사용자 관점으로 적혀 있는가?
- [ ] 실제 검증 명령이 있는가?
- [ ] 완료 보고 형식이 정해져 있는가?

## 한계

코딩 에이전트에게 비밀, 결제, 배포, 삭제, 공개 발행, 제품 전략 결정을 위임하지 마세요. 그런 작업은 사람의 명시 승인 후 진행해야 합니다.


---