대상 사용자: 스타트업을 운영하는 1인 개발자, 유일한 엔지니어, 회사 전체.
목표: 이 저장소(repo)를 어떤 프로젝트에든 가져와서 즉시 사용 가능한 완전한 에이전트 팀을 구축하는 것.
설계 대상: Next.js / React / TypeScript 풀스택 웹 앱 (Prisma, npm/pnpm, Vercel). 다른 스택에서도 에이전트 프롬프트(prompts)를 조정하여 사용할 수 있지만, 예시와 도구 기본값은 이 스택을 대상으로 합니다.
제작자: Paul @ UndeadList — 무엇이 효과적인지 직접 겪으며 배웠습니다.

당신은 1인 개발자입니다. 당신에게는 다음이 없습니다:

• QA 팀
• 코드 리뷰어 (code reviewer)
• DevOps 엔지니어
• 통제 불능이 되는 AI 에이전트들에 시간을 낭비할 여유

이 워크플로 패키지(workflow package)는 Claude Code 서브 에이전트(subagents)를 통해 이 모든 것을 제공하며, 당신의 시간을 낭비하는 쓸데없는 상황을 방지하기 위한 엄격한 프로토콜을 갖추고 있습니다.

claude-code-agents/
├── .claude-plugin/
│ ├── plugin.json # 플러그인 매니페스트 (Plugin manifest)
...

총계: 24개의 에이전트 + 6개의 워크플로 기술 (workflow skills)

한 번 설치하면 모든 프로젝트에서 사용할 수 있습니다. 프로젝트마다 파일을 복사할 필요가 없습니다.

# 1단계: 마켓플레이스 추가 (Claude Code 내부에서)
/plugin marketplace add undeadlist/claude-code-agents
# 2단계: 플러그인 설치 (Claude Code 내부에서)
...

또는 1단계 이후, /plugin을 사용하세요.

→ Discover 탭에서 찾아보고 설치할 수 있습니다.

터미널에서도 설치할 수 있습니다:

claude plugin install claude-code-agents@undeadlist-claude-code-agents --scope user

모든 24개의 에이전트와 6개의 워크플로 기술이 기본적으로 사용 가능해집니다. /full-audit , /pre-commit , /pre-deploy 등의 기술을 사용하세요.

설치 후, 모든 것이 로드되었는지 확인하세요:

# Claude Code 내부에서 질문:
"List all available agents and skills from the claude-code-agents plugin"

24개의 에이전트와 6개의 기술이 보여야 합니다. 그렇지 않다면 아래의 문제 해결(Troubleshooting) 섹션을 확인하세요.

설치하지 않고 로컬에서 플러그인을 테스트하려면:

git clone https://github.com/undeadlist/claude-code-agents.git
claude --plugin-dir ./claude-code-agents

이 방식은 해당 세션에 대해서만 플러그인을 로드하며, 전역(globally)으로 설치되지 않습니다.

프로젝트별 설치를 선호한다면:

옵션 A: 전체 설정 (CLAUDE.md 생성, 스택 감지)

curl -s https://undeadlist.com/agents/setup-project.sh | bash

옵션 B: 에이전트만 설치

...

이 명령은 에이전트들을 프로젝트의 .claude/agents/ 디렉토리로 복사합니다.

이 에이전트들은 Prisma, npm/pnpm, 그리고 Vercel을 사용하는 Next.js / React / TypeScript 프로젝트에 최적화되어 있습니다. 에이전트 프롬프트 전반에 걸친 명령어, 파일 경로 및 예시는 이 스택을 반영합니다.

스택 불가지론적(Stack-agnostic) 에이전트 (모든 프로젝트에 유용함):

security-auditor
— OWASP 점검은 모든 웹 앱에 적용됩니다.

code-auditor
— 품질 원칙은 언어에 구애받지 않습니다.

doc-auditor
— 문서화 격차 분석(documentation gap analysis)은 어디서나 작동합니다.

pr-writer
— 모든 git 리포지토리에 대한 PR 설명을 생성합니다.

fix-planner
— 우선순위 지정 로직은 프레임워크에 독립적입니다.

architect-reviewer
— 리뷰 기준은 범용적입니다.

다른 스택에 맞게 조정하기: 리포지토리를 포크(Fork)하고 agents/ 디렉토리에 있는 에이전트 .md 파일들을 수정하세요. Next.js 전용 명령어(npm run dev, pnpm tsc, localhost:3000)를 사용 중인 스택의 상응하는 명령어로 교체하면 됩니다. 오케스트레이션(orchestration) 구조는 스택과 관계없이 작동하며, 도구(tool)별 예시만 변경하면 됩니다.

claude "Run pre-commit workflow"

커밋 전 code-auditor + test-runner를 실행합니다.

claude "Run pre-deploy workflow"

배포 전 빌드, 환경 변수(env vars), 의존성(dependencies)을 검증합니다.

claude "Run full-audit workflow on src/"

11개의 모든 감사(auditor)를 병렬로 실행 → fix-planner가 FIXES.md를 생성합니다.

claude "Run new-feature workflow for: [feature description]"

test-writer → code-fixer → test-runner → browser-qa (TDD 방식).

claude "Run bug-fix workflow for: [bug description]"

실패하는 테스트 작성 → 수정 → 검증 (회귀 방지 (regression prevention)).

claude "Run release-prep workflow for v1.0.0"

전체 감사 → 수정 → 배포 검증 → PR 생성.

curl -s https://undeadlist.com/agents/setup-project.sh | bash

코드를 수정하기 전에, 청사진(blueprint)을 만드세요:

claude "이 프로젝트를 위한 SETUP_BLUEPRINT.md를 생성하세요:
- 폴더 구조
- 기술 스택 결정 (근거 포함)
...

빌드 중 AI 에이전트를 위한 엄격한 규칙 (Strict rules):

## 이 세션의 규칙
1. 현재 작업과 직접 관련이 없는 파일을 수정하기 전에는 반드시 **먼저 질문할 것**
2. "수정하는 김에" 리팩토링을 **절대 하지 말 것**
...

모든 작업의 핵심 루프 (Core loop):

┌─────────────────────────────────────────────────┐
│ 1. 작업을 이해합니다 │
│ 2. 수정할 파일들을 명시합니다 │
...

전체 병렬 감사 (Full parallel audit) 실행:

claude "src/ 디렉토리에 대해 full-audit 워크플로우를 실행하세요"

.claude/audits/ 디렉토리에서 다음 항목을 검토하세요:

• AUDIT_CODE.md, AUDIT_SECURITY.md, AUDIT_DB.md, AUDIT_PERF.md
• FIXES.md (우선순위가 지정된 실행 항목)

Chrome 통합 활성화:

/chrome

전체 QA 루프 실행:

claude "fullstack-qa-orchestrator를 사용하여 다음을 수행하세요:
1. 개발 서버 시작 (npm run dev)
2. http://localhost:3000 으로 이동
...

claude "pre-deploy 워크플로우를 실행하세요"

모든 AI 에이전트는 다음을 준수해야 합니다:

## 모든 변경 사항 적용 전
1. 수정하려는 파일을 명시합니다
2. 수행하려는 변경 사항을 명시합니다
...

복잡한 변경 사항의 경우:

## 모든 단계:
1. 에이전트가 계획된 변경 사항을 명시합니다
2. 에이전트가 검증을 위해 architect-reviewer를 호출합니다
...

변경 사항 적용 전:

# 베이스라인 테스트 (Baseline testing)
curl -s http://localhost:3000/api/health # API 작동 확인
pnpm tsc --noEmit # TypeScript 유효성 확인
...

# 코딩 세션 시작
claude "CLAUDE.md를 검토한 후, [task]를 도와주세요"
# 커밋 전 빠른 확인
...

# 전체 감사 (Full audit)
claude "src/ 디렉토리에 대해 full-audit 워크플로우를 실행하세요"
# 브라우저 QA
...

# 콘솔 모니터링
claude "console-monitor를 사용하여 http://localhost:3000을 모니터링하세요"
# 특정 버그
...

모든 보고서는 .claude/audits/로 전송됩니다.

(gitignored):

파일	소스 에이전트 (Source Agent)
AUDIT_CODE.md	code-auditor
...
작업 (Task)	명령 (Command)
---	---
새 프로젝트 설정 (New project setup)	`curl -s https://undeadlist.com/agents/setup-project.sh
...

• 에이전트가 묻지 않고 변경 사항을 적용함
• 에이전트가 승인 없이 패키지를 설치함
• 에이전트가 예기치 않게 설정 파일을 수정함
• 에이전트가 검증 없이 성공했다고 주장함
• 에이전트가 체크포인트 (Checkpoints)를 건너뜀
• 에이전트가 범위를 벗어난 파일을 건드림

# 마지막 변경 사항 되돌리기 (Revert last change)
git checkout -- [file]
# 모든 변경 사항 되돌리기 (Revert all changes)
...

"STOP. 허락을 받지 않았습니다."
"STOP. 범위를 벗어났습니다."
"STOP. 완료되었다고 말하기 전에 작동 여부를 검증하세요."
...

플러그인 오류 확인: Claude Code 내부에서 /plugin을 실행하고 Errors 탭을 확인하세요.

마켓플레이스 (Marketplace) 추가 여부 확인: /plugin으로 이동 → Marketplaces 탭 — undeadlist-claude-code-agents가 보여야 합니다.

플러그인 설치 여부 확인: /plugin으로 이동 → Installed 탭 — claude-code-agents가 보여야 합니다.

다시 추가 및 재설치: /plugin marketplace add undeadlist/claude-code-agents / /plugin install claude-code-agents@undeadlist-claude-code-agents

/full-audit과 같은 스킬은 플러그인으로 설치되었을 때만 작동합니다. 프로젝트별 설치 (npx claude-code-agents)는 에이전트를 .claude/agents/에 설치하지만 슬래시 명령 (slash commands)을 등록하지는 않습니다. 대신 자연어를 사용하세요:

claude "Run full-audit workflow on src/"

• Node.js >= 14 필요
• 프로젝트 디렉토리에서 실행해야 함
• 에이전트를 프로젝트 내 .claude/agents/로, 워크플로 (workflows)를 workflows/로 복사함

설정 스크립트 URL은 https://undeadlist.com/agents/setup-project.sh 입니다 (setup.sh가 아님). 만약 CDN이 구성되어 있지 않다면, GitHub raw URL을 사용하세요:

curl -sL https://raw.githubusercontent.com/undeadlist/claude-code-agents/main/install.sh | bash

프로젝트에 에이전트를 참조하는 CLAUDE.md가 있는지 확인하세요. setup-project.sh를 실행하여 자동으로 생성하거나, 이 리포지토리의 CLAUDE.md를 템플릿으로 사용하세요.

# Claude Code에서:
/plugin uninstall claude-code-agents

# 옵션 A: 한 줄 명령어 (권장)
curl -s https://raw.githubusercontent.com/undeadlist/claude-code-agents/main/uninstall.sh | bash
# 옵션 B: 수동 제거
...

다음 항목들이 제거됩니다:

.claude/agents/

• 에이전트 프롬프트 정의 (agent prompt definitions)

.claude/audits/

• 생성된 보고서 (gitignored)

workflows/

• 사전 정의된 워크플로 체인 (predefined workflow chains)

참고: CLAUDE.md는 그대로 유지됩니다. 원하는 경우 수동으로 제거하세요.

더 나은 프로토콜을 찾으셨나요? 존재해야 할 에이전트가 있나요?

PR(Pull Request)을 보내주세요: https://github.com/undeadlist/claude-code-agents

MIT 라이선스. 사용하고, 포크(fork)하고, 개선하세요.

Built by UndeadList
인디 소프트웨어 플리 마켓 (The indie software flea market)

면책 조항 (Disclaimer): Claude Code는 Anthropic PBC의 제품입니다. 이 프로젝트는 Anthropic과 제휴하거나 Anthropic의 승인을 받지 않았습니다.

"만들어졌으나, 아직 발견되지 않은 (Built, but undiscovered)."