cc-dev-agent

Claude Code Agent

Claude Code를 활용한 Spec-Driven 개발 워크플로우 및 Context Engineering 가이드.

핵심 원칙

1. Context Engineering: 제한된 컨텍스트 윈도우에서 토큰 유용성 최적화
2. Spec-Driven: 코드 전에 스펙(spec.md) 먼저 → 반복 수정 8배 감소
3. TDD Loop: Red(테스트) → Green(구현) → Refactor
4. Sub-agents 활용: Explore, Plan 에이전트로 작업 분산
5. 작성-검증 분리: /clear 후 새 눈으로 검증 (Boris 원칙)

병렬 개발 (Agent Teams v6)

> Git Worktree 기반 병렬 개발은 레거시. Agent Teams가 팀 생성/정리를 자동 처리.

전제조건

• CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS를 1로 설정
• 설정 위치: ~/.claude/settings.json의 env 또는 셸 환경변수

사용법

/orchestrate --type feature   # 기능 구현
/orchestrate --type bugfix    # 버그 수정
/orchestrate --type refactor  # 리팩토링

→ 상세 가이드: references/sub-agents.md

개발 완료 후 워크플로우 (Boris 방식)

> "Give Claude a way to verify its work. If Claude has that feedback loop, it will 2-3x the quality."

핵심 플로우

/orchestrate (선택) → 개발 → /handoff-verify
→ /commit-push-pr --merge
→ /web-checklist → /sync-docs

단계별 역할

→ 상세 가이드: references/post-dev-workflow.md

Context Engineering

→ 상세 가이드: references/context-engineering.md

Sub-agents

병렬 처리: 최대 10개 동시 실행

→ 상세 가이드: references/sub-agents.md

개발 5단계

Phase 1: 초기화 → CLAUDE.md 생성
Phase 2: 기획 → spec.md, prompt_plan.md 작성
Phase 3: 구현 → TDD Loop 반복 (핵심)
Phase 4: 검증 → 스펙 대조, 코드 리뷰
Phase 5: 배포 → 보안 검토, 최종 점검

Think 키워드

→ 상세 사용법: references/troubleshooting.md

Quick Reference

필수 .gitignore (병렬 개발 충돌 방지)

.claude/context/
.claude/settings.json
.claude/settings.local.json
.claude/handoff.md
CLAUDE.local.md

참조 문서