Project Start

→ 하나라도 없으면 설치 안내 메시지를 출력하고 중단합니다. → 모두 있으면 다음 단계로 진행합니다.

Phase 2: /init 실행

/init 스킬의 1단계~12단계를 순서대로 실행합니다:

1. Git 초기화
2. .gitignore 생성
3. 디렉토리 구조 생성
4. Backend 파일 생성 (main.py, database.py, models, routers, services, deps.py)
5. 프로젝트 문서 생성 (docs/ 4개 마크다운)
6. Frontend Vite 프로젝트 생성 (npm create vite)
7. Frontend 페이지/컴포넌트 생성 (HomePage, LoginPage, DashboardPage, DocViewerPage 등)
8. Orbitron.yaml 생성
9. CLAUDE.md 생성
10. SuperAdmin seed 스크립트 생성
11. .agents 워크플로우 문서 업데이트
12. 초기 커밋
13. GitHub public 리포지토리 생성 + 푸시

/init 스킬의 모든 단계를 그대로 따릅니다.

Phase 3: MCP 서버 설정

프로젝트 .claude/settings.local.json에 MCP 서버 10개를 설정합니다. 기존 설정(permissions 등)은 유지하면서 mcpServers 키를 추가/병합합니다.

설정할 MCP 서버 10개

아래 내용을 .claude/settings.local.json의 mcpServers 키에 추가합니다:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<gh auth token 자동 삽입>"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "<backend/.env의 DATABASE_URL 값 복사>"
      }
    },
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "<사용자에게 확인>"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "<프로젝트 루트 경로>"]
    },
    "fetch": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch"]
    },
    "docker": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-docker"]
    }
  }
}

MCP 설정 자동화 규칙

1. github: gh auth token 명령으로 토큰을 자동 추출하여 삽입
2. postgres: backend/.env 또는 .env.example의 DATABASE_URL 값을 복사
3. filesystem: 현재 프로젝트 루트 절대 경로를 자동 삽입
4. brave-search: API 키가 필요 → 사용자에게 키 입력 요청, 없으면 이 서버만 건너뛰기
5. 나머지: 추가 설정 없이 바로 사용 가능

MCP 서버 설명

Phase 4: Python 가상환경 + 의존성 설치

cd c:\WORK\TwinverseAI/backend && python -m venv .venv && .venv/Scripts/pip install -r requirements.txt

→ Windows 환경이므로 .venv/Scripts/pip 사용 → 설치 완료 후 간단한 import 테스트:

cd c:\WORK\TwinverseAI/backend && .venv/Scripts/python -c "from fastapi import FastAPI; print('Backend dependencies OK')"

Phase 5: Frontend 의존성 설치

/init Phase 6에서 npm install이 이미 실행되었으므로, 누락된 경우에만 재실행:

cd c:\WORK\TwinverseAI/frontend && npm install

Phase 6: /end 실행

/end 스킬을 실행합니다:

1. 세션 작업 내역 수집 (git status + git log)
2. docs/ 문서 자동 업데이트 (work-log.md에 초기 세팅 기록)
3. Git 커밋 & 푸시
4. 세션 종료 보고 생성

/end 스킬의 모든 단계를 그대로 따릅니다.

Phase 7: 최종 보고

모든 단계가 완료되면 사용자에게 아래 형식으로 최종 보고합니다:

## 프로젝트 부트스트랩 완료

### 생성된 프로젝트
- 이름: (프로젝트명)
- GitHub: (리포지토리 URL)
- 스택: FastAPI + React + Vite + PostgreSQL

### 환경 상태
| 항목 | 상태 |
|------|------|
| Git 초기화 | 완료 |
| GitHub 리포지토리 | public, 푸시 완료 |
| Backend (Python .venv) | 설치 완료 |
| Frontend (node_modules) | 설치 완료 |
| MCP 서버 (10개) | 설정 완료 |
| 프로젝트 문서 (4개) | 생성 완료 |
| Orbitron 배포 설정 | 생성 완료 |

### MCP 서버 현황
| 서버 | 상태 |
|------|------|
| context7 | 설정 완료 |
| github | 설정 완료 |
| postgres | 설정 완료 (DB 연결은 .env 작성 후) |
| puppeteer | 설정 완료 |
| sequential-thinking | 설정 완료 |
| memory | 설정 완료 |
| brave-search | (설정 완료 / API 키 미입력 - 건너뜀) |
| filesystem | 설정 완료 |
| fetch | 설정 완료 |
| docker | 설정 완료 |

### 다음 필수 작업
1. `backend/.env` 파일 작성 (DATABASE_URL, SECRET_KEY)
2. `cd backend && .venv/Scripts/python seed_admin.py` (SuperAdmin 생성)
3. 로컬 테스트 실행:
   - Backend: `cd backend && .venv/Scripts/uvicorn main:app --reload`
   - Frontend: `cd frontend && npm run dev`
4. 브라우저에서 http://localhost:5173 접속 확인
5. `docs/dev-plan.md` 개발계획서 작성
6. Orbitron에 환경변수 등록 후 배포

에러 처리

각 Phase에서 에러가 발생하면:

1. Phase 1 실패 (도구 미설치): 설치 안내 출력 후 중단
2. Phase 2 실패 (init): 에러 내용 출력, 수동 복구 안내 후 중단
3. Phase 3 실패 (MCP): 실패한 서버만 건너뛰고 계속 진행
4. Phase 4 실패 (pip): 에러 출력, requirements.txt 확인 안내 후 계속 진행
5. Phase 5 실패 (npm): 에러 출력, package.json 확인 안내 후 계속 진행
6. Phase 6 실패 (end): 에러 출력, 수동 커밋 안내 후 계속 진행

→ Phase 12는 치명적이므로 중단, Phase 36은 비치명적이므로 경고 후 계속 진행합니다.