From fde15978abf7b165f2837a829a6aa9a06206bbfa Mon Sep 17 00:00:00 2001 From: infra Date: Mon, 15 Jun 2026 00:02:53 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20AI=20=ED=99=9C=EC=9A=A9=20=ED=8C=81=20+?= =?UTF-8?q?=20bkit=20=ED=94=8C=EB=9F=AC=EA=B7=B8=EC=9D=B8(=EC=84=A4?= =?UTF-8?q?=EC=B9=98/=EC=A3=BC=EC=9A=94=EB=AA=85=EB=A0=B9)=20=EC=95=88?= =?UTF-8?q?=EB=82=B4=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.8 --- MANUAL.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/MANUAL.md b/MANUAL.md index f761f7c..c42a2c6 100644 --- a/MANUAL.md +++ b/MANUAL.md @@ -188,6 +188,32 @@ claude # Claude Code 실행 (또는 codex / gemini) ``` - **참고**: DB(`$DATABASE_URL`)·S3 접속정보는 `.project-env` 에 이미 들어 있고, 프로젝트 폴더에 들어가면 자동 적용됩니다. 코드에서는 그냥 `process.env.DATABASE_URL` 등으로 쓰면 됩니다. +### 8-1. AI 도구를 잘 쓰는 법 (팁) + +- **항상 프로젝트 폴더 안에서 실행**하세요. AI 는 "지금 폴더"의 파일을 읽어 맥락을 잡습니다. +- **`CLAUDE.md` 를 활용**하세요. sample 에는 이미 `CLAUDE.md`(이 프로젝트 규칙: podman 개발, Coolify 배포, 비밀값 금지 등)가 들어 있고, Claude 가 자동으로 읽습니다. 프로젝트 규칙·주의사항을 여기에 적어두면 AI 가 그대로 따릅니다. +- **구체적으로 시키세요**. "로그인 API 만들어줘" 보다 "`src/` 에 POST /login 엔드포인트 추가, 입력 검증하고 실패 시 401 반환" 처럼. +- **확인은 직접**: AI 가 만든 코드도 9번(로컬 실행)·10번(컨테이너)으로 **반드시 본인이 동작 확인** 후 커밋하세요. +- 키가 안 먹으면(401) → 5번 `update-litellm-key`. 모델 오류(400)면 → 5번 표의 모델명. + +### 8-2. bkit — AI 개발 보조 플러그인 (선택, 권장) + +**bkit**(Vibecoding Kit, https://www.bkit.ai/ )은 Claude Code 에 **체계적 개발 절차(PDCA: 계획→설계→구현→검증)** 와 다수의 전문 스킬을 더해주는 플러그인입니다. "무엇을 만들지"만 설명하면 bkit 이 계획부터 구현·검증까지 단계적으로 진행해 줍니다. + +**설치 (최초 1회, Claude Code 안에서 입력)** +``` +/plugin marketplace add popup-studio-ai/bkit-claude-code +/plugin install bkit +``` + +**자주 쓰는 명령** (Claude Code 프롬프트에 입력) +- `/pdca pm <기능이름>` — 기능 하나를 계획→구현→검증까지 한 번에. **처음엔 이거 하나면 충분**합니다. +- `/sprint` — 여러 기능을 묶은 릴리스 단위 작업. +- `/control` — AI 가 얼마나 자동으로 진행할지(자율도) 조절. + +> bkit 의 세부 절차를 몰라도 됩니다 — **원하는 걸 자연어로 말하면** bkit 이 알맞은 흐름을 골라 줍니다. +> 더 알아보려면 공식 사이트(bkit.ai) / GitHub(`popup-studio-ai/bkit-claude-code`) 참고. + --- ## 9. 로컬에서 실행하고 브라우저로 확인하기