shinpr/claude-code-workflows

해결하는 문제

Claude Code는 복잡한 코드베이스 탐색 중에 목표에서 벗어나 부가적인 발견에 너무 많은 시간을 할애하는 경우가 있습니다. 이 프로젝트는 AI 기반 개발이 합의된 결과에 집중되도록 보장하고, 범위 확장(스코프 크리프)을 방지하며, 구현 세부 사항이 설계 결정과 일치하는지 검증하는 구조화된 워크플로우(플러그인 형태)를 제공합니다.

작동 방식

이는 Claude Code를 위한 '레시피'(플러그인)의 연속으로 작동하며, 엄격한 개발 라이프사이클을 안내합니다. 일반적으로 다음 단계를 따릅니다:

1. 합의: 코드를 작성하기 전에 AI와 사용자가 원하는 결과와 제외 사항에 대해 합의합니다.
2. 설계: 비트리비얼한 변경 사항의 경우, AI는 설계 문서, PRD, 또는 UI 사양을 생성하고, 검토 및 승인을 받습니다.
3. 구현: AI는 구체적인 작업으로 나누어 작업 계획을 수립합니다. 각 작업은 구현되고, 검증되며, 품질 검사를 거친 후 커밋됩니다.
4. 검증: 완료된 구현에 대해 독립적인 검토가 수행되어, 합의된 결과를 충족하고 보안 또는 신뢰성 문제 없이 작동하는지 확인합니다.

대상 사용자

스코프 합의, 지속 가능한 설계 결정, 신뢰할 수 있는 검증이 필요한 비트리비얼한 변경 사항을 진행하는 Claude Code 사용자. 특히 백엔드, 프론트엔드(React/TypeScript), 또는 풀스택 프로젝트에 적합합니다.

주요 특징

• 전문 레시피: 백엔드, 프론트엔드, 풀스택 개발을 위한 전용 경로를 제공하며, UI 분석 및 React Testing Library 검사에 특화된 도구 포함.
• 독립적 검토: 단일 세션에서의 '자기 평가' 편향을 피하기 위해 보안 및 기능 검토를 별도의 에이전트 호출로 수행.
• 라이트 모드: 검사 수를 줄여 빠른 반복을 가능하게 하되, 승인 정지 지점을 유지하는 간소화된 워크플로우.
• 포괄적인 도구 세트: 문제 진단, 기존 시스템의 역엔지니어링을 통한 문서화, 설계 소스에 기반한 UI 조정 등을 위한 레시피 포함.