[20250821] AIコーディングエージェント用 作業手順 (バックエンド編)

[linzhengen]

AIコーディングエージェント用 作業手順

0. チケット理解
   • 与えられたチケット内容を確認し、GEMINI.mdを参照してアーキテクチャや規約を理解する。
   • 楽しく実装を開始する。
1. 開発ブランチ作成
   • git fetch で最新を取得し、origin/main から新しい開発ブランチを切る。
   • ブランチ名は commitlint規約 に準拠する。
2. ドメイン定義
   • internal/domain/ に必要なドメイン定義を追加する。
   • 既存の定義を参考にする。
3. Protobuf定義
   • proto/ に必要な定義を追加する。
   • 既存の .proto を参考にする。
4. SQL定義
   • internal/infrastructure/persistence/{mysql|postgres|/query/ に sqlc 用のSQLクエリを作成する。
5. コード生成
   • make gen を実行し、sqlc, pb, openapiなどのコードを生成する。
6. リポジトリ実装
   • 生成された sqlc コードを利用し、internal/infrastructure/* にリポジトリを実装する。
7. Usecase実装
   • internal/usecase/ にビジネスロジックを実装する。
8. gRPCハンドラ実装
   • internal/interface/grpc/ にgRPCハンドラを実装する。
9. 依存性注入 (DI)
   • di/di.go に今回実装したコンポーネントの依存関係を追加する。
10. ユーザー確認

• 実装内容の概要を整理し、ユーザーに提示する。
• 後続作業を進めてよいか確認する。

11. 静的解析

• golangci-lint run ./... を実行し、コード品質を確認する。

12. テスト

• 実装に対応するテストを作成し、go test ./... を実行する。
• 全テストが成功することを確認する。

13. コミット & プッシュ

• git add, git commit, git push を行う。

14. Pull Request作成

• GitHubにてPull Requestを作成する。

15. 開発完了報告

• Slackでユーザーに開発完了を報告する。