Menü
profile.json을 읽어 CLAUDE.md를 자동 생성한다. 프로젝트 스택에 맞는 모듈을 조합하여 Claude Code 환경을 세팅한다. 세션 시작 시 "code-forge updated" 또는 "version mismatch" 메시지가 보이면 사용자에게 재실행 여부를 물어본 후 이 스킬을 실행한다.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
세션 핸드오프. 컨텍스트가 차기 전에 중요 맥락을 progress.md에 문서화하고 새 세션 킥오프 프롬프트를 클립보드에 복사한다. "핸드오프", "세션 정리하고 넘기자", "컨텍스트 정리", "이어갈 준비" 등의 요청에 사용.
MD 파일 또는 텍스트로 작업을 정의하면, 분석 → 디자인 확인 → 구현 → 검증 → 커밋 → PR까지 전체 플로우를 수행한다. "이거 만들어줘", "기능 구현해줘", "작업 시작하자", "이 티켓 진행해줘" 등 코드 작업 착수 발화에 사용.
Claude + OpenAI Codex 협업 스킬. MCP 서버 설정 시에만 사용 가능.
code-forge 상태 대시보드. REFLECT flag, quality 이벤트, notepad/decisions, usage 집계를 한 번에. forge-glow 같은 외부 도구는 --json으로 파싱.
교차 모델 토론. Agent Teams / Codex CLI / self-debate 모드 선택. 설계 결정, 아키텍처 선택 시 활용. "어느 쪽이 나을까", "설계 비교해줘", "토론시켜줘", "교차 검증해줘" 등의 요청에 사용.
화면 단위 E2E 테스트 자동화. Figma/코드 기반 테스트 케이스 도출 → Playwright 코드 생성 → Forge Loop(에스컬레이션 기반 자율 실행). "E2E 돌려줘", "화면 테스트 만들어줘", "이 페이지 자동 테스트" 등의 요청에 사용.
| name | setup |
| description | profile.json을 읽어 CLAUDE.md를 자동 생성한다. 프로젝트 스택에 맞는 모듈을 조합하여 Claude Code 환경을 세팅한다. 세션 시작 시 "code-forge updated" 또는 "version mismatch" 메시지가 보이면 사용자에게 재실행 여부를 물어본 후 이 스킬을 실행한다. |
| category | setup |
프로젝트의 .claude/profile.json을 읽어 스택에 맞는 CLAUDE.md를 자동 생성한다.
profile.json 존재 → Step 2로 바로 진행 (기존 파싱)
profile.json 없음 → Step 1 대화형 온보딩
$ARGUMENTS 없음 → .claude/profile.json 자동 탐색
$ARGUMENTS 있음 → 파일 경로로 인식 (예: /setup .claude/profile.json)
$ARGUMENTS --profile → 코딩 프로필 생성만 실행 (아래 "코딩 프로필" 섹션 참조)
/setup --profile)/setup --profile 또는 "코딩 스타일 분석해줘" 요청 시 실행. /setup 기본 흐름에서는 묻지 않는다.
흐름:
.candidate/profile.md에 저장 (레거시 .claude/coding-profile.md 는 폴백으로만)스택별 분석 카테고리 (동적 선택):
| 카테고리 | 적용 스택 | 분석 내용 |
|---|---|---|
| 추상화 습관 | 모든 스택 | 중복 코드 추출 기준, 함수/모듈 분리 기준 |
| 모듈/컴포넌트 설계 | React/Vue → 컴포넌트, Python/Go → 모듈/클래스 | 분리 기준, 계층 구조 |
| 상태/데이터 관리 | React → hooks/Query, 백엔드 → ORM/캐시 | 데이터 흐름 |
| 타입/스키마 | TS → interface/type, Python → type hints, Go → struct | 엄격도 |
| 에러 처리 | 모든 스택 | try-catch 전략, 에러 계층 |
| 네이밍/스타일 | 모든 스택 | 네이밍, early return, 비동기 |
| 폴더 구조 | 모든 스택 | 기능별/레이어별 |
| 커밋 스타일 | 모든 스택 | git log 분석 |
| 테스트 전략 | 모든 스택 | 단위/통합/E2E 비율 |
| 프레임워크 특화 | 감지된 것만 | Next.js→SSR, Django→view, Go→interface 등 |
감지 못한 스택이면: 범용 카테고리(추상화, 에러, 네이밍, 폴더, 커밋)만 분석 + Claude가 코드를 읽고 해당 언어에 맞는 질문 동적 생성
참조 템플릿: ${CLAUDE_PLUGIN_ROOT}/.candidate/code-analysis-prompt.md (React/TS 예시)
생성 경로: .candidate/profile.md (local, 우선) 또는 ~/.claude/coding-profile.md (global, 레거시 폴백)
모든 선택은 AskUserQuestion 도구를 사용하여 인터랙티브 선택 UI로 제시한다. 텍스트로 > 커서를 출력하거나 숫자/Y/n 입력을 받지 않는다.
AskUserQuestion 도구를 호출하여 클릭 가능한 선택지를 보여준다(Recommended) 를 붙여 첫 번째에 배치한다options에 없는 선택은 사용자가 "Other"를 통해 자유 입력할 수 있다 (자동 제공됨)AskUserQuestion({
questions: [{
question: "이 설정을 어디에 적용할까요?",
header: "설치 위치",
options: [
{ label: "이 프로젝트에만 (.claude/)", description: "현재 프로젝트에만 적용" },
{ label: "전역 설정 (~/.claude/)", description: "모든 프로젝트에 적용" }
],
multiSelect: false
}]
})
핵심: 한 번에 하나만 묻고, 응답을 받은 후 다음으로 넘어간다. 반드시 AskUserQuestion 도구를 사용한다.
.claude/profile.json이 없으면 아래 서브스텝을 순차 진행한다.
한 번에 하나씩 질문하고, 사용자 응답을 받은 후 다음으로 넘어간다.
참고: 아래의
> 옵션형식 예시들은 AskUserQuestion 도구에 전달할 옵션 내용의 참고 자료이다. 실제 구현 시 반드시 AskUserQuestion 도구를 호출하여 인터랙티브 선택 UI로 표시한다. 텍스트로>커서를 출력하지 않는다.
code-forge 설정을 시작합니다.
이 설정을 어디에 적용할까요?
> 이 프로젝트에만 (.claude/)
전역 설정 (~/.claude/)
| 선택 | installTarget | profile.json 경로 | CLAUDE.md 경로 |
|---|---|---|---|
| 이 프로젝트에만 | local | .claude/profile.json | ./CLAUDE.md |
| 전역 설정 | global | ~/.claude/profile.json | ~/.claude/CLAUDE.md |
package.json이 존재하면 dependencies를 분석하여 스택을 자동 추론한다.
프로젝트 유형 판별:
먼저 프로젝트가 프론트엔드 서비스인지 판별한다.
| 조건 | 유형 | 스택 설정 |
|---|---|---|
react, next, vue, angular 등 UI 프레임워크 존재 | 서비스 | 스택 설정 진행 |
bin 필드 존재 + UI 프레임워크 없음 | CLI/도구 | 스택 설정 건너뛰기 |
main/exports 필드 + UI 프레임워크 없음 | 라이브러리 | 스택 설정 건너뛰기 |
package.json 없음 | 기타 | 스택 설정 건너뛰기 |
| UI 프레임워크 없지만 판단 불확실 | 확인 필요 | 사용자에게 질문 |
서비스가 아닌 경우:
이 프로젝트는 프론트엔드 서비스가 아닌 것 같습니다.
(감지: CLI 도구 / 라이브러리 / 스택 미감지)
스택 모듈 설정이 필요한가요?
> 건너뛰기 (명령어 + 기능 설정만)
아니요, 스택 설정도 할게요
→ "건너뛰기" 선택 시: 1-2, 1-3을 건너뛰고 1-4(프로젝트 정보)로 직행 → "스택 설정도 할게요" 선택 시: 정상 진행
감지 규칙 (서비스인 경우):
| dependency / 파일 | 추론 모듈 |
|---|---|
next | framework: react-nextjs-pages 또는 react-nextjs-app |
react (next 없음) | framework: react-spa |
jotai + @tanstack/react-query | state: jotai-tanstack |
zustand + @tanstack/react-query | state: zustand-tanstack |
@reduxjs/toolkit | state: redux-rtk |
@emotion/styled 또는 @emotion/react | styling: emotion |
tailwindcss | styling: tailwind |
styled-components | styling: styled-components |
@mui/material | design-system: mui |
antd | design-system: ant-design |
jest | testing: jest |
vitest | testing: vitest |
fastapi in requirements.txt/pyproject.toml | framework: python-fastapi |
django in requirements.txt/pyproject.toml | framework: python-django |
express in package.json | framework: node-express |
go.mod 존재 | framework: go-standard |
추가 감지:
| 조건 | 추론 |
|---|---|
app/layout.tsx 존재 | App Router |
pages/_app.tsx 존재 | Pages Router |
tailwind.config.* 존재 | styling: tailwind |
jest.config.* 존재 | testing: jest |
vitest.config.* 존재 | testing: vitest |
미매칭 라이브러리 감지:
감지 규칙에 매칭되지 않는 관련 라이브러리가 있으면 해당 카테고리의 "기타" 옵션으로 자동 추가한다.
예시:
recoil 감지 → State 카테고리에 recoil (감지됨) 옵션 동적 추가sass 감지 → Styling 카테고리에 sass (감지됨) 옵션 동적 추가@testing-library/react 있지만 jest/vitest 없음 → Testing에 해당 정보 표시카테고리별 감지 확장 규칙:
| 카테고리 | 추가 감지 대상 |
|---|---|
| Framework | vue, angular, svelte, solid-js, remix, gatsby |
| State | recoil, mobx, valtio, xstate, swr (TanStack Query 대체) |
| Styling | sass/scss, less, vanilla-extract, panda-css, linaria |
| Design System | chakra-ui, radix-ui, shadcn, mantine |
| Testing | playwright, cypress, storybook |
감지되면 해당 카테고리 옵션 목록에 {라이브러리명} (감지됨) 형태로 자동 삽입한다.
프로젝트 정보 자동 추출:
package.json의 scripts에서 dev, build, lint, test 명령어를 추출한다.
패키지 매니저는 lock 파일로 판단: yarn.lock → yarn, pnpm-lock.yaml → pnpm, 그 외 → npm.
package.json을 분석합니다...
감지된 스택:
Framework: next (14.2.x) → react-nextjs-app
State: jotai (2.x) + @tanstack/react-query (5.x) → jotai-tanstack
Styling: @emotion/styled (11.x) → emotion
Testing: vitest (1.x) → vitest
Design System: 감지 안 됨
감지된 명령어:
dev: yarn dev
build: yarn build
lint: yarn lint
test: yarn test
package.json이 없으면 이 단계를 건너뛰고 1-3으로 직행한다.
감지 결과를 기존 프리셋과 비교한다.
매칭 알고리즘:
프리셋 매칭 시:
감지 결과가 "standard" 프리셋과 일치합니다.
standard: Pages Router + Jotai + Emotion + Jest
> standard 프리셋으로 진행
직접 선택할게요
→ "standard 프리셋으로 진행" 선택 시: 1-4로 건너뜀 (프로젝트 정보 확인) → "직접 선택할게요" 선택 시: 1-3으로 진행
프리셋 매칭 안 될 때:
사용 가능한 프리셋:
> standard — Pages Router + Jotai + Emotion + Jest
modern-stack — MUI + App Router + Zustand + Tailwind + Vitest
backend-api — Node.js Express + TypeScript + Jest
직접 선택 (감지 결과 기반)
직접 선택 시 한 번에 한 카테고리씩 질문한다.
자동 감지 결과가 있으면 해당 항목에 > 커서를 놓는다 (기본 선택).
각 카테고리마다 "기타" 옵션이 있다. 감지되었지만 옵션에 없는 라이브러리는 자동으로 옵션에 추가된다.
[1/5] Framework
> react-nextjs-app — Next.js App Router ← 감지됨
react-nextjs-pages — Next.js Pages Router
react-spa — React SPA (Vite/CRA)
기타 (직접 입력)
[2/5] Design System
> 없음
mui — Material UI
ant-design — Ant Design
기타 (직접 입력)
[3/5] State Management
> jotai-tanstack — Jotai + TanStack Query ← 감지됨
zustand-tanstack — Zustand + TanStack Query
redux-rtk — Redux Toolkit + RTK Query
기타 (직접 입력)
감지되었지만 옵션에 없는 경우 (예: recoil 감지):
[3/5] State Management
> recoil — Recoil ← 감지됨
jotai-tanstack — Jotai + TanStack Query
zustand-tanstack — Zustand + TanStack Query
redux-rtk — Redux Toolkit + RTK Query
기타 (직접 입력)
[4/5] Styling
> emotion — Emotion (@emotion/styled) ← 감지됨
tailwind — Tailwind CSS
styled-components — Styled Components
기타 (직접 입력)
[5/5] Testing
> vitest — Vitest ← 감지됨
jest — Jest
기타 (직접 입력)
"기타" 선택 시 동작:
[3/5] State Management
사용 중인 상태 관리 라이브러리를 입력해 주세요:
> recoil
입력값은 modules.state에 문자열로 저장된다. 대응하는 모듈 SKILL.md가 없으면 규칙 참조에서 제외되지만, profile.json에는 기록되어 CLAUDE.md 스택 섹션에 표시된다.
자동 감지된 명령어를 보여주고 확인받는다.
[프로젝트 정보]
프로젝트명: my-app (package.json name)
dev: yarn dev
build: yarn build
lint: yarn lint
test: yarn test
> 이대로 진행
수정할게요
→ "수정할게요" 선택 시: 각 항목을 하나씩 다시 질문
package.json이 없었으면 각 항목을 직접 물어본다:
[프로젝트 정보]
프로젝트 이름을 입력해 주세요:
>
개발 서버 명령어 (예: yarn dev):
>
빌드 명령어 (예: yarn build):
>
린트 명령어 (예: yarn lint):
>
테스트 명령어 (예: yarn test):
>
설정 요약
설치 위치: 이 프로젝트 (.claude/)
프리셋: 없음 (커스텀)
Framework: react-nextjs-app → Next.js App Router
Design System: 없음
State: jotai-tanstack → Jotai + TanStack Query v5
Styling: emotion → Emotion (@emotion/styled)
Testing: vitest → Vitest
프로젝트명: my-app
dev: yarn dev
build: yarn build
lint: yarn lint
test: yarn test
> 생성
처음부터 다시
→ "생성": profile.json 생성 후 Step 2로 진행 → "처음부터 다시": 1-0부터 재시작
// .claude/profile.json 예시
{
"installTarget": "local", // "local" | "global" (기본: "local")
"projectType": "service", // "service" | "library" | "cli" | "other"
"preset": "standard", // 프리셋 사용 (선택)
"modules": { // 개별 모듈 직접 선택 (선택)
"framework": "react-nextjs-pages",
"state": "jotai-tanstack",
"styling": "emotion",
"testing": "jest"
},
"project": { // 프로젝트 기본 정보 (선택)
"name": "my-project",
"dev": "yarn dev",
"build": "yarn build",
"lint": "yarn lint",
"test": "yarn test"
},
"overrides": {} // 앱별 오버라이드 (선택)
}
preset 필드가 있으면 ${CLAUDE_PLUGIN_ROOT}/presets/{preset}.json 로드modules를 기본값으로 설정modules 명시값으로 덮어씀overrides 병합modules의 값이 알려진 모듈 목록에 없으면 (예: "state": "recoil"):
State: recoil)| 모듈 키 | 값 | SKILL.md 경로 |
|---|---|---|
framework | react-nextjs-pages | ${CLAUDE_PLUGIN_ROOT}/modules/frameworks/react-nextjs-pages/SKILL.md |
framework | react-nextjs-app | ${CLAUDE_PLUGIN_ROOT}/modules/frameworks/react-nextjs-app/SKILL.md |
framework | react-spa | ${CLAUDE_PLUGIN_ROOT}/modules/frameworks/react-spa/SKILL.md |
framework | python-fastapi | ${CLAUDE_PLUGIN_ROOT}/modules/frameworks/python-fastapi/SKILL.md |
framework | python-django | ${CLAUDE_PLUGIN_ROOT}/modules/frameworks/python-django/SKILL.md |
framework | node-express | ${CLAUDE_PLUGIN_ROOT}/modules/frameworks/node-express/SKILL.md |
framework | go-standard | ${CLAUDE_PLUGIN_ROOT}/modules/frameworks/go-standard/SKILL.md |
design-system | mui | ${CLAUDE_PLUGIN_ROOT}/modules/design-systems/mui/SKILL.md |
design-system | ant-design | ${CLAUDE_PLUGIN_ROOT}/modules/design-systems/ant-design/SKILL.md |
state | jotai-tanstack | ${CLAUDE_PLUGIN_ROOT}/modules/state/jotai-tanstack/SKILL.md |
state | zustand-tanstack | ${CLAUDE_PLUGIN_ROOT}/modules/state/zustand-tanstack/SKILL.md |
state | redux-rtk | ${CLAUDE_PLUGIN_ROOT}/modules/state/redux-rtk/SKILL.md |
styling | emotion | ${CLAUDE_PLUGIN_ROOT}/modules/styling/emotion/SKILL.md |
styling | tailwind | ${CLAUDE_PLUGIN_ROOT}/modules/styling/tailwind/SKILL.md |
styling | styled-components | ${CLAUDE_PLUGIN_ROOT}/modules/styling/styled-components/SKILL.md |
testing | jest | ${CLAUDE_PLUGIN_ROOT}/modules/testing/jest/SKILL.md |
testing | vitest | ${CLAUDE_PLUGIN_ROOT}/modules/testing/vitest/SKILL.md |
아래 템플릿으로 50줄 이내의 CLAUDE.md를 생성한다.
installTarget에 따라 생성 경로가 달라진다.
모듈 컨벤션 상세는 CLAUDE.md에 포함하지 않는다.
에이전트는 @${CLAUDE_PLUGIN_ROOT}/modules/... 참조로 직접 읽는다.
| installTarget | CLAUDE.md 경로 |
|---|---|
local | ./CLAUDE.md |
global | ~/.claude/CLAUDE.md |
# {project.name} CLAUDE.md
> 자동 생성: /setup 스킬 | 수정 시 profile.json을 변경 후 /setup 재실행
## 스택
- Framework: {framework 설명}
- Design System: {design-system 설명}
- State: {state 설명}
- Styling: {styling 설명}
- Testing: {testing 설명}
## 명령어
```bash
# 개발
{project.dev}
# 빌드
{project.build}
# 린트
{project.lint}
# 테스트
{project.test}
@{CLAUDE_PLUGIN_ROOT}/modules/frameworks/{framework}/SKILL.md @{CLAUDE_PLUGIN_ROOT}/modules/design-systems/{design-system}/SKILL.md @{CLAUDE_PLUGIN_ROOT}/modules/state/{state}/SKILL.md @{CLAUDE_PLUGIN_ROOT}/modules/styling/{styling}/SKILL.md @{CLAUDE_PLUGIN_ROOT}/modules/testing/{testing}/SKILL.md
**projectType이 "service"가 아닌 경우:**
- 스택 섹션과 규칙 참조 섹션을 생략
- 명령어 섹션만 포함
### 스택 설명 매핑
| 모듈값 | 설명 |
| ------------------- | ----------------------------- |
| react-nextjs-pages | Next.js 14 Pages Router |
| react-nextjs-app | Next.js App Router |
| react-spa | React SPA (Vite/CRA) |
| mui | Material UI |
| ant-design | Ant Design |
| jotai-tanstack | Jotai + TanStack Query v5 |
| zustand-tanstack | Zustand + TanStack Query v5 |
| redux-rtk | Redux Toolkit + RTK Query |
| emotion | Emotion (@emotion/styled) |
| tailwind | Tailwind CSS |
| styled-components | Styled Components |
| jest | Jest |
| vitest | Vitest |
매핑에 없는 값 (커스텀 입력)은 입력값 그대로 표시한다.
---
## Step 3-2: AGENTS.md 생성 (Codex/멀티툴 호환)
CLAUDE.md와 동일한 경로에 `AGENTS.md`를 생성한다.
Codex CLI, GitHub Copilot 등 AGENTS.md를 읽는 도구에 사고모델 핵심을 전파한다.
| installTarget | 경로 |
|--------------|------|
| `local` | `./AGENTS.md` |
| `global` | `~/.claude/AGENTS.md` |
기존 AGENTS.md가 있으면 **건드리지 않는다** (사용자 커스텀 존중).
### AGENTS.md 템플릿
```markdown
# {project.name} AGENTS.md
> 자동 생성: code-forge /setup | CLAUDE.md와 함께 사용
## Working Protocol
모든 코드 작업에 아래 규칙을 따른다:
1. **읽기 우선** — 수정 전 반드시 파일을 읽는다. 기억에서 추론하지 않는다
2. **패턴 준수** — 기존 코드의 구조, 네이밍, 스타일을 따른다
3. **정책 보존** — 비즈니스 로직을 임의 변경하지 않는다
4. **최소 변경** — 요청받은 것만 수정한다
5. **스코프 준수** — 대상 외 파일은 명시 요청 없이 수정하지 않는다
작업 루프: GROUND(맥락 파악) → APPLY(구현) → VERIFY(검증) → ADAPT(실패 시 조정)
## Project Conventions
Read CLAUDE.md for stack-specific rules, commands, and module references.
projectType이 "service"가 아닌 경우에도 동일하게 생성한다 (사고모델은 스택 무관).
/setup 완료
프로젝트: {project.name}
설치 위치: {installTarget}
스택:
Framework: react-nextjs-app → Next.js App Router
State: jotai-tanstack → Jotai + TanStack Query v5
Styling: emotion → Emotion (@emotion/styled)
Testing: vitest → Vitest
생성된 파일:
CLAUDE.md (47줄)
AGENTS.md (사고모델 핵심 — Codex/멀티툴 호환)
.claude/profile.json
참조 모듈 (4개):
@{CLAUDE_PLUGIN_ROOT}/modules/frameworks/react-nextjs-app/SKILL.md
@{CLAUDE_PLUGIN_ROOT}/modules/state/jotai-tanstack/SKILL.md
@{CLAUDE_PLUGIN_ROOT}/modules/styling/emotion/SKILL.md
@{CLAUDE_PLUGIN_ROOT}/modules/testing/vitest/SKILL.md
다음 단계:
- CLAUDE.md 내용을 확인하세요
- 빌드/린트 명령어가 올바른지 확인하세요
- profile.json의 overrides로 앱별 설정을 추가할 수 있습니다
CLAUDE.md 생성 완료 후, 프로젝트 로컬 설정 파일을 생성한다.
이미 존재하면 version 필드만 업데이트한다.
plugin.json에서 현재 버전을 읽어온다: ${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json → version 필드.
| installTarget | 경로 |
|---|---|
local | .claude/code-forge.local.md |
global | ~/.claude/code-forge.local.md |
---
version: {plugin.json의 version}
plugins:
smith:
enabled: false
---
version: 이 프로젝트에 적용된 code-forge 버전. 플러그인 업데이트 후 /setup 재실행 시 버전 차이를 감지하여 CLAUDE.md를 재생성한다.plugins.smith: /code-forge:smith-setup에서 확장한다. 초기값은 enabled: false.스택 설정 완료 후, 프로젝트 전용 에이전트 생성 여부만 묻는다.
Whetstone/Bellows는 묻지 않고 기본값으로 세팅 — 나중에 code-forge.local.md에서 직접 편집 가능.
Smith (프로젝트 전용 에이전트)
프로젝트를 분석하여 레포 맞춤 에이전트를 자동 생성합니다.
> 사용 (권장)
사용 안 함
응답에 따라 code-forge.local.md에 저장:
plugins:
smith:
enabled: true # 사용자 선택 반영
whetstone:
enabled: false # 기본 off (별도 레포, 원하면 직접 true로)
bellows:
enabled: true # 기본 on (로컬 사용량 로깅, $HOME/.code-forge/usage.jsonl)
Smith가 활성화된 경우 setup 스킬 내부에서 즉시 다음 서브 스킬을 실행한다. 사용자에게 추가 질문하지 않는다. 사용자가 Step 6에서 "사용"을 선택한 것이 곧 실행 동의다.
[즉시 실행] Skill 도구로 code-forge:smith-create-agent를 호출한다.
Smith 에이전트를 생성합니다...profile.json을 재사용 (Step 5 결과물)Smith 에이전트 생성 중 오류. 수동으로 /code-forge:smith-create-agent 재시도하세요.
다음 안내만 출력하고 Step 8로 진행:
(나중에 Smith를 쓰려면 /code-forge:smith-create-agent 실행)
설정이 완료되었습니다.
이 설정은 code-forge.local.md에 저장됩니다.
나중에 변경하려면:
/code-forge:smith-setup → Smith on/off
code-forge.local.md → 직접 편집 (whetstone/bellows 토글)
기존 CLAUDE.md가 있는 경우:
기존 CLAUDE.md가 발견되었습니다.
> 백업 후 새로 생성 (기존 → .claude/CLAUDE.md.bak)
기존 내용과 합치기 (하단에 code-forge 설정 추가)
취소
| 선택 | 동작 |
|---|---|
| 백업 후 새로 생성 | 기존 파일을 .claude/CLAUDE.md.bak으로 이동 후 새로 생성 |
| 기존 내용과 합치기 | 기존 CLAUDE.md 하단에 --- 구분선 + code-forge 설정 추가 |
| 취소 | 아무것도 하지 않고 종료 |
"기존 내용과 합치기" 선택 시 기존 내용을 보존하면서 스택/명령어/모듈 참조만 추가한다.
| 상황 | 대응 |
|---|---|
| package.json 없음 | 프로젝트 유형을 "기타"로 판별, 스택 설정 건너뛰기 제안 |
| package.json에서 스택 감지 불가 | "감지된 스택이 없습니다" 출력 후 수동 선택 |
| preset 파일 없음 | 오류 출력 후 알려진 프리셋 목록 안내 |
| 모듈 SKILL.md 없음 | 경고 출력 후 해당 모듈 참조 제외하고 계속 진행 |
| profile.json JSON 파싱 실패 | 오류 내용 출력 후 수정 요청 |
| CLAUDE.md 이미 존재 | CLAUDE.md 백업 안내 참조 |
| 전역 profile.json 이미 존재 | 기존 설정 보여주고 덮어쓰기 확인 |
| 로컬 + 전역 모두 존재 | 로컬 우선 적용, 전역은 fallback임을 안내 |
| 커스텀 모듈값 (옵션에 없는 값) | 정상 처리, SKILL.md 참조만 제외 |
| 프리셋명 | 스택 |
|---|---|
| standard | Pages Router + Jotai + Emotion + Jest |
| modern-stack | MUI + App Router + Zustand + Tailwind + Vitest |