$ywc
8 stars
Guidebook / 시작하기

03. 5분 안에 첫 기능 배포하기

Guide7분 소요

이 페이지는 작은 버그 수정 하나를 아이디어 단계부터 merge 까지 실제로 따라가 보는 첫 실습입니다.

« 목차로 돌아가기

03. 5분 안에 첫 기능 배포하기

이 페이지는 작은 버그 수정 하나를 아이디어 단계부터 merge 까지 실제로 따라가 보는 첫 실습입니다. 예시 시나리오: "로그인 실패 시 에러 메시지가 너무 일반적이라 원인 파악이 어렵다" 는 요청을 처리합니다.

이 흐름의 개념 설명은 04. general cycle (small)에서 더 자세히 다룹니다 — 이 페이지는 실습에 집중합니다.

Step 1 — 계획 세우기

claude code
ywc-plan 로그인 실패 시 에러 메시지가 너무 일반적이라 원인 파악이 어려움. 잠김/오타/미가입 등 구체적 사유를 보여주고 싶음

ywc-plan 이 codebase 를 먼저 읽고, 이 변경이 단일 PR 로 끝날 수 있는 Small 규모인지 판단합니다. Small 로 판단되면 plan.md 파일이 생성됩니다 — What / Why / Out of Scope / Done When 4가지 항목이 채워져 있는지 확인하세요.

Step 2 — 계획을 수렴시키기

claude code
ywc-spec-ready --spec plan.md

plan.md 에 아직 남은 concern 이 있으면 자동으로 보완 후 재검증하고, 이미 깨끗하면 그대로 다음 단계로 handoff 됩니다.

Step 3 — 코드 생성

claude code
ywc-code-gen --spec plan.md --feature "specific login failure reason"

Backend / Frontend / QA 세 layer 를 병렬로 생성합니다. 생성이 끝나면 DONE, DONE_WITH_CONCERNS, BLOCKED, NEEDS_CONTEXT 중 하나로 끝나는 완료 보고서가 나옵니다 — 각 상태의 의미는 02. 핵심 개념을 참고하세요.

Step 4 — PR 열기 전에 리뷰하기

claude code
ywc-impl-review

ywc-code-gen 은 자동 리뷰 flag 가 없으므로, 이 단계를 건너뛰면 코드 리뷰 없이 바로 PR 이 열립니다. 생략하지 마세요.

Step 5 — PR 생성 및 Review

claude code
ywc-create-pr --title "fix: show specific login failure reason"

ywc-create-pr 이 commit, secret scan, local validation, draft PR 생성, remote CI/Bot Review 확인을 처리합니다. Bot review comment 나 merge-readiness 문제가 남으면 아래처럼 PR health sweep 을 별도로 실행합니다.

claude code
ywc-handle-pr-reviews 123

Small 흐름은 plan.md 기반이라 tasks/<task-name>/ artifact 가 없습니다. 따라서 task 완료 처리까지 포함하는 ywc-finish-branch 대신, reviewer 승인 후 GitHub UI 또는 gh pr merge 로 merge 하는 흐름이 더 안전합니다.

여기까지 왔다면

축하합니다 — 하나의 변경을 처음부터 끝까지 완주했습니다. 다음에 볼만한 페이지:

← 이전: 02. 핵심 개념 · 다음: 04. 작은 변경 처리하기 →