By ggombee
ํ๋ก์ ํธ ์คํ์ ๋ง๋ ์์ด์ ํธ, ์คํฌ, ์ปจ๋ฒค์ ์ ์กฐํฉํ๋ Claude Code ํ๋ฌ๊ทธ์ธ. Smith(Agent Smith System) ์ง์.
npx claudepluginhub ggombee/code-forge๊ณํ ๋๋ ์์ ์ ๋ถ์ํ์ฌ ์ฆ์ ๊ตฌํ. ์ต์ ์ ์ ์์ด ๋ฐ๋ก ์คํ.
tsc/eslint ์ค๋ฅ ์์ ์ ๋ฌธ๊ฐ. ๊ฐ๋จํ ์ค๋ฅ๋ ์ฆ์ ์์ , ๋ณต์กํ ์ค๋ฅ๋ ๋ถ์ ํ ์์ .
๊ณํ ์ ์๊ตฌ์ฌํญ ๋ถ์. ๋์น ์ง๋ฌธ, ๊ฐ์ , ์ฃ์ง ์ผ์ด์ค ๋ฐ๊ฒฌ.
์ํคํ ์ฒ ๋ถ์ ๋ฐ ์ค๊ณ ์๋ฌธ. ๊ทผ๊ฑฐ ๊ธฐ๋ฐ ๊ถ์ฅ์ฌํญ ์ ๊ณต. READ-ONLY.
ํ๋ก ํธ์๋ ํ ์คํธ ์ฝ๋ ์๋ ์์ฑ. BDD ์๋๋ฆฌ์ค ๋์ถ, ํ ์คํธ ์์ฑ, ์คํ ๋ฐ ์๋ ์์ . TDD ์ง์.
๋น๋/ํ์ /์ปดํ์ผ ์ค๋ฅ ์์ ์ ๋ฌธ๊ฐ. ์ต์ ๋ณ๊ฒฝ์ผ๋ก ์ค๋ฅ ํด๊ฒฐ. ์ํคํ ์ฒ ๋ณ๊ฒฝ ์์.
์ฝ๋ ํ์ง, ๋ณด์, ๊ท์น ์ค์, ์ ์ง๋ณด์์ฑ ๊ฒํ . OWASP Top 10 ๊ธฐ๋ฐ ๋ณด์ ์ค์บ.
OpenAI Codex MCP ์ฐ๋ ์์ด์ ํธ. ๊ผผ๊ผผํ ๊ตฌํ, ์ฝ๋ ๋ฆฌ๋ทฐ, ์ฃ์ง์ผ์ด์ค ๊ฒ์ฆ. Agent Teams Team Lead.
์์จ์ ์ฌ์ธต ๊ตฌํ ์ ๋ฌธ๊ฐ. ํ์, ๊ณํ, ์คํ์ ๋ ๋ฆฝ ์ํ. ์ต์ข ๊ฒฐ๊ณผ๋ง ๋ณด๊ณ .
git ์ํ ํ์ธ, ์คํ ์ด์ง, ์ปค๋ฐ, ๋ก๊ทธ/๋ธ๋์น ๊ด๋ฆฌ. ํ๋ก์ ํธ ์ปค๋ฐ ๊ท์น ์ค์.
๋ฆฌํฉํ ๋ง ๋ถ์ ์ ๋ฌธ๊ฐ. ๋ณต์ก๋, ์ค๋ณต, ํจํด ๋ถ์ ํ ๋จ๊ณ์ ๊ฐ์ ์ ๋ต ์ ์. READ-ONLY.
์ธ๋ถ ๋ฌธ์/๋ผ์ด๋ธ๋ฌ๋ฆฌ ์กฐ์ฌ ์ ๋ฌธ๊ฐ. ๊ณต์ ๋ฌธ์, GitHub, Stack Overflow ๊ฒ์. ์ถ์ฒ URL ํ์.
์ฝ๋๋ฒ ์ด์ค ๋น ๋ฅธ ํ์ ์ ๋ฌธ๊ฐ. ํ์ผ/์ฝ๋ ํจํด ๊ฒ์, ๊ตฌํ ์์น ํ์ .
๋ฏธ๋์ด ํ์ผ ๋ถ์ ์ ๋ฌธ๊ฐ. ์ด๋ฏธ์ง, PDF, ๋ค์ด์ด๊ทธ๋จ ํด์ ๋ฐ ์ ๋ณด ์ถ์ถ.
์์ ์ฐ์ถ๋ฌผ ์ ๋ฆฌ. design-refs, test-results, temp ํ์ผ ๋ฑ.
Claude + OpenAI Codex ํ์ ์คํฌ. MCP ์๋ฒ ์ค์ ์์๋ง ์ฌ์ฉ ๊ฐ๋ฅ.
Playwright๋ก ์น์ฌ์ดํธ๋ฅผ ์ง์ ํ์ํ์ฌ ํฌ๋กค๋ง ํ๋ฆ ์ค๊ณ. API/๋คํธ์ํฌ ๋ถ์, ๋ฌธ์ํ, ํฌ๋กค๋ฌ ์ฝ๋ ์์ฑ.
๊ต์ฐจ ๋ชจ๋ธ ํ ๋ก . Agent Teams / Codex CLI / self-debate ๋ชจ๋ ์ ํ. ์ค๊ณ ๊ฒฐ์ , ์ํคํ ์ฒ ์ ํ ์ ํ์ฉ.
ํ๋ฉด ๋จ์ E2E ํ ์คํธ ์๋ํ. Figma/์ฝ๋ ๊ธฐ๋ฐ ํ ์คํธ ์ผ์ด์ค ๋์ถ โ Playwright ์ฝ๋ ์์ฑ โ Forge Loop(์์ค์ปฌ๋ ์ด์ ๊ธฐ๋ฐ ์์จ ์คํ).
Figma ๋์์ธ์ Emotion ๊ธฐ๋ฐ ์ฝ๋๋ก ๋ณํ. Pixel-perfect ๊ตฌํ.
code-forge ์ํ ๋์๋ณด๋. REFLECT flag, quality ์ด๋ฒคํธ, notepad/decisions, usage ์ง๊ณ๋ฅผ ํ ๋ฒ์. forge-glow ๊ฐ์ ์ธ๋ถ ๋๊ตฌ๋ --json์ผ๋ก ํ์ฑ.
Google Gemini CLI ๋ํผ. Claude Code ๋ด์์ Gemini ๋ชจ๋ธ์ ํธ์ถํ์ฌ ๋ฉํฐ๋ชจ๋ธ ์ํฌํ๋ก์ฐ ์ง์.
ํ๋ก ํธ์๋ ํ ์คํธ ์ฝ๋๋ฅผ ์๋ ์์ฑํฉ๋๋ค. ์์ค ์ฝ๋, Figma ๋์์ธ, ์๊ตฌ์ฌํญ์ ๋ถ์ํ์ฌ BDD ์๋๋ฆฌ์ค ๊ธฐ๋ฐ์ ํ ์คํธ ์ฝ๋๋ฅผ ์์ฑํ๊ณ ์คํ๊น์ง ์ํํฉ๋๋ค.
๊ตฌ์กฐํ๋ ๋ฆฌ์์น ์ํ. ์ฃผ์ ๋ณ ๊น์ด(quick/standard/deep) ์ ํ, ๋ณ๋ ฌ ์์ง, ์ ๋ขฐ๋ ๋ฑ๊ธ ๋ถ์ฌ, ๋งํฌ๋ค์ด ๋ฆฌํฌํธ ์์ฑ.
Agent Teams ํ๊ฒฝ ์ค์ . Claude Max ์ ์ฉ. TeamCreate/SendMessage/TeamDelete ๋๊ตฌ ํ์ฑํ.
Claude Channels(ํ ๋ ๊ทธ๋จ/๋์ค์ฝ๋) ์๋ ์ ์ . ํฐ์์ ๋ฉ์์ง๋ก Claude Code์ ์์ ์ง์ ๊ฐ๋ฅ. --auto ํ๋๊ทธ์ FORGE_OUTPUT=json ํ๋กํ ์ฝ ๊ณต์ .
ํ๋ก์ ํธ์ Playwright E2E ํ ์คํธ ํ๊ฒฝ์ ์ธํ ํฉ๋๋ค. ํ๋ก์ ํธ ๊ตฌ์กฐ ๊ฐ์ง โ ํจํค์ง ์ค์น โ ์ค์ ํ์ผ โ ๋๋ ํ ๋ฆฌ ๊ตฌ์กฐ โ ์ํ ํ ์คํธ ๊ฒ์ฆ.
ํ๋ก ํธ์๋ ํ๋ก์ ํธ์ ํ ์คํธ ํ๊ฒฝ์ ์ด๊ธฐ ์ธํ ํฉ๋๋ค. ํ๋ก์ ํธ ๊ตฌ์กฐ๋ฅผ ์๋ ๊ฐ์งํ์ฌ jest/vitest ์ค์ , customRender, MSW ๋ฑ์ ๊ตฌ์ฑํฉ๋๋ค.
profile.json์ ์ฝ์ด CLAUDE.md๋ฅผ ์๋ ์์ฑํ๋ค. ํ๋ก์ ํธ ์คํ์ ๋ง๋ ๋ชจ๋์ ์กฐํฉํ์ฌ Claude Code ํ๊ฒฝ์ ์ธํ ํ๋ค. ์ธ์ ์์ ์ "code-forge updated" ๋๋ "version mismatch" ๋ฉ์์ง๊ฐ ๋ณด์ด๋ฉด ์ฌ์ฉ์์๊ฒ ์ฌ์คํ ์ฌ๋ถ๋ฅผ ๋ฌผ์ด๋ณธ ํ ์ด ์คํฌ์ ์คํํ๋ค.
Smith ์ธ์คํด์ค๋ฅผ ๋น๋ํ์ ์ปดํ์ผํ์ฌ ํ๋ซ .md ์์ด์ ํธ ํ์ผ์ ์์ฑํ๋ค. "Smith ๋น๋", "์์ด์ ํธ ์ปดํ์ผ", "smith build" ๋ฑ์ ์์ฒญ์ ์ฌ์ฉํ๋ค.
ํ๋ก์ ํธ๋ฅผ ๋ถ์ํ์ฌ Smith 2.0 ์์ด์ ํธ๋ฅผ ์์ฑํ๋ค. STATE class ์กฐํฉ๊ณผ ACT class๋ฅผ ์ ํํ์ฌ instance ์์ด์ ํธ๋ฅผ ๋ง๋ ๋ค. "์์ด์ ํธ ๋ง๋ค์ด์ค", "Smith ์์ด์ ํธ ์์ฑ", "create agent", "์์ด์ ํธ ์ธํ " ๋ฑ์ ์์ฒญ์ ์ฌ์ฉํ๋ค.
MD ํ์ผ ๋๋ ํ ์คํธ๋ก ์์ ์ ์ ์ํ๋ฉด, ๋ถ์ โ ๋์์ธ ํ์ธ โ ๊ตฌํ โ ๊ฒ์ฆ โ ์ปค๋ฐ โ PR๊น์ง ์ ์ฒด ํ๋ก์ฐ๋ฅผ ์ํํ๋ค.
Peter Thiel 7 Questions + YC PMF + The Mom Test + JTBD๋ก ์คํํธ์ ์์ด๋์ด๋ฅผ ์๊ฒฉํ๊ฒ ๊ฒ์ฆ. 100์ ๋ง์ ์ฑ์ + ์ฝ์ ์ง๋จ + ๊ฐ์ ๋ก๋๋งต.
code-forge ์ฌ์ฉ๋ ํต๊ณ. ~/.code-forge/usage.jsonl์ ํ์ฑํ์ฌ ์์ด์ ํธ/์คํฌ ์ฌ์ฉ ๋น๋ top 5์ ์์ฝ์ ํฐ๋ฏธ๋์ ์ถ๋ ฅ.
ํ ์คํธ ํตํฉ ์ง์ ์ . ๋ณ๊ฒฝ ํ์ผ์ ๋ถ์ํ์ฌ ์ ๋/E2E/์ธํ ์ ์๋ ๋ผ์ฐํ .
์ค์นํ๋ฉด Claude Code๊ฐ ๋ ์ ๋์ํฉ๋๋ค.
14๊ฐ ์ ๋ฌธ ์์ด์ ํธ, 17๊ฐ ์คํฌ, 17๊ฐ ์คํ ๋ชจ๋. ๊ฒ์ฆ๋ ์ฌ๊ณ ๋ชจ๋ธ์ด ๋ชจ๋ ์์ ์ ํ์ง์ ์ผ๊ด๋๊ฒ ์ ์งํฉ๋๋ค.
# 1. ๋ง์ผํ๋ ์ด์ค ๋ฑ๋ก (์ต์ด 1ํ)
claude plugin marketplace add https://github.com/ggombee/forge-market.git
# 2. ํ๋ฌ๊ทธ์ธ ์ค์น
claude plugin install code-forge
# 3. ํ๋ก์ ํธ ์ธํ
claude
> /setup
# 1. ํด๋ก
git clone https://github.com/ggombee/code-forge.git
# 2. ํ๋ฌ๊ทธ์ธ ๋๋ ํ ๋ฆฌ ์ง์ ํ์ฌ ์คํ
claude --plugin-dir /path/to/code-forge
# 3. ํ๋ก์ ํธ ์ธํ
> /setup
๋งค๋ฒ ์ ๋ ฅํ๊ธฐ ๋ฒ๊ฑฐ๋ก์ฐ๋ฉด alias๋ฅผ ์ถ๊ฐํ์ธ์:
alias claude-forge='claude --plugin-dir /path/to/code-forge'
/setup์ด ํ๋ ์ผpackage.json์ ์ฝ์ด์ ์คํ์ ์๋ ๊ฐ์งํ๊ณ , ํ๋ก์ ํธ์ ๋ง๋ CLAUDE.md + AGENTS.md๋ฅผ ์์ฑํฉ๋๋ค. ์คํ ์ ํ, ๊ธฐ๋ฅ ์ค์ (Smith/Whetstone/Bellows on/off)๊น์ง ๋ํํ์ผ๋ก ์งํ๋ฉ๋๋ค.
/start feature.md โ ํ ์ค์ด๋ฉด PR๊น์งMD ํ์ผ์ ์๊ตฌ์ฌํญ์ ์ ์ผ๋ฉด, ๋ถ์ โ ๋์์ธ ํ์ธ โ ๊ตฌํ โ ํ ์คํธ โ ๋ฆฐํธ โ ์ปค๋ฐ โ PR๊น์ง ํ ๋ฒ์. ์ค๊ฐ์ ๋ ๋ฒ๋ง ๋ฌผ์ด๋ด ๋๋ค: "๊ตฌํํ ๊น์?", "์ปค๋ฐํ ๊น์?"
/start feature.md # ์ ์ฒด ํ๋ก์ฐ
/start feature.md --plan-only # ๋ถ์+๊ณํ๋ง
/start "๋ฒํผ ์์ ๋ณ๊ฒฝ" # ์์ ํ
์คํธ๋ ๊ฐ๋ฅ
/bug-fix โ ์ต์
์ ์ ์ํฉ๋๋ค์๋ฌ ๋ฉ์์ง๋ฅผ ๋์ง๋ฉด 2-3๊ฐ์ง ํด๊ฒฐ ๋ฐฉ์์ ๋น๊ตํด์ ๋ณด์ฌ์ค๋๋ค. ์ ํํ๋ฉด ๋ฐ๋ก ์์ .
/bug-fix "TypeError: Cannot read property of undefined"
| ์คํฌ | ํ ์ค ์ค๋ช |
|---|---|
/done | ์ด๋ฏธ ๊ตฌํํ ์ฝ๋ โ ๊ฒ์ฆ โ ์ปค๋ฐ โ PR |
/refactor | ๋ฆฌํฉํ ๋ง ๋ถ์ + ์ ์ฑ ๋ณดํธ ํ ์คํธ |
/generate-test | BDD ์๋๋ฆฌ์ค ๊ธฐ๋ฐ ํ ์คํธ ์ฝ๋ ์์ฑ |
/debate | ์๋ก ๋ค๋ฅธ ๋ชจ๋ธ๋ผ๋ฆฌ ํ ๋ก ์์ผ์ ๋ฐฉํฅ ๊ฒฐ์ |
/research | ๊ตฌ์กฐํ๋ ํฉํธ ๊ธฐ๋ฐ ๋ฆฌ์์น |
/codex | OpenAI Codex์ ํ์ด ํ๋ก๊ทธ๋๋ฐ |
/setup --profile | ํ๋ก์ ํธ ์ฝ๋ฉ ์คํ์ผ ๋ถ์ โ ํ๋กํ ์์ฑ |
์ฝ๋๋ฅผ ์์ ํ ์ ์๋ ๋๊ณผ ์๋ ๋์ ํ์คํ ๋๋ด์ต๋๋ค.
| ๊ถํ | ๋๊ตฌ | ํ ์ ์๋ ๊ฒ |
|---|---|---|
| ์ฝ๊ธฐ๋ง | analyst, architect, refactor-advisor, vision | ๋ถ์, ์ค๊ณ, ๋ฆฌ๋ทฐ โ ์ฝ๋ ์ ๊ฑด๋๋ฆผ |
| Bash๋ง | scout, code-reviewer, git-operator, researcher | ํ์, ๋ฆฌ๋ทฐ, git, ์กฐ์ฌ โ ํ์ผ ์์ ์ ํจ |
| ์์ ๋ง | lint-fixer, build-fixer | ๊ธฐ์กด ํ์ผ ์์ โ ์ ํ์ผ ์์ฑ ์ ํจ |
| ์ ์ฒด | implementor, deep-executor, assayer, codex | ๋ญ๋ ๊ฐ๋ฅ |
๊ฐ๋จํ ํ์์ haiku๊ฐ ๋น ๋ฅด๊ฒ, ๋ณต์กํ ๊ตฌํ์ sonnet์ด, ์ํคํ ์ฒ ๋ถ์์ opus๊ฐ ์ฒ๋ฆฌํฉ๋๋ค.
์์ด์ ํธ๋ฅผ STATE(์ด ์์ด์ ํธ๊ฐ ์๋ ๊ฒ)์ ACT(์ด ์์ด์ ํธ๊ฐ ํ๋ ๊ฒ)๋ก ๋๋ ์ ์ ์ํ๊ณ , ๋น๋ํ์์ ์ปดํ์ผํฉ๋๋ค.
ํ๋ก์ ํธ ์์ด์ ํธ๋ ์ฌ๊ณ ๋ชจ๋ธ(Blueprint)์ด ์ธ๋ผ์ธ ์๋ฒ ๋ฉ๋์ด ํ๋ฌ๊ทธ์ธ ์์ด๋ ํต์ฌ ๊ท์น์ด ๋์ํฉ๋๋ค.
/code-forge:smith-create-agent # ํ๋ก์ ํธ ๋ถ์ โ ๋ง์ถค ์์ด์ ํธ ์๋ ์์ฑ (setup์์ ์๋ ํธ์ถ๋จ)
/code-forge:smith-build # ์๋ ๋น๋
/setup์ด package.json์ ์ฝ๊ณ ์๋์ผ๋ก ๋ง์ถฐ์ค๋๋ค. ์๋์ผ๋ก ๊ณ ๋ฅด๋ ค๋ฉด:
| ์นดํ ๊ณ ๋ฆฌ | ์ ํ์ง |
|---|---|
| Framework | Next.js Pages Router, App Router, React SPA |
| Design System | MUI, Ant Design |
| State | Jotai+TanStack, Zustand+TanStack, Redux RTK |
| Styling | Emotion, Tailwind, Styled Components |
| Testing | Jest, Vitest |
ํ๋ฆฌ์
์ผ๋ก ํ ๋ฒ์: standard (Pages+Jotai+Emotion+Jest) ๋๋ modern-stack (MUI+App+Zustand+Tailwind+Vitest)
ํ๋ฌ๊ทธ์ธ๋ง์ผ๋ก ๋ค ๋ฉ๋๋ค. ์๋๋ ์์ผ๋ฉด ๋ ์ข์ ๊ฒ๋ค:
| MCP | ํจ๊ณผ |
|---|---|
| Figma | /start์์ ๋์์ธ ์๋ ๋ถ์ |
| Codex | ๋ค๋ฅธ ๋ชจ๋ธ๊ณผ ํ์ด ํ๋ก๊ทธ๋๋ฐ |
์์ผ๋ฉด? ๊ทธ๋ฅ ์ ์ฐ์ ๋๋ค. ์๋ฌ ์ ๋ฉ๋๋ค.
MIT
Universal Claude Code workflow with specialized agents, skills, hooks, and output styles for any software project. Includes orchestrator, code-reviewer, debugger, docs-writer, security-auditor, refactorer, and test-architect agents.
Matches all tools
Hooks run on every tool call, not just specific ones
Bypasses permissions
Runs without the normal permission approval flow
Share bugs, ideas, or general feedback.
oh-my-zsh for Claude Code โ 11 agents, 33 commands, 24 skills, 15 hooks + 9 examples (21 events), 9 rules, 4 MCP (minimal: playwright, context7, jina-reader, chrome-devtools@0.23.0). One-line install: curl -fsSL https://raw.githubusercontent.com/sangrokjung/claude-forge/main/install.sh | bash
Full-stack agents โ frontend, backend, API, DevOps architects
Autonomous multi-agent development framework with spec-driven sprints and convergent iteration
The development-workflow plugin for Claude Code โ 35 skills organized around a 6-phase workflow (Think โ Review โ Build โ Ship โ Maintain โ Setup), 24 agents, and an interactive setup wizard for rules, modes, hooks, and MCP servers.
The most comprehensive Claude Code plugin โ 48 agents, 182 skills, 68 legacy command shims, selective install profiles, and production-ready hooks for TDD, security scanning, code review, and continuous learning
Executes bash commands
Hook triggers when Bash tool is used
Executes bash commands
Hook triggers when Bash tool is used
Modifies files
Hook triggers on file write and edit operations
Modifies files
Hook triggers on file write and edit operations
Requires secrets
Needs API keys or credentials to function
Requires secrets
Needs API keys or credentials to function
Uses power tools
Uses Bash, Write, or Edit tools
Uses power tools
Uses Bash, Write, or Edit tools
Share bugs, ideas, or general feedback.