shinpr/claude-code-workflows

무엇이 문제를 해결하나요

Claude Code Workflows는 생성된 코드가 설계 문서와 테스트에 엄격히 일치하도록 구조화된 에이전트 기반 개발 수명 주기를 제공합니다. 이를 통해 AI가 생성한 코드가 원래 요구사항에서 벗어나거나 자체 테스트에 실패하는 일반적인 문제를 방지합니다. 개발 프로세스의 각 단계에 전문 에이전트를 도입하여 이를 달성합니다.

어떻게 작동하나요

이 프로젝트는 사용자 요청을 전문 에이전트 파이프라인으로 라우팅하는 "레시피"(진입점) 시리즈를 구현합니다. 작업 복잡도(소, 중, 대)에 따라 워크플로가 달라집니다:

• 분석 및 계획: requirement-analyzer가 작업 규모를 결정합니다. 더 큰 작업의 경우 제품 요구 사항 문서(PRD) 생성, 코드베이스 분석 및 기술 설계 문서 생성을 트리거합니다.

• 실행: 백엔드 또는 프론트엔드 전문 실행자가 테스트 주도 개발(TDD)을 사용하여 기능을 구현하고, 코드가 타입 검사 및 린팅되도록 합니다.

• 검증: code-reviewer 및 code-verifier가 설계 문서에 따라 구현을 검토하여 요구 사항이 누락되지 않았는지 확인합니다.

• 진단: investigator, verifier, solver 사이의 전용 루트를 사용하여 버그의 근본 원인을 분석하고 트레이드오프 분석을 기반으로 솔루션을 제안합니다.

• 역공학: 시스템은 기존 코드를 스캔하여 PRD 및 설계 문서를 생성하여 레거시 코드베이스를 AI 친화적으로 만듭니다.

누가 사용하면 좋나요

Claude Code를 사용하는 개발자로, 단순한 채팅 기반 코드 생성보다 더 결정적이고 전문적인 소프트웨어 엔지니어링 프로세스를 원하는 분에게 적합합니다. 특히 백엔드 API, React/TypeScript 프론트엔드 또는 풀스택 애플리케이션을 작업하는 분들에게 유용합니다.

주요 기능

• 레이어 인식 워크플로: 백엔드, 프론트엔드, 풀스택 개발을 위한 별도의 플러그인, 각각 전문 에이전트가 있음(예: React용 ui-spec-designer).
• 멀티 에이전트 오케스트레이션: Analyzer $ ightarrow$ Designer $ ightarrow$ Planner $ ightarrow$ Executor $ ightarrow$ Reviewer 의 에이전트 체인을 사용하여 깨끗한 컨텍스트 창을 유지합니다.
• UI 명세: 프론트엔드 작업을 위한 전용 단계로, 프로토타입에서 자주 놓치는 엣지 케이스(로딩, 오류, 빈 상태)를 포착합니다.
• 자동 문서화: 기존 코드를 구조화된 PRD 및 설계 문서로 역공학할 수 있는 기능.
• TDD 통합: 테스트 우선 구현 및 품질 수정을 위한 내장 원칙.