shinpr/claude-code-workflows

Development workflows for Claude Code that keep broad exploration focused on the outcome you approved.

Claude Code Development Workflows

무엇인가요 – Claude Code AI 어시스턴트를 구조화된 개발 프로세스 엔진으로 바꾸는 Claude Code 플러그인 모음입니다. 플러그인은 "레시피"(예: /recipe‑implement, /recipe‑design, /recipe‑review)를 정의하여 모델을 다음 단계로 안내합니다:

범위 합의 – 사용자와 Claude가 원하는 결과 및 제외 사항에 대해 합의합니다.
설계 및 계획 – Claude가 설계 문서, UI 사양, ADR, 작업 계획을 생성하고, 코드 작성 전에 검토합니다.
작업 수준의 구현 – 작업 계획 항목이 실행되며, 리포지토리 고유의 품질 규칙에 따라 검증된 후 자동으로 커밋됩니다.
독립적 검토 – 두 번째 단계의 보안/검토 에이전트가 워크플로우 종료 전에 기능적, 신뢰성, 보안 리그레션 여부를 전체 변경 사항에 대해 검사합니다.

이 시스템은 의도적으로 세 가지 플러그인 패밀리로 나뉩니다:

플러그인	대상	일반적인 진입점
`dev‑workflows`	백엔드 또는 일반 코드베이스	`/recipe‑implement`, `/recipe‑design`, …
`dev‑workflows‑frontend`	React/TypeScript 프론트엔드	`/recipe‑front‑design`, `/recipe‑front‑build`, …
`dev‑workflows‑fullstack`	백엔드와 프론트엔드 모두를 포함하는 프로젝트	`/recipe‑fullstack‑implement`, …

왜 사용할 수 있을까

설계 논의와 실제 코드 생성 사이에 공식적인 인수인계가 필요할 때. Claude가 합의된 제품 목표에서 벗어나지 않도록 하기 위해.
팀이 반복 가능한 안전 장치(설계 검토, 작업 계획 승인, 독립적 보안 검토)를 플러그인이 자동으로 강제하길 원할 때.
이미 Claude Code를 사용하고 있으며, 여러 리포지토리에서 동일한 AI 기반 워크플로우를 유지하고 싶을 때.

빠른 시작 (README에서)

# 1. Claude Code 시작
claude

# 2. 플러그인을 호스팅하는 마켓플레이스 추가
/plugin marketplace add shinpr/claude-code-workflows

# 3. 프로젝트 유형에 맞는 플러그인 설치
#   – 백엔드 / 일반
/plugin install dev-workflows@claude-code-workflows
/recipe-implement "공개 API에 레이트 제한 추가"

#   – React 프론트엔드
/plugin install dev-workflows-frontend@claude-code-workflows
/recipe-front-design "계정 복구 화면 추가"

#   – 풀스택
/plugin install dev-workflows-fullstack@claude-code-workflows
/recipe-fullstack-implement "JWT + 로그인 폼을 사용한 사용자 인증 추가"

하나의 리포지토리에는 하나의 워크플로우 플러그인만 설치해야 합니다. 풀스택 플러그인은 이미 백엔드와 프론트엔드 레시피를 포함하고 있습니다.

워크플로우 작동 방식 (고수준 흐름)

요청 → 결과 및 제외 사항 합의 →
   ┌─► 단순 경로? ──► 직접 작업 사이클 → 완료
   │
   └─► 복잡한가? → 검토 → 설계 → 검토 → 범위 승인 →
        태스크별: 구현 → 검증 → 품질 검사 → 커밋 →
        독립적 보안 검토 → (수정 루프) → 완료

어떤 경로를 선택할지는 제품 결정의 복잡성에 따라 결정되며, 파일 수는 아님.

플러그인이 도입하는 핵심 개념

작업 계획 – 설계 문서, ADR, UI 사양 등에서 나온 승인된 요구사항을 하나 이상의 구체적인 작업에 매핑하는 테이블. 누락된 부분은 경고로 표시되어 문서화되지 않은 사항이 없도록 함.
작업 템플릿 – 생성된 각 작업은 정확한 수용 기준과 커밋 전에 실행되는 예/아니오 컴플라이언스 체크를 포함합니다.
품질 프로파일 – docs/project‑context/quality.yaml에 저장된 리포지토리 고유의 린트, 테스트, 보안 규칙. 플러그인은 모든 검증 단계에서 이 프로파일을 읽습니다.
전문 에이전트 – requirement‑analyzer, code‑verifier, security‑reviewer와 같은 AI 에이전트의 세트를 오케스트레이션하여 설계, 구현, 검토의 관심사를 분리합니다.

예시 실행 (README 요약)

사용자가 /recipe‑implement "공개 API에 레이트 제한 추가"를 실행.
Claude가 리포지토리를 분석하고 설계 문서를 제안하며, 사용자가 승인.
작업 계획이 생성되어 4개의 작업으로 분할됨 (미들웨어 추가, 설정 업데이트, 테스트 작성, 문서 업데이트).
각 작업에서 작업 실행자 에이전트가 코드를 작성하고, 코드 검증기가 리포지토리의 품질 프로파일을 실행하며, 변경 사항이 커밋됨.
모든 작업이 완료된 후, 보안 검토기 에이전트가 독립적인 검사를 수행. 문제 없음. 워크플로우 종료.

필요하지 않은 경우

변경 사항이 빠른 프로토타입이거나, 결과와 안전한 구현 경계가 이미 명확한 경우, 추가 워크플로우 오버헤드 없이 Claude Code를 직접 사용할 수 있습니다.

라이선스 및 기여

라이선스: MIT (README의 배지 참조).
기여: PR 환영합니다. 리포지토리에는 PRs welcome 배지 포함.

결론

shinpr/claude-code-workflows는 자신의 코드에 가져오는 라이브러리가 아닙니다. Claude Code를 사용하는 모든 프로젝트에 엄격하고 AI 기반의 개발 파이프라인을 추가하는 Claude Code 플러그인 세트입니다. 설계 검토, 작업 계획 승인, 태스크 수준의 검증, 독립적 보안 검토를 코드화함으로써, 팀이 Claude가 생성한 코드가 합의된 제품 목표와 리포지토리 품질 기준에 부합하도록 도와줍니다.