kstack-worktree-diff

フェーズは実装する側の都合ではなく、user が差分を読み切って判断できる単位にする。

1 フェーズで実装する API は 1 つ

API を実装するフェーズは、HTTP method と path で特定した 1 endpoint に絞る。同じ resource の CRUD でも、一覧・作成・更新を別のフェーズにする。その API に必要な同一 package 内の route・業務処理・認可・テストは含め、API が動く状態を完了条件にする。

Bad: backend 全体を 1 フェーズにまとめる
1 backend — GET /api/items, POST /api/items, PATCH /api/items/:id

Good: endpoint ごとに実装と確認を閉じる
1 list-items   — GET /api/items。認可を含め一覧を取得できる
2 create-item  — POST /api/items。認可を含め作成できる
3 update-item  — PATCH /api/items/:id。認可を含め更新できる

なぜ: 複数 API をまとめると、request・response・認可・異常系の確認が同時に増え、レビューで見落としやすくなる。endpoint 単位なら、1 つの振る舞いとその差分を対応付けて判断できる。