프로젝트 소개

Claude Code Workflows는 Claude Code용 플러그인 모음으로, 에이전트 주변에 구조화된 개발 프로세스를 추가합니다. 목표는 수렴입니다: Claude의 광범위한 코드베이스 탐색을 사용자가 승인한 결과에 집중시키고, 우연한 발견이 변경을 지배하지 않도록 하는 것입니다. 작동 방식 워크플로우는 설계 전에 의도된 결과와 제외 사항을 합의하고, 실제 저장소를 기준으로 설계를 확인하며, 커밋 전 각 작업을 검증하고, 큰 변경 사항은 완성된 구현을 독립적으로 검토합니다. 승인된 범위 내에서 Claude는 코드베이스 자체에서 구현 세부 사항을 선택할 것으로 기대됩니다. README는 결과와 안전한 구현 경계가 이미 명확할 때는 Claude Code를 직접 사용하고, 범위 합의, 지속적인 설계 결정, 컨텍스트 간 핸드오프 또는 독립적 검증이 필요한 변경에는 이 워크플로우를 사용하라고 권장합니다. 라우팅은 파일 수가 아닌 제품 및 설계 결정 수에 따라 달라집니다: 작은 변경은 집중 검사와 저장소 검사 및 보안 검토가 포함된 직접 작업 주기를 따르고, 중간 변경은 검토된 설계 문서(및 필요한 경우 UI 사양 또는 ADR), 선택된 통합/E2E 증명, 검토된 작업 계획을 추가하며, 여러 독립적 제품 결과가 있는 큰 변경은 검토된 PRD를 추가합니다. UI 사양, ADR 및 테스트 스켈레톤과 같은 산출물은 해당 결정 또는 증명 경계가 적용될 때만 나타납니다. 설치 플러그인 마켓플레이스 지원이 있는 Claude Code 릴리스가 필요합니다. /plugin marketplace add shinpr/claude-code-workflows로 마켓플레이스를 추가한 다음, dev-workflows(백엔드/일반), dev-workflows-frontend(React/TypeScript) 또는 dev-workflows-fullstack 중 하나의 워크플로우 플러그인을 설치합니다. README는 풀스택 플러그인이 이미 백엔드 및 프론트엔드 워크플로우를 포함하므로 워크플로우 플러그인 하나만 설치해야 한다고 명시합니다. 팀을 위한 프로젝트 범위 설치도 .claude/settings.json을 통해 지원됩니다. 레시피 및 플러그인 모든 진입점은 recipe- 접두사를 사용합니다. 백엔드/일반 레시피에는 /recipe-implement, /recipe-design, /recipe-plan, /recipe-build, /recipe-review, /recipe-quality-profile, /recipe-diagnose, /recipe-reverse-engineer, /recipe-add-integration-tests 및 /recipe-update-doc이 포함됩니다. 프론트엔드 플러그인은 React 컴포넌트 아키텍처, React Testing Library 및 TypeScript 검사를 통해 /recipe-front-design, /recipe-front-plan, /recipe-front-build, /recipe-front-adjust 및 /recipe-front-review를 추가합니다. 풀스택 레시피는 백엔드와 프론트엔드를 아우르는 변경을 다루며, 수직 슬라이스를 사용하여 통합이 끝나기 전에 실행되도록 합니다. 에이전트 및 지침 플러그인은 특수 에이전트 역할을 번들합니다: requirement-analyzer, prd-creator, codebase-analyzer, code-verifier, work-planner, task-decomposer, acceptance-test-generator, integration-test-reviewer, code-reviewer, document-reviewer, design-sync, investigator, verifier, solver 및 security-reviewer와 같은 공유 역할; technical-designer, scope-discoverer, task-executor 및 quality-fixer와 같은 백엔드 역할; ui-spec-designer, ui-analyzer, technical-designer-frontend, task-executor-frontend 및 quality-fixer-frontend와 같은 프론트엔드 역할. 내장 지침은 코딩 원칙, 테스트 원칙, 구현 접근 방식, 문서 표준, 외부 리소스 컨텍스트 및 LLM 친화적 컨텍스트를 다룹니다. 별도의 dev-skills 플러그인은 워크플로우 없이 지침만 제공하며, README는 중복 스킬 설명으로 인해 워크플로우 플러그인과 함께 설치하지 말라고 경고합니다. 컨텍스트 및 산출물 한 단계의 추론이 다음 단계의 권위가 되지 않도록 새 컨텍스트가 사용됩니다. 작업 계획 작업은 이를 제약하는 설계 문서, ADR 또는 UI 사양 섹션과 승인 기준을 인용하며, 필요한 모든 설계 문서 의무가 최소 하나의 작업으로 처리될 때만 계획이 완료된 것으로 간주됩니다. PRD, ADR, UI 사양 및 설계 문서는 커밋하도록 의도되며, docs/plans/는 임시 작업 상태로 취급되고 README는 이를 gitignore할 것을 제안합니다. README는 또한 Codex CLI 대응물인 codex-workflows를 언급하고 LLM 검증 및 에이전트 워크플로우 설계에 대한 배경 읽기를 링크합니다.