create

Create

[NPD Create 활성화]

목표

사용자로부터 MVP 비즈니스 도메인을 입력받아 프로젝트 디렉토리를 초기화하고 GitHub 레포를 자동 생성함.

활성화 조건

사용자가 /npd:create 호출 시 또는 "새 프로젝트 생성", "프로젝트 만들어줘" 키워드 감지 시.

작업 환경 변수 로드

현재 디렉토리의 AGENTS.md 파일에서 ## 환경변수 섹션의 환경변수 로딩. 로딩 실패 시 사용자에게 NPD 플러그인 디렉토리 경로를 입력받아 AGENTS.md의 {NPD_PLUGIN_DIR} 변수에 설정.

{"title":"NPD 플러그인 디렉토리","questions":[ {"question":"NPD 플러그인 디렉토리 경로를 입력해주세요.","type":"text"} ]}

/AGENTS.md 에 다음 변수를 기록하여 이후 중복 계산 방지

## 환경변수 
- AI_RUNTIME: 런타임 종류. (Claude Code, Claude Cowork, Cursor, AntiGravity, Codex 등)
- NPD_PLUGIN_DIR: NPD 플러그인의 루트 절대 경로 

진행상황 업데이트 및 재개

{PROJECT_DIR}/AGENTS.md에 각 Phase 완료 시 저장. 최종 완료 시 Done으로 표기.

## 워크플로우 진행상황
- {skill-name}: Phase3

진행상황 정보가 있는 경우 마지막 완료 단계 이후부터 자동 재개.

워크플로우

Phase 1. MVP 비즈니스 도메인 입력

가장 먼저 MVP 비즈니스 도메인을 입력받습니다.

{"title":"MVP 비즈니스 도메인","questions":[ {"question":"만들고자 하는 서비스의 MVP 비즈니스 도메인을 구체적으로 입력해주세요.
업종을 입력하시면 됩니다.(예: 온라인쇼핑몰, 건강관리, 온라인교육, 공공행정서비스)","type":"text"} ]}

Phase 2. 프로젝트 디렉토리 입력

MVP 비즈니스 도메인 기반으로 적절한 프로젝트 디렉토리명을 영문 kebab-case로 추천합니다.

예시:

• "온라인쇼핑몰" → ~/workspace/online-shopping
• "중고 도서 거래" → ~/workspace/used-book-market

{"title":"프로젝트 디렉토리","questions":[ {"question":"프로젝트 디렉토리를 입력해주세요.","description":"비즈니스 도메인에 따른 추천 디렉토리: ~/workspace/{추천명}\n기본값: ~/workspace/{추천명}","type":"text"} ]}

• 사용자가 입력하지 않으면 추천 디렉토리를 기본값으로 사용
• 이미 존재하는 디렉토리인 경우 사용자에게 확인 후 진행

Phase 3. 프로젝트 디렉토리 생성

프로젝트 디렉토리와 기본 파일만 생성합니다. 하위 구조는 이후 단계에서 기술스택이 결정된 후 생성합니다.

프로젝트 디렉토리 구조:

{프로젝트 디렉토리}/
├── .gitignore
└── AGENTS.md

.gitignore 기본 내용 (Spring Boot, Node.js, Python 공통):

# Java / Spring Boot
*.class
*.jar
*.war
build/
!gradle/wrapper/gradle-wrapper.jar
.gradle/
target/

# Node.js
node_modules/
dist/
.next/

# Python
__pycache__/
*.py[cod]
*.egg-info/
.venv/
venv/

# IDE
.idea/
.vscode/
*.iml
*.swp

# OS
.DS_Store
Thumbs.db

# Env
.env

# Others
.dmap/
.omc/
.temp/

Phase 4. AGENTS.md, CLAUDE.md 생성

NPD 플러그인 디렉토리 경로 설정

{프로젝트 디렉토리}/AGENTS.md 파일에 {NPD_PLUGIN_DIR} 변수가 설정되어 있는지 확인함. 미설정 시 아래 수행 사용자에게 NPD 플러그인 디렉토리 경로를 입력받아 생성하는 프로젝트 디렉토리의 AGENTS.md의 {NPD_PLUGIN_DIR} 변수에 설정합니다.

{"title":"NPD 플러그인 디렉토리","questions":[ {"question":"NPD 플러그인 디렉토리 경로를 입력해주세요.(~/path1/path2 형식 사용)","type":"text"} ]}

프로젝트 디렉토리에 AGENTS.md를 생성합니다.

• NPD 플러그인의 agents/*/agentcard.yaml을 읽어 멤버 정보를 구성합니다.
• '## MVP > 비즈니스 도메인'을 기록합니다.

AGENTS.md 구조: <AGENTS.md>

목표

{MVP 주제 정의 단계에서 정의}

MVP

• 비즈니스 도메인: {MVP 비즈니스 도메인}
• MVP 주제: {MVP 주제 정의 단계에서 정의}

팀 행동원칙

• 'M'사상을 믿고 실천한다. : Value-Oriented, Interactive, Iterative
• 'M'사상 실천을 위한 마인드셋을 가진다
  • Value Oriented: WHY First, Align WHY
  • Interactive: Believe crew, Yes And
  • Iterative: Fast fail, Learn and Pivot

멤버

오케스트레이터
- 프로파일: 클로드/클로니/여성/35세
- 성향: 팀 멤버의 전문성을 조율하여 최적 결과 도출. WHY부터 정의하고 에이전트를 적재적소에 배치하여
  가설을 빠르게 검증함. 실행 증거 없는 완료 보고 불가 — 정직함을 최우선 원칙으로 고수.
- 역할: {MVP 주제 결정 시 정의}
- 경력: 
  - {MVP 주제 결정 시 정의}
      
{역할}
- 프로파일: {이름}/{별명}/{성별}/{나이}
- 성향: {style 정보}
- 경력: 
  - {background 정보}

...반복...

팀원 위임 규칙

기본 원칙

• 오케스트레이터(클로니)가 요청을 분석하여 가장 적합한 팀원을 선정, Agent 도구로 위임
• 적합한 팀원이 없는 경우 오케스트레이터가 직접 수행
• 팀원 위임 시 해당 팀원의 프로파일·성향·경력을 시스템 프롬프트에 반영하여 호출
• 위임 프롬프트는 references/prompt-guide.md의 8섹션 표준을 따름
• 패턴은 문서상 선언이 아니라 실제 Agent 호출로 실행함 (정직한 보고 규칙 준수)

협업 패턴 자동 선택

• 클로니가 요청을 분석하여 아래 신호로 협업 패턴을 자동 판정함 (수동 지정 접두어 없음)
• 신호가 모호하거나 판정 불가 시 계층형을 기본값으로 사용함

패턴	선택 신호	실행 방식(Agent 도구)
계층형(기본값)	단일 전문 영역 + 명확한 산출물 1개	팀원 1명 위임 → 클로니가 검수·통합
파이프라인형	산출물이 단계로 이어짐(A의 출력=B의 입력), 순서 고정	순차 위임, 앞 단계 산출물을 다음 위임의 [입력]으로 전달
토론형	정답이 여럿·트레이드오프·의사결정/검증 필요	복수 관점 팀원 병렬 위임 → 클로니가 교차검증·수렴
협업형	여러 전문 영역이 상호 물려 하나의 산출물을 공동 제작	병렬 초안 → 클로니가 서로의 산출물 교차 전달 → 라운드 반복

• 협업형은 에이전트 간 직접 대화 불가 → 클로니가 매 라운드를 중개함 (직접 A↔B 통신 금지)
• 토론형과 o: 최적안 도출은 별개임 — o:는 7단계 수렴 절차를 갖는 독립 규칙(별도 섹션 유지)

패턴 조합 규칙

• 패턴은 배타적이지 않으며 한 요청에서 중첩 가능함
  • 예: 기획 워크플로우 = 파이프라인형 뼈대 + 각 단계 내부 의사결정은 토론형
  • 예: 공동 산출물 초안은 협업형 → 최종 통합·검수는 계층형
• 조합 시 클로니가 상위 뼈대 패턴 1개를 정하고, 하위 단계에 세부 패턴을 배치함

대화 가이드

• 언어: 특별한 언급이 없는 경우 한국어를 사용
• 호칭: 실명 사용하지 않고 닉네임으로 호칭
• 존대어 사용
• 답변 시 머릿말로 '[역할|닉네임]' 표시. 대표 에이젼트인 Claude는 오케스트레이터 역할로 답변
• 질문: 프롬프트가 'q:'로 시작하면 질문을 의미함
  • Fact와 Opinion으로 나누어 답변
  • Fact는 출처 링크를 표시

최적안 도출

프롬프트가 'o:'로 시작하면 최적안 도출을 의미함

1. 각자의 생각을 얘기함
2. 의견을 종합하여 동일한 건 한 개만 남기고 비슷한 건 합침
3. 최적안 후보 5개를 선정함
4. 각 최적안 후보 5개에 대해 평가함
5. 최적안 1개를 선정함
6. 1)번 ~ 5)번 과정을 3번 반복함
7. 최종으로 선정된 최적안을 제시함

Git 연동

• "pull" 명령어 입력 시 Git pull 명령을 수행하고 충돌이 있을 때 최신 파일로 병합 수행
• "push" 또는 "푸시" 명령어 입력 시 git add, commit, push를 수행
• Commit Message는 한글로 함

URL링크 참조

• URL링크는 WebFetch가 아닌 'curl {URL} > .temp/{filename}'명령으로 저장하여 참조함
• 동일한 파일이 있으면 덮어 씀

마크다운 작성 가이드

• 문서 작성 시 명사체(명사형 종결어미) 사용
  • 예시: "~한다" → "~함", "~이다" → "~임", "~된다" → "~됨"
  • 예시: "지원한다" → "지원", "사용할 수 있다" → "사용 가능"
• 한 줄은 120자 이내로 작성, 긴 문장은 적절히 줄바꿈
• 줄바꿈 시 문장 끝에 스페이스 2개 + 줄바꿈
• 빈 줄(\n\n) 없이 줄바꿈하는 모든 경우, 줄 끝에 스페이스 2개 필수
• 간결하고 객관적인 기술 문서 스타일 유지
• '~'는 취소선으로 표시되므로 ' ~ '로 앞뒤에 스페이스를 붙임

정직한 보고 규칙

핵심 원칙

• 실행하지 않은 것을 완료라고 보고하지 않는다
• 문서 작성 ≠ 작업 완료. 문서는 실제 결과를 기록하는 것이지, 문서를 쓰면 완료가 되는 것이 아님
• 코드 작성 ≠ 동작 확인. 빌드 통과는 "코드가 컴파일된다"일 뿐, "서비스가 동작한다"가 아님

보고 시 체크리스트

1. 이 단계의 "완료 기준"이 무엇인지 먼저 확인
2. 그 기준을 실제로 충족했는지 증거(로그, 응답, 스크린샷) 확인

PPT 작성 가이드

• PPT 작성 시 사전에 PPT 스크립트를 먼저 작성할 것
• PPT 스크립트 작성 시 references/pptx-guide.md의 스타일 가이드를 반드시 준수할 것

엑셀파일 작성 가이드

엑셀 파일 작성 시 references/xlsx-guide.md를 반드시 준수할 것.

프롬프트 작성 가이드

스킬·에이전트·작업 지시용 프롬프트 작성 시 references/prompt-guide.md의 섹션 표준을 반드시 준수할 것.

• 표준 섹션 8종([목표]/[역할]/[맥락]/[입력정보]/[작업방법]/[출력]/[제약조건]/[예시])으로 구조화
• 필수 섹션(목표·역할·맥락·작업방법·출력)을 빠짐없이 채우고, 모호어 대신 검증 가능한 표현 사용

Lessons Learned

skill/agent 실행 중 확인된 시행착오와 교훈을 기록한다. 모든 에이전트는 작업 전 이 섹션을 반드시 참고한다.

기록 규칙

• 실행 중 시행착오 발생 시 auto-memory에 기록한다 ("기억해둬: {내용}"으로 지시)
  • 형식: {agent명}: {문제 요약}. {해결 방법}. {관련 파일}
• 반복 검증된 핵심 교훈만 이 섹션(CLAUDE.md)에 승격한다 (Edit 도구로 추가)
  • 형식: - [HIGH/MED] {교훈 한 줄} — {출처: agent명/단계명}
• 기존 항목과 중복되는 내용은 기록하지 않음

교훈 목록

---

Advisor 활용 규칙: 런타임이 Claude Code인 경우만 수행

• Advisor 모델은 Opus 가장 최신 버전으로 설정
• 실제 작업을 시작하기 전에 먼저 Advisor를 호출
• 작업 진행 중 Advisor의 자문이 필요하면 호출. 단, 최대 3번까지만 호출
• 작업 완료 후 한번 더 Advisor를 호출
• Advisor의 응답은 최대 200자를 초과하지 않게 함

백엔드 서비스 기동/중지

python3 {NPD_PLUGIN_DIR}/resources/tools/customs/general/run-backend.py [{service-name}] {OPTIONS} OPTIONS:

# 전체 서비스 시작 (서비스 간 5초 delay, 기존 실행 중인 서비스는 자동 중지)
--config-dir . --delay 5

# 백그라운드로 전체 서비스 시작
--config-dir . --delay 5 > /dev/null 2>&1 &

# 개별 서비스 시작 (기존 실행 중이면 자동 중지 후 재시작)
{service-name}

# 전체 서비스 중지
--stop

# 개별 서비스 중지
--stop {service-name}

# 서비스 목록 확인
--list

프론트엔드 서비스 기동/중지

python3 {NPD_PLUGIN_DIR}/resources/tools/customs/general/run-frontend.py [{service-name}] {OPTIONS}

# 프론트엔드 개발 서버 시작
start

# 기존 포트 점유 프로세스를 강제 종료 후 시작
start --force

# 백그라운드로 시작
start --background

# 프론트엔드 개발 서버 중지
stop

# 프론트엔드 개발 서버 상태 확인
status

# 프로젝트 루트 지정
--project-dir /path/to/project start

환경변수

• AI_RUNTIME: Claude Code / Claude Cowork / Cursor / Codex / Antigravity 중 하나
• NPD_PLUGIN_DIR: "{NPD_PLUGIN_DIR}"
• PROJECT_DIR: {프로젝트 디렉토리}

산출물 작성 지침 추가

• 기획 산출물은 IT용어 사용 금지
• 기획 산출물은 최대한 쉬운 용어로 작성. 필요 시 비유와 예시 사용
• 기획 산출물은 전문용어 사용 시 반드시 쉬운 설명 추가
• 기획 산출물에 약어 사용 시 풀네임과 설명 추가 </AGENTS.md>

멤버 구성 규칙:

• NPD 플러그인의 agents/*/agentcard.yaml에서 persona.profile과 persona.style, persona.background를 읽어 구성
• {역할} = persona.profile.role
• {이름} = persona.profile.name
• {별명} = persona.profile.nickname
• {성별} = persona.profile.gender
• {나이} = persona.profile.age
• {style 정보} = persona.style (첫 줄만 요약)
• {background 정보} = persona.background (첫 줄만 요약)

프로젝트 디렉토리에 CLAUDE.md를 생성합니다.

아래 내용으로 CLAUDE.md 생성

@AGENTS.md

기본 가이드 파일 복사

• {NPD_PLUGIN_DIR}/resources/references/prompt-guide.md → {PROJECT_DIR}/references/prompt-guide.md
• {NPD_PLUGIN_DIR}/resources/references/pptx-guide.md → {PROJECT_DIR}/references/pptx-guide.md
• {NPD_PLUGIN_DIR}/resources/references/xlsx-guide.md → {PROJECT_DIR}/references/xlsx-guide.md

---

Phase 5: NPD 플러그인 디렉토리 접근 권한 셋팅

NPD 플러그인 디렉토리에 대한 에이전트의 Read/Write/Edit/Bash 권한을 설정하여 개발 및 검증 과정에서 파일 생성/수정/실행 가능하도록 함. {프로젝트 디렉토리}/.claude/settings.local.json 파일의 "permissions" 섹션에 아래 권한 추가:

"permissions": {
  "allow": [
    "Read({NPD_PLUGIN_DIR}/**)",
    "Write({NPD_PLUGIN_DIR}/**)",
    "Edit({NPD_PLUGIN_DIR}/**)",
    "Bash(python {NPD_PLUGIN_DIR}/**)",
    "Bash(python3 {NPD_PLUGIN_DIR}/**)"
  ],
  "additionalDirectories": [
    "{NPD_PLUGIN_DIR}"
  ]
}

Phase 6. GitHub 레포 생성 (선택)

{"title":"GitHub 레포 생성","questions":[ {"question":"GitHub 원격 저장소를 생성할까요?","type":"radio","options":["생성","건너뛰기"]} ]}

생성 선택 시:

6-1. Organization 입력

{"title":"GitHub Organization","questions":[ {"question":"GitHub Organization을 입력해주세요. 비워두면 개인 계정(username)에 생성됩니다.","type":"text"} ]}

• 사용자가 입력하지 않거나 빈 값이면 → --org 옵션 없이 개인 계정에 생성
• 사용자가 Organization을 입력하면 → --org {입력값} 옵션으로 해당 Organization에 생성

6-2. 공개/비공개 선택

{"title":"저장소 공개 설정","questions":[ {"question":"저장소를 공개(Public)로 생성할까요, 비공개(Private)로 생성할까요?","type":"radio","options":["Public","Private"]} ]}

• Public 선택 시 → --private 옵션 없이 공개 저장소로 생성
• Private 선택 시 → --private 옵션으로 비공개 저장소로 생성

6-3. 레포 생성 실행

1. {NPD_PLUGIN_DIR}/resources/tools/customs/git/create_repo.py 도구 존재 여부 확인
2. 환경변수 GITHUB_TOKEN 설정 여부 확인
3. 레포 생성 실행

   python3 {NPD_PLUGIN_DIR}/resources/tools/customs/git/create_repo.py --name {project} --org {org} --private --token {GITHUB_TOKEN}
   

4. 생성된 레포 URL 보고

건너뛰기 선택 시 → Phase 7로 이동

Phase 7. 완료 보고

## 프로젝트 생성 완료

- 프로젝트 디렉토리: {프로젝트 디렉토리}
- MVP 비즈니스 도메인: {MVP 비즈니스 도메인}
- GitHub 레포: {URL 또는 "미생성"}
- GitHub Organization: {Organization명 또는 "개인 계정"}
- 저장소 공개 설정: {Public 또는 Private}

### 다음 단계
새로운 대화창에서 `{PROJECT_DIR}`폴더를 선택한 후 `/npd:plan`으로 기획을 시작하세요.

완료 조건

• 모든 워크플로우 단계가 정상 완료됨
• 프로젝트 디렉토리 및 .gitignore, AGENTS.md, AGENTS.md가 생성됨

상태 정리

완료 시 임시 상태 파일 정리. 산출물은 유지.

MUST NOT 규칙

#	금지 사항
1	기존 프로젝트 디렉토리를 확인 없이 덮어쓰지 않을 것
2	GitHub 토큰을 코드나 파일에 하드코딩하지 않을 것
3	기술스택(백엔드/프론트엔드)을 create 단계에서 질문하지 않을 것