04-agents - Claude Code ์์ด์ ํธ ์ ์
Task ๋๊ตฌ๋ก ์์ํ์ฌ ๋ฉํฐ์คํ
ํ์ดํ๋ผ์ธ์ ์ํํ๋ ์์ด์ ํธ ๋ชจ์์
๋๋ค.
์์ด์ ํธ ๋ชฉ๋ก
| ์์ด์ ํธ | ๋ชจ๋ธ | ์ฉ๋ | ์ฐ๊ด ์คํฌ/๊ท์น |
|---|
code-reviewer | sonnet | ์ฝ๋ ํ์ง/๋ณด์/์ฑ๋ฅ ๋ฆฌ๋ทฐ | /kdyextract, 05-code-quality/ |
web-crawler-builder | sonnet | ์น ํฌ๋กค๋ฌ 5๋จ๊ณ ํ์ดํ๋ผ์ธ | /crawler-code-generator |
security-reviewer | sonnet | OWASP Top 10 ๊ธฐ๋ฐ ๋ณด์ ๊ฒํ | /kdysetting |
tdd-guide | sonnet | Red-Green-Refactor TDD ๊ฐ์ด๋ | /kdysetting |
build-error-resolver | haiku | ๋น๋/๋ฐํ์ ์๋ฌ ๋น ๋ฅธ ๋ถ์ยทํด๊ฒฐ | - |
doc-updater | haiku | ์ฝ๋ ๋ณ๊ฒฝ ํ ๋ ํผ๋ฐ์ค ๋ฌธ์ ๋๊ธฐํ | /kdyweb, docs/references/ |
github-pr-reviewer | sonnet | PR diff ๋ถ์ โ code-reviewer ํ๋ ฅ โ PR ์ฝ๋ฉํธ ๋ฑ๋ก | code-reviewer, security-reviewer |
github-issue-triager | haiku | ์ด์ ๋ถ๋ฅ/๋ผ๋ฒจ๋ง/์ฐ์ ์์/์ค๋ณต ๊ฐ์ง | - |
github-release-noter | haiku | ์ปค๋ฐ ํ์คํ ๋ฆฌ โ ๋ฆด๋ฆฌ์ฆ ๋
ธํธ/์ฒด์ธ์ง๋ก๊ทธ ์๋ ์์ฑ | - |
commit-message-reviewer | haiku | ์ปค๋ฐ ๋ฉ์์ง ์ปจ๋ฒค์
๊ฒ์ฆ + ์๋ ์์ ์ ์ | docs/rules/git.md |
github-workflow-fixer | haiku | GitHub Actions ์ํฌํ๋ก์ฐ ์คํจ ์ง๋จ + ์์ | build-error-resolver |
์์ด์ ํธ vs ์คํฌ
| ๊ตฌ๋ถ | ์คํฌ | ์์ด์ ํธ |
|---|
| ์คํ ๋ฐฉ์ | /๋ช
๋ น์ด๋ก ์ง์ ์คํ | Task ๋๊ตฌ๋ก ์์ |
| ์ํฌํ๋ก์ฐ | ๋จ์ผ ์ํฌํ๋ก์ฐ | ๋ฉํฐ์คํ
ํ์ดํ๋ผ์ธ |
| ์ ํฉํ ์ํฉ | ์ ํด์ง ์ ์ฐจ ์ํ | ํ๋จ์ด ํ์ํ ๋ถ์ ์์
|
| ์์ | /kdyextract, /kdypick | code-reviewer, security-reviewer |
์ฌ์ฉ ์๋๋ฆฌ์ค๋ณ ์ ํ
์ฝ๋ ๋ฆฌ๋ทฐ
์์ด์ ํธ: code-reviewer
- 6๊ฐ์ง ๊ด์ ๊ฒํ : ์ ํ์ฑ, ๋ณด์, ์ฑ๋ฅ, ์ ์ง๋ณด์์ฑ, ํ์ค ์ค์, ํ์ง ๊ท์น
01-dev-rules-system/05-code-quality/react-best-practices/rules/ โ React/Next.js ํ๋ก์ ํธ ์ 45๊ฐ ๊ท์น ์ ์ฉ
- ๋ฆฌ๋ทฐ ๊ฒฐ๊ณผ โ
docs/logs/YYYY-MM.md์ ์๋ ์์นด์ด๋ธ
/kdyextract Phase 4-A์ ์ฐ๋ (์ถ์ถ ์ฝ๋ ํ์ง ๊ฒ์ฆ)
๋ณด์ ์ ๊ฒ
์์ด์ ํธ: security-reviewer
- OWASP Top 10 ๊ธฐ๋ฐ ๋ณด์ ์ทจ์ฝ์ ๋ถ์
- ์
๋ ฅ ๊ฒ์ฆ, ์ธ์ฆ/์ธ๊ฐ, ์ธ์ ์
, ๋ฏผ๊ฐ ๋ฐ์ดํฐ ๋
ธ์ถ ์ ๊ฒ
- ํ๋ก์ ํธ ์
ํ
(
/kdysetting) ํ ์ด๊ธฐ ๋ณด์ ์ ๊ฒ์ ํ์ฉ
TDD ๊ฐ์ด๋
์์ด์ ํธ: tdd-guide
- Red โ Green โ Refactor ์ฌ์ดํด ๊ฐ์ด๋
- ํ
์คํธ ์ ๋ต ์๋ฆฝ ๋ฐ ํ
์คํธ ์ฝ๋ ์์ฑ ์ง์
- ํ๋ก์ ํธ ์
ํ
(
/kdysetting) ํ ํ
์คํธ ํ๊ฒฝ ๊ตฌ์ถ์ ํ์ฉ
์๋ฌ ํด๊ฒฐ
์์ด์ ํธ: build-error-resolver
- ๋น๋/๋ฐํ์ ์๋ฌ ๋น ๋ฅธ ๋ถ์ ๋ฐ ํด๊ฒฐ ๋ฐฉ์ ์ ์
- haiku ๋ชจ๋ธ๋ก ๋น ๋ฅธ ์๋ต
- ์คํ ํธ๋ ์ด์ค ๋ถ์, ์์กด์ฑ ์ถฉ๋ ํด๊ฒฐ
๋ฌธ์ ๋๊ธฐํ
์์ด์ ํธ: doc-updater
- ์ฝ๋ ๋ณ๊ฒฝ ํ
docs/references/ ๋ฌธ์ ์๋ ๋๊ธฐํ
/kdyweb ํ์ด์ง ๋ณ๊ฒฝ ์ ์ฐ๋
- haiku ๋ชจ๋ธ๋ก ๋น ๋ฅธ ์ฒ๋ฆฌ
ํฌ๋กค๋ฌ
์์ด์ ํธ: web-crawler-builder
์คํฌ: /crawler-code-generator
| ์ํฉ | ์ ํ |
|---|
| URL์ ์ด๋ฏธ ์๊ณ ์์ | /crawler-code-generator (์คํฌ) |
| URL์ ๋ชจ๋ฆ, ํ์ ํ์ | web-crawler-builder (์์ด์ ํธ) |
์์ด์ ํธ๊ฐ URL์ ๋ฐ๊ฒฌํ๋ฉด ์คํฌ์ ์ฝ๋ ์์ฑ ๋ก์ง์ ํ์ฉํฉ๋๋ค.
PR ๋ฆฌ๋ทฐ
์์ด์ ํธ: github-pr-reviewer
- PR diff๋ฅผ
gh pr diff๋ก ์์งํ์ฌ ์ข
ํฉ ๋ถ์
code-reviewer์ 6๊ฐ์ง ๊ฒํ ๊ธฐ์ค + ์ ํ์ security-reviewer ๋ณด์ ์ค์บ
- ๋ฆฌ๋ทฐ ๊ฒฐ๊ณผ๋ฅผ
gh pr review๋ก GitHub์ ๋ฑ๋ก (์ฌ์ฉ์ ํ์ธ ํ)
์ด์ ๋ถ๋ฅ
์์ด์ ํธ: github-issue-triager
- ๋ฏธ๋ถ๋ฅ ์ด์๋ฅผ ์๋ ๋ถ๋ฅ (bug/enhancement/documentation/question)
- ์ฐ์ ์์ ํ๋จ (critical/high/medium/low)
- ์ค๋ณต ์ด์ ๊ฐ์ง ๋ฐ ๋ผ๋ฒจ ์ ์ฉ (
gh issue edit)
๋ฆด๋ฆฌ์ฆ ๋
ธํธ
์์ด์ ํธ: github-release-noter
- Git ํ๊ทธ ๊ฐ ์ปค๋ฐ์ ๋ถ์ํ์ฌ ์นดํ
๊ณ ๋ฆฌ๋ณ ๋ฆด๋ฆฌ์ฆ ๋
ธํธ ์์ฑ
- Breaking Changes ๋ณ๋ ๊ฐ์กฐ
gh release create๋ก GitHub ๋ฆด๋ฆฌ์ฆ ๋ฑ๋ก (์ฌ์ฉ์ ํ์ธ ํ)
์ปค๋ฐ ๋ฉ์์ง ๊ฒ์ฆ
์์ด์ ํธ: commit-message-reviewer
- ํ๊ตญ์ด ์์ฑ, ์๋ฏธ ๋จ์ ์ปค๋ฐ, ๊ธธ์ด ๋ฑ ์ปจ๋ฒค์
๊ฒ์ฆ
- ๋ชจํธํ ๋ฉ์์ง ๊ฐ์ง ๋ฐ ๊ฐ์ ์ ์ ์
- ์ฐธ์กฐ ๊ท์น:
01-dev-rules-system/02-project-template/docs/rules/git.md
์ํฌํ๋ก์ฐ ์์
์์ด์ ํธ: github-workflow-fixer
- GitHub Actions ์คํจ ๋ก๊ทธ ๋ถ์ ๋ฐ ์๋ฌ ํจํด ๋ถ๋ฅ
.github/workflows/*.yml ํ์ผ ๋ถ์ ๋ฐ YAML diff ์์ ์ ์ ์
build-error-resolver์ ์๋ฌ ๋ถ๋ฅ ์ฒด๊ณ๋ฅผ CI/CD ์ปจํ
์คํธ์ ํ์ฅ
๊ด๋ จ ๋ฆฌ์์ค