{"id":51223071,"url":"https://github.com/immacualate/claude-forge","last_synced_at":"2026-07-16T19:01:03.303Z","repository":{"id":301984155,"uuid":"961766732","full_name":"immacualate/claude-forge","owner":"immacualate","description":"Transform Claude Code into a complete development environment for efficient coding and project management.","archived":false,"fork":false,"pushed_at":"2026-07-09T14:07:29.000Z","size":19179,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-07-09T16:05:31.827Z","etag":null,"topics":["agentic-ai","agentic-workflow","agents","ai","ai-framework","ai-gateway","ai-pair-programming","ai-tools","automation","claude","claude-code","claude-skill","developer-experience","macos","proxy","workflow"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/immacualate.png","metadata":{"files":{"readme":"README.ko.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"sangrokjung"}},"created_at":"2025-04-07T06:12:03.000Z","updated_at":"2026-07-09T14:09:36.000Z","dependencies_parsed_at":"2026-06-24T08:03:21.028Z","dependency_job_id":null,"html_url":"https://github.com/immacualate/claude-forge","commit_stats":null,"previous_names":["immacualate/icp-bootcamp-beginner-coding-challenge","immacualate/claude-forge"],"tags_count":0,"template":false,"template_full_name":"pt-icp-hub/ICP-Bootcamp-Beginner-Coding","purl":"pkg:github/immacualate/claude-forge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immacualate%2Fclaude-forge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immacualate%2Fclaude-forge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immacualate%2Fclaude-forge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immacualate%2Fclaude-forge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/immacualate","download_url":"https://codeload.github.com/immacualate/claude-forge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/immacualate%2Fclaude-forge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35555509,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-16T02:00:06.687Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","agentic-workflow","agents","ai","ai-framework","ai-gateway","ai-pair-programming","ai-tools","automation","claude","claude-code","claude-skill","developer-experience","macos","proxy","workflow"],"created_at":"2026-06-28T09:00:31.116Z","updated_at":"2026-07-16T19:01:03.296Z","avatar_url":"https://github.com/immacualate.png","language":"Shell","funding_links":["https://github.com/sponsors/sangrokjung"],"categories":["Source Catalog"],"sub_categories":[],"readme":"\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/banner.jpg\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"docs/banner-light.jpg\"\u003e\n  \u003cimg src=\"docs/banner.jpg\" alt=\"Claude Forge\" width=\"100%\"\u003e\n\u003c/picture\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eClaude Code를 위한 프로덕션 수준 설정 프레임워크\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/LICENSE-MIT-blue?style=for-the-badge\" alt=\"MIT License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://claude.com/claude-code\"\u003e\u003cimg src=\"https://img.shields.io/badge/CLAUDE_CODE-%E2%89%A51.0-blueviolet?style=for-the-badge\" alt=\"Claude Code\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/sangrokjung/claude-forge/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/sangrokjung/claude-forge?style=for-the-badge\u0026color=yellow\" alt=\"Stars\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/sangrokjung/claude-forge/network/members\"\u003e\u003cimg src=\"https://img.shields.io/github/forks/sangrokjung/claude-forge?style=for-the-badge\u0026color=orange\" alt=\"Forks\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/sangrokjung/claude-forge/graphs/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/sangrokjung/claude-forge?style=for-the-badge\u0026color=green\" alt=\"Contributors\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/sangrokjung/claude-forge/commits/main\"\u003e\u003cimg src=\"https://img.shields.io/github/last-commit/sangrokjung/claude-forge?style=for-the-badge\" alt=\"Last Commit\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#-빠른-시작\"\u003e빠른 시작\u003c/a\u003e \u0026bull;\n  \u003ca href=\"#-개발-워크플로우\"\u003e개발 워크플로우\u003c/a\u003e \u0026bull;\n  \u003ca href=\"#-구성-요소\"\u003e구성 요소\u003c/a\u003e \u0026bull;\n  \u003ca href=\"#-설치-가이드\"\u003e설치 가이드\u003c/a\u003e \u0026bull;\n  \u003ca href=\"#-아키텍처\"\u003e아키텍처\u003c/a\u003e \u0026bull;\n  \u003ca href=\"README.md\"\u003eEnglish\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Claude Forge란?\n\nClaude Forge는 **Claude Code**를 기본 CLI에서 **완전한 개발 환경**으로 변환합니다. 설치 한 번으로 **11개 전문 에이전트**(Opus 6 + Sonnet 5), **40개 슬래시 커맨드**, **15개 스킬 워크플로우**, **15개 자동화 훅**(보안 6 + 유틸리티 9), **9개 규칙 파일**, **6개 MCP 서버**가 모두 연결되어 즉시 사용 가능합니다.\n\n\u003e oh-my-zsh가 터미널을 강화하듯, Claude Forge는 AI 코딩 어시스턴트를 **파워 유저 도구**로 업그레이드합니다.\n\n---\n\n## ⚡ 빠른 시작\n\n```bash\n# 1. 클론\ngit clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git\ncd claude-forge\n\n# 2. 설치 (~/.claude에 심볼릭 링크 생성)\n./install.sh\n\n# 3. Claude Code 실행\nclaude\n```\n\n이것으로 끝. 모든 에이전트, 커맨드, 훅, 규칙이 즉시 사용 가능합니다.\n\n### v2.2 업데이트\n\n| 변경 | 설명 |\n|:-----|:-----|\n| **수술적 변경 원칙** | 12번째 Golden Principle 추가: 요청받은 것만 변경. 인접 코드 \"개선\", 스타일 변경, 관련 없는 리팩토링 금지. [Andrej Karpathy의 LLM 코딩 실수 관찰](https://x.com/karpathy/status/2015883857489522876)에서 영감. |\n| **코딩 전 가정 명시** | 새 interaction 규칙: 모호한 요구사항은 조용히 가정하지 말고, 가정을 명시하고 대안을 제시한 후 구현. |\n| **합리화 방지 확장** | \"이왕 고치는 김에 정리도\", \"확장성을 위해 추상화 필요\" 등 LLM의 흔한 변명 2개 추가 차단. |\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ev2.1 변경사항\u003c/strong\u003e\u003c/summary\u003e\n\n| 변경 | 설명 |\n|:-----|:-----|\n| **검증 규칙 추가** | 새 `verification.md` 규칙이 증거 기반 완료를 강제합니다 -- 테스트/빌드 실행 결과 없이 완료 선언 금지. |\n| **에이전트 자기 진화** | 핵심 5개 에이전트(planner, architect, code-reviewer, security-reviewer, tdd-guide)가 작업 후 `~/.claude/agent-memory/`에 학습 내용을 기록합니다. |\n| **훅 동기화** | `forge-update-check.sh` (세션 시작 시 업데이트 알림)와 `observe.sh` (지속 학습 관찰) 추가. |\n\n\u003c/details\u003e\n\n### 처음이신가요?\n\n개발이 처음이거나 Claude Code가 낯설다면, 여기서 시작하세요:\n\n| 단계 | 할 일 |\n|:----:|:------|\n| 1 | 설치 후 `/guide` 실행 -- 3분 인터랙티브 투어 |\n| 2 | [첫 사용자 가이드](docs/FIRST-STEPS.md) 읽기 -- 용어 사전 + TOP 6 커맨드 |\n| 3 | [상황별 레시피](docs/WORKFLOW-RECIPES.md) 보기 -- 복사해서 쓰는 5가지 시나리오 |\n\n또는 `/auto 로그인 페이지 만들기`를 입력하면, 계획부터 PR까지 알아서 진행합니다.\n\n---\n\n## 🔄 개발 워크플로우\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/workflow-pipeline.jpg\" alt=\"개발 워크플로우 파이프라인\" width=\"720\"\u003e\n\u003c/p\u003e\n\n### 새 기능 개발\n\n계획 수립부터 PR 생성까지 한 번에 진행합니다.\n\n```\n/plan → /tdd → /code-review → /handoff-verify → /commit-push-pr → /sync\n```\n\n```mermaid\ngraph LR\n    P[\"/plan\u003cbr/\u003e\u003csmall\u003e구현 계획\u003c/small\u003e\"] --\u003e T[\"/tdd\u003cbr/\u003e\u003csmall\u003e테스트 주도 개발\u003c/small\u003e\"]\n    T --\u003e CR[\"/code-review\u003cbr/\u003e\u003csmall\u003e코드 리뷰\u003c/small\u003e\"]\n    CR --\u003e HV[\"/handoff-verify\u003cbr/\u003e\u003csmall\u003eFresh 검증\u003c/small\u003e\"]\n    HV --\u003e CPR[\"/commit-push-pr\u003cbr/\u003e\u003csmall\u003e커밋 \u0026 PR\u003c/small\u003e\"]\n    CPR --\u003e S[\"/sync\u003cbr/\u003e\u003csmall\u003e문서 동기화\u003c/small\u003e\"]\n\n    style P fill:#e94560,stroke:#fff,color:#fff\n    style T fill:#0f3460,stroke:#fff,color:#fff\n    style CR fill:#0f3460,stroke:#fff,color:#fff\n    style HV fill:#533483,stroke:#fff,color:#fff\n    style CPR fill:#16213e,stroke:#fff,color:#fff\n    style S fill:#1a1a2e,stroke:#fff,color:#fff\n```\n\n| 단계 | 커맨드 | 설명 |\n|:----:|:-------|:-----|\n| 1 | `/plan` | planner 에이전트가 구현 계획, 의존성, 리스크를 분석 |\n| 2 | `/tdd` | tdd-guide 에이전트가 RED→GREEN→IMPROVE 사이클 진행 |\n| 3 | `/code-review` | code-reviewer 에이전트가 CRITICAL/HIGH/MEDIUM 이슈 분류 |\n| 4 | `/handoff-verify` | verify-agent가 새 컨텍스트에서 빌드·테스트·린트 검증 |\n| 5 | `/commit-push-pr` | 커밋 메시지 작성, 푸시, PR 생성까지 자동화 |\n| 6 | `/sync` | 프로젝트 문서 동기화 (prompt_plan.md, spec.md, CLAUDE.md, rules) |\n\n### 버그 수정\n\n```\n/explore → /tdd → /verify-loop → /quick-commit → /sync\n```\n\n| 단계 | 커맨드 | 설명 |\n|:----:|:-------|:-----|\n| 1 | `/explore` | 코드베이스를 탐색하여 원인 파악 |\n| 2 | `/tdd` | 실패 테스트 작성 → 최소 수정 → 통과 확인 |\n| 3 | `/verify-loop` | 빌드·테스트를 반복 검증하며 사이드 이펙트 확인 |\n| 4 | `/quick-commit` | 빠른 커밋 \u0026 푸시 |\n| 5 | `/sync` | 커밋 후 프로젝트 문서 동기화 |\n\n### 보안 감사\n\n```\n/security-review → /stride-analysis-patterns → /security-compliance\n```\n\n| 단계 | 커맨드 | 설명 |\n|:----:|:-------|:-----|\n| 1 | `/security-review` | security-reviewer 에이전트가 OWASP Top 10 기반 분석 |\n| 2 | `/stride-analysis-patterns` | STRIDE 위협 모델링 수행 |\n| 3 | `/security-compliance` | SOC2, GDPR 등 컴플라이언스 검증 |\n\n### 팀 협업\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/agent-teams.jpg\" alt=\"Agent Teams Hub-and-Spoke\" width=\"600\"\u003e\n\u003c/p\u003e\n\n```\n/orchestrate\n```\n\n`/orchestrate` 커맨드로 Agent Teams를 구성하여 병렬 작업을 수행합니다.\n\n```mermaid\ngraph LR\n    L[\"팀 리더\"]\n    A1[\"에이전트 1\u003cbr/\u003e\u003csmall\u003e프론트엔드\u003c/small\u003e\"]\n    A2[\"에이전트 2\u003cbr/\u003e\u003csmall\u003e백엔드\u003c/small\u003e\"]\n    A3[\"에이전트 3\u003cbr/\u003e\u003csmall\u003e테스팅\u003c/small\u003e\"]\n\n    L \u003c--\u003e|조율| A1\n    L \u003c--\u003e|조율| A2\n    L \u003c--\u003e|조율| A3\n\n    style L fill:#e94560,stroke:#fff,color:#fff\n    style A1 fill:#0f3460,stroke:#fff,color:#fff\n    style A2 fill:#0f3460,stroke:#fff,color:#fff\n    style A3 fill:#0f3460,stroke:#fff,color:#fff\n```\n\n- **Hub-and-spoke** 통신 (리더가 조율)\n- **파일 소유권** 분리 (머지 충돌 없음)\n- **페이즈 기반** 팀 교체\n- 결정 사항은 `decisions.md`로 외부화\n\n---\n\n## 📦 구성 요소\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/features-grid.jpg\" alt=\"Claude Forge 구성 요소\" width=\"720\"\u003e\n\u003c/p\u003e\n\n| 카테고리 | 수량 | 주요 항목 |\n|:--------:|:----:|:----------|\n| **에이전트** | 11 | `planner` `architect` `code-reviewer` `security-reviewer` `tdd-guide` `database-reviewer` (Opus) / `build-error-resolver` `e2e-runner` `refactor-cleaner` `doc-updater` `verify-agent` (Sonnet) |\n| **커맨드** | 40 | `/commit-push-pr` `/handoff-verify` `/explore` `/tdd` `/plan` `/orchestrate` `/security-review` ... |\n| **스킬** | 15 | `build-system` `security-pipeline` `eval-harness` `team-orchestrator` `session-wrap` ... |\n| **훅** | 15 | 보안 방어 6개 + 유틸리티 9개 |\n| **규칙** | 9 | `coding-style` `security` `git-workflow` `golden-principles` `agents-v2` `verification` ... |\n| **MCP 서버** | 6 | `context7` `memory` `exa` `github` `fetch` `jina-reader` |\n\n---\n\n## 📥 설치 가이드\n\n### 사전 요구사항\n\n| 도구 | 용도 |\n|:-----|:-----|\n| **Node.js** | MCP 서버 실행 (npx) |\n| **jq** | JSON 파싱 (설치 스크립트) |\n| **Git** | 클론, 서브모듈 |\n| **Claude Code CLI** | `claude` 명령어 |\n\n### macOS / Linux\n\n```bash\n# 클론 (서브모듈 포함)\ngit clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git\ncd claude-forge\n\n# 설치 (심볼릭 링크 생성)\n./install.sh\n```\n\n설치 스크립트가 수행하는 작업:\n\n1. 의존성 확인 (node, jq, git)\n2. Git 서브모듈 초기화 (CC CHIPS)\n3. 기존 `~/.claude/` 백업 (선택)\n4. `~/.claude/`에 심볼릭 링크 생성\n5. CC CHIPS 커스텀 오버레이 적용\n6. MCP 서버 설치 (선택)\n7. 외부 스킬 설치 (선택)\n8. 셸 별칭 설정 (`cc`, `ccr`)\n\n### Windows (WSL)\n\nWSL에서 Windows 파일시스템(`/mnt/c/...`)에 클론한 경우 심볼릭 링크 대신 **복사**로 설치됩니다.\n\n```bash\n# WSL 네이티브 경로에 클론하면 심볼릭 링크 사용 가능\ncd ~ \u0026\u0026 git clone --recurse-submodules https://github.com/sangrokjung/claude-forge.git\ncd claude-forge \u0026\u0026 ./install.sh\n```\n\n### Windows (PowerShell)\n\n```powershell\n.\\install.ps1\n```\n\n### MCP 서버 설정\n\n설치 시 자동으로 구성됩니다. API 키가 필요한 서버는 별도 설정이 필요합니다.\n\n| 서버 | API 키 필요 | 설명 |\n|:-----|:----------:|:-----|\n| **context7** | - | 실시간 라이브러리 문서 조회 |\n| **memory** | - | 영속적 지식 그래프 |\n| **fetch** | - | 웹 콘텐츠 가져오기 |\n| **jina-reader** | - | URL → 마크다운 변환 |\n| **github** | `GITHUB_PERSONAL_ACCESS_TOKEN` | 리포/PR/이슈 관리 |\n| **exa** | 인증 필요 | AI 기반 웹 검색 |\n\n### 커스터마이징\n\n추적되는 파일을 수정하지 않고 설정을 오버라이드할 수 있습니다:\n\n```bash\n# 로컬 오버라이드 파일 생성 (git-ignored)\ncp setup/settings.local.template.json ~/.claude/settings.local.json\n\n# 시크릿/환경설정 편집\nvim ~/.claude/settings.local.json\n```\n\n`settings.local.json`은 Claude Code가 `settings.json` 위에 병합합니다.\n\n---\n\n## 🏗 아키텍처\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/architecture.jpg\" alt=\"심볼릭 링크 아키텍처\" width=\"720\"\u003e\n\u003c/p\u003e\n\n```mermaid\ngraph TB\n    subgraph REPO[\"claude-forge (git 리포)\"]\n        A[\"agents/ (11)\"]\n        C[\"commands/ (40)\"]\n        S[\"skills/ (15)\"]\n        H[\"hooks/ (15)\"]\n        R[\"rules/ (9)\"]\n        SC[\"scripts/\"]\n        CC[\"cc-chips/\"]\n        K[\"knowledge/\"]\n        REF[\"reference/\"]\n        SET[\"settings.json\"]\n    end\n\n    INSTALL[\"./install.sh\"]\n    REPO --\u003e INSTALL\n\n    subgraph HOME[\"~/.claude/ (심볼릭 링크)\"]\n        HA[\"agents/\"]\n        HC[\"commands/\"]\n        HS[\"skills/\"]\n        HH[\"hooks/\"]\n        HR[\"rules/\"]\n        HSC[\"scripts/\"]\n        HCC[\"cc-chips/\"]\n        HSET[\"settings.json\"]\n    end\n\n    INSTALL --\u003e|symlink| HOME\n\n    CLAUDE[\"claude (CLI)\"]\n    HOME --\u003e CLAUDE\n\n    style REPO fill:#1a1a2e,stroke:#e94560,color:#fff\n    style HOME fill:#0f3460,stroke:#16213e,color:#fff\n    style INSTALL fill:#e94560,stroke:#fff,color:#fff\n    style CLAUDE fill:#533483,stroke:#fff,color:#fff\n```\n\n설치 스크립트가 리포에서 `~/.claude/`로 **심볼릭 링크**를 생성하므로, `git pull` 한 번으로 즉시 업데이트됩니다.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e전체 디렉토리 구조\u003c/strong\u003e\u003c/summary\u003e\n\n```\nclaude-forge/\n  ├── .claude-plugin/       플러그인 매니페스트\n  ├── .github/workflows/    CI 검증\n  ├── agents/               에이전트 정의 (.md)\n  ├── cc-chips/             상태바 서브모듈\n  ├── cc-chips-custom/      커스텀 상태바 오버레이\n  ├── commands/             슬래시 커맨드 (.md + 디렉토리)\n  ├── docs/                 스크린샷, 다이어그램\n  ├── hooks/                이벤트 기반 스크립트 (15개)\n  ├── knowledge/            지식 베이스\n  ├── reference/            참조 문서\n  ├── rules/                자동 로드 규칙 파일 (9개)\n  ├── scripts/              유틸리티 스크립트\n  ├── setup/                설치 가이드 + 템플릿\n  ├── skills/               다단계 스킬 워크플로우\n  ├── install.sh            macOS/Linux 설치 스크립트\n  ├── install.ps1           Windows 설치 스크립트\n  ├── mcp-servers.json      MCP 서버 설정\n  ├── settings.json         Claude Code 설정\n  ├── CONTRIBUTING.md       기여 가이드\n  ├── SECURITY.md           보안 정책\n  └── LICENSE               MIT 라이선스\n```\n\n\u003c/details\u003e\n\n---\n\n## 🛡 자동화 훅\n\n### 보안 훅\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/security-layers.jpg\" alt=\"보안 방어 훅\" width=\"480\"\u003e\n\u003c/p\u003e\n\n모든 작업이 계층형 보안 훅을 통과합니다:\n\n| 단계 | 훅 | 방어 대상 |\n|:----:|:---|:----------|\n| 1 | `output-secret-filter.sh` | 출력에 노출된 API 키, 토큰 |\n| 2 | `remote-command-guard.sh` | 안전하지 않은 원격 명령 |\n| 3 | `db-guard.sh` | 파괴적 SQL (DROP, TRUNCATE) |\n| 4 | `security-auto-trigger.sh` | 코드 변경 시 취약점 자동 탐지 |\n| 5 | `rate-limiter.sh` | API 호출 속도 제한 |\n| 6 | `expensive-mcp-warning.sh` | 고비용 MCP 호출 경고 |\n\n### 유틸리티 훅\n\n| 훅 | 기능 |\n|:---|:-----|\n| `code-quality-reminder.sh` | 코드 품질 체크리스트 알림 |\n| `context-sync-suggest.sh` | 컨텍스트 동기화 제안 |\n| `forge-update-check.sh` | 세션 시작 시 프레임워크 업데이트 확인 |\n| `mcp-usage-tracker.sh` | MCP 사용량 추적 |\n| `session-wrap-suggest.sh` | 세션 종료 시 정리 제안 |\n| `task-completed.sh` | 작업 완료 알림 |\n| `work-tracker-prompt.sh` | 작업 추적 프롬프트 |\n| `work-tracker-stop.sh` | 작업 추적 종료 |\n| `work-tracker-tool.sh` | 작업 추적 도구 |\n\n---\n\n## 🤖 에이전트\n\n각 에이전트는 UI에서 역할별 **색상**으로 구분됩니다:\n\n### Opus (고성능 추론)\n\n| 에이전트 | 색상 | 역할 |\n|:---------|:----:|:-----|\n| `planner` | blue | 복잡한 기능의 구현 계획 수립, 의존성/리스크 분석 |\n| `architect` | blue | 시스템 설계, 확장성, 기술 의사결정 |\n| `code-reviewer` | blue | CRITICAL/HIGH/MEDIUM 이슈 분류 코드 리뷰 |\n| `security-reviewer` | red | OWASP Top 10 기반 보안 분석 |\n| `tdd-guide` | cyan | RED → GREEN → IMPROVE 테스트 주도 개발 |\n| `database-reviewer` | blue | PostgreSQL/Supabase 스키마, 쿼리 최적화 |\n\n### Sonnet (빠른 실행)\n\n| 에이전트 | 색상 | 역할 |\n|:---------|:----:|:-----|\n| `build-error-resolver` | cyan | 빌드/TypeScript 오류 즉시 수정 |\n| `e2e-runner` | cyan | E2E 테스트 생성, 실행, 관리 |\n| `refactor-cleaner` | yellow | 데드 코드 제거, 중복 코드 정리 |\n| `doc-updater` | yellow | 문서/코드맵 자동 업데이트 |\n| `verify-agent` | cyan | 새 컨텍스트에서 빌드·테스트·린트 검증 |\n\n### 색상 체계\n\n| 색상 | 의미 |\n|:-----|:-----|\n| **blue** | 분석/리뷰 |\n| **cyan** | 테스트/검증 |\n| **yellow** | 유지보수/데이터 |\n| **red** | 보안/경고 |\n| **magenta** | 크리에이티브/리서치 |\n| **green** | 비즈니스/성공 |\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e📋 전체 커맨드 목록 (40개)\u003c/strong\u003e\u003c/summary\u003e\n\n| 커맨드 | 설명 |\n|:-------|:-----|\n| `/build-fix` | 빌드 오류 자동 수정 |\n| `/checkpoint` | 현재 상태 체크포인트 저장 |\n| `/code-review` | 방금 작성한 코드를 보안+품질 검사 |\n| `/commit-push-pr` | 커밋, 푸시, PR 생성 자동화 |\n| `/debugging-strategies` | 디버깅 전략 가이드 |\n| `/dependency-upgrade` | 의존성 업그레이드 관리 |\n| `/e2e` | E2E 테스트 실행 |\n| `/eval` | 코드 모델 평가 |\n| `/evaluating-code-models` | 코드 모델 벤치마크 |\n| `/evaluating-llms-harness` | LLM 하네스 평가 |\n| `/explore` | 코드베이스를 탐색하여 구조를 파악 |\n| `/extract-errors` | 오류 추출 및 분석 |\n| `/forge-update` | Claude Forge 프레임워크를 최신 버전으로 업데이트 |\n| `/handoff-verify` | 빌드/테스트/린트 한 번에 자동 검증 |\n| `/init-project` | 프로젝트 초기 설정 |\n| `/learn` | 학습 및 지식 축적 |\n| `/next-task` | 다음 작업 할당 |\n| `/orchestrate` | Agent Teams 멀티 에이전트 구성 |\n| `/plan` | AI가 구현 계획을 세워줍니다 |\n| `/pull` | 원격 변경사항 가져오기 |\n| `/quick-commit` | 빠른 커밋 \u0026 푸시 |\n| `/refactor-clean` | 리팩토링 및 코드 정리 |\n| `/security-compliance` | 보안 컴플라이언스 검증 |\n| `/security-review` | 보안 리뷰 실행 |\n| `/stride-analysis-patterns` | STRIDE 위협 모델링 |\n| `/suggest-automation` | 자동화 기회 제안 |\n| `/summarize` | 코드/문서 요약 |\n| `/sync-docs` | 문서 동기화 |\n| `/sync` | 최신 변경사항 풀 + 프로젝트 문서 동기화 (prompt_plan.md, spec.md, CLAUDE.md, rules). 워크플로우 완료 후 또는 세션 시작 시 사용. |\n| `/tdd` | 테스트 먼저 만들고 코드 작성 |\n| `/test-coverage` | 테스트 커버리지 분석 |\n| `/update-codemaps` | 코드맵 업데이트 |\n| `/update-docs` | 문서 업데이트 |\n| `/verify-loop` | 빌드·테스트 반복 검증 |\n| `/web-checklist` | 웹 체크리스트 검사 |\n| `/worktree-cleanup` | 워크트리 정리 |\n| `/worktree-start` | 워크트리 시작 |\n| `/auto` | 계획부터 PR까지 원버튼 자동 실행 |\n| `/guide` | 처음 사용자를 위한 3분 인터랙티브 가이드 |\n| `/show-setup` | 설치 상태와 프로젝트 정보 보기 |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🎯 전체 스킬 목록 (15개)\u003c/strong\u003e\u003c/summary\u003e\n\n| 스킬 | 설명 |\n|:-----|:-----|\n| `build-system` | 빌드 시스템 구성 및 관리 |\n| `cache-components` | 캐시 컴포넌트 패턴 |\n| `cc-dev-agent` | Claude Code 개발 에이전트 워크플로우 |\n| `continuous-learning-v2` | 지속적 학습 및 진화 시스템 |\n| `eval-harness` | LLM 평가 하네스 |\n| `frontend-code-review` | 프론트엔드 코드 리뷰 |\n| `manage-skills` | 스킬 관리 도구 |\n| `prompts-chat` | 프롬프트 채팅 |\n| `security-pipeline` | 보안 파이프라인 |\n| `session-wrap` | 세션 정리 및 래핑 |\n| `skill-factory` | 스킬 생성 팩토리 |\n| `strategic-compact` | 전략적 컴팩트 |\n| `team-orchestrator` | 팀 오케스트레이터 |\n| `verification-engine` | 검증 엔진 |\n| `verify-implementation` | 구현 검증 |\n\n\u003c/details\u003e\n\n---\n\n## 🔌 MCP 서버\n\n`mcp-servers.json`에 사전 구성 -- `./install.sh` 또는 `claude mcp add`로 설치:\n\n| 서버 | 용도 |\n|:-----|:-----|\n| **context7** | 실시간 라이브러리 문서 조회 |\n| **memory** | 영속적 지식 그래프 |\n| **exa** | AI 기반 웹 검색 |\n| **github** | 리포/PR/이슈 관리 |\n| **fetch** | 웹 콘텐츠 가져오기 |\n| **jina-reader** | URL → 마크다운 변환 |\n\n---\n\n## 🎨 커스터마이징\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e에이전트 추가하기\u003c/strong\u003e\u003c/summary\u003e\n\n`agents/` 디렉토리에 YAML frontmatter가 포함된 마크다운 파일을 생성하세요:\n\n```markdown\n---\nname: my-agent\ndescription: Use this agent when [트리거 조건]. Input: [입력]. Output: [출력].\ntools: [\"Read\", \"Grep\", \"Glob\"]\nmodel: sonnet\nmemory: project\ncolor: blue\n---\n\nYou are an expert [역할]. Your mission is to [목표].\n\n## Process\n1. [단계 1]\n2. [단계 2]\n\n## Output Format\n[출력 형식]\n```\n\n지원 frontmatter 필드: `name` (필수), `description` (필수), `model`, `color`, `tools`, `memory`, `maxTurns`, `isolation`.\n\n상세 필드 설명과 알려진 제한사항은 [reference/agents-config-ref.md](reference/agents-config-ref.md) 참조.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e슬래시 커맨드 추가하기\u003c/strong\u003e\u003c/summary\u003e\n\n`commands/` 디렉토리에 마크다운 파일을 생성하세요:\n\n```markdown\n# my-command.md\n\n/my-command 실행 시 수행할 작업을 기술합니다.\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e보안 훅 추가하기\u003c/strong\u003e\u003c/summary\u003e\n\n`hooks/` 디렉토리에 쉘 스크립트를 생성하고 `settings.json`에 등록하세요:\n\n```bash\n#!/bin/bash\n# hooks/my-guard.sh\n# 특정 도구 이벤트(PreToolUse, PostToolUse 등)에서 실행됩니다.\n```\n\n\u003c/details\u003e\n\n---\n\n## 자주 묻는 질문\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e/sync는 무엇을 하나요?\u003c/strong\u003e\u003c/summary\u003e\n\n`/sync`는 프로젝트 메모리와 문서를 동기화합니다. 원격 저장소에서 최신 변경사항을 풀한 뒤, 프로젝트 문서(`prompt_plan.md`, `spec.md`, `CLAUDE.md`, 규칙 파일)를 모두 동기화합니다. 워크플로우(기능 개발, 버그 수정, 리팩토링) 완료 후 또는 새 세션 시작 시 실행하면 Claude가 최신 컨텍스트를 유지합니다.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eClaude Forge는 세션 간 메모리를 어떻게 관리하나요?\u003c/strong\u003e\u003c/summary\u003e\n\nClaude Forge는 4계층 메모리 시스템을 사용합니다:\n\n1. **프로젝트 문서** (`CLAUDE.md`, `prompt_plan.md`, `spec.md`) -- 저장소에 영속하는 프로젝트 수준 지침과 계획. `/sync`로 최신 상태를 유지합니다.\n2. **규칙 파일** (`rules/`) -- 코딩 스타일, 보안, 워크플로우 규칙이 매 세션마다 자동 로드됩니다.\n3. **MCP 메모리 서버** -- 세션 간 영속하는 지식 그래프로 엔티티와 관계를 저장합니다.\n4. **에이전트 메모리** (`~/.claude/agent-memory/`) -- 핵심 에이전트가 작업 후 학습 내용을 기록하여 시간이 지남에 따라 추천 품질이 향상됩니다 (Self-Evolution).\n\n세션 시작 시 `/sync`를 실행하면 1, 2 계층이 최신 상태가 됩니다. MCP 메모리 서버(3계층)와 에이전트 메모리(4계층)는 자동으로 영속합니다.\n\n\u003c/details\u003e\n\n---\n\n## 🤝 기여\n\n에이전트, 커맨드, 스킬, 훅 추가 방법은 [CONTRIBUTING.md](CONTRIBUTING.md)를 참조하세요.\n\n---\n\n---\n\n## Claude Forge를 사용하시나요? 배지를 달아주세요!\n\n```markdown\n[![Built with Claude Forge](https://img.shields.io/badge/Built_with-Claude_Forge-orange?style=flat-square)](https://github.com/sangrokjung/claude-forge)\n```\n\n이 배지를 프로젝트 README에 추가하여 Claude Forge 사용을 알려주세요.\n\n---\n\n## Contributors\n\n\u003ca href=\"https://github.com/sangrokjung/claude-forge/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=sangrokjung/claude-forge\" /\u003e\n\u003c/a\u003e\n\n---\n\n## 📄 라이선스\n\n[MIT](LICENSE) -- 자유롭게 사용, 포크, 확장하세요.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eMade with ❤️ by \u003ca href=\"https://github.com/sangrokjung\"\u003eQJC (Quantum Jump Club)\u003c/a\u003e\u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimmacualate%2Fclaude-forge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimmacualate%2Fclaude-forge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimmacualate%2Fclaude-forge/lists"}