« 目次に戻る

04. 小さな変更を処理する (general cycle · small)

#いつこのフローを使うか

ywc-plan がリクエストを Small と判断したとき、自動的にこの経路に入ります。判断基準は「Task 分解なしで単一 PR に収められるか」であり、以下のいずれかに該当すると Small ではなく Medium/Large に格上げされます (05 参照)。

• ▪DB migration が含まれる
• ▪新 Library/Framework 導入が含まれる
• ▪複数 subsystem にまたがる変更である

#全体フロー

$ywc-plan → ywc-code-gen → ywc-impl-review → ywc-create-pr

参考: Small フローは ywc-plan が plan.md (spec 文書ではない) を直接生成するため、spec 文書を対象とする ywc-spec-ready はこの経路には含まれません。ywc-spec-ready は Medium/Large フローの spec 収束段階です (05 参照)。

注意: ywc-code-gen には --review のような自動レビュー flag がありません。3 段階目(ywc-impl-review)を省略するとコードレビューなしでそのまま PR が開かれるため、このフローでは必ず明示的に実行してください。(Medium/Large フローの executor は --review flag でこの段階を自動化できます — 05 参照。)

#実行例

/ywc-plan ログイン失敗時のエラーメッセージが一般的すぎて原因を把握しにくい。ロック/入力ミス/未登録など具体的な理由を表示したい

$ywc-plan ログイン失敗時のエラーメッセージが一般的すぎて原因を把握しにくい。ロック/入力ミス/未登録など具体的な理由を表示したい

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

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

/ywc-impl-review

$ywc-impl-review

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

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

Bot review comment、failed CI、merge-readiness の問題が残っている場合は、続けて ywc-handle-pr-reviews <pr-number> を実行します。Small フローは plan.md ベースで tasks/<task-name>/ directory がないため、ywc-finish-branch の task 完了処理とは合いません。

#各段階で詰まったとき

← 前: 03. 5 分で最初の機能をデプロイする · 次: 05. 複数の Task に分けて処理する →