AIエージェントと開発を進めていく

ここ最近の変わりよう

要件の重要性、どこに何を書くかのルール決め、コーディングスタイルやルールの説明

AIへの説明をして如何に手を動かす時間を任せられるかを考えている。

ドキュメントの配置

AGENTS.md ：全体のルールがどこに置いてあるか

Notion：人のドキュメント。AIもこれを参照してほしいが、実行時に渡せば問題ないとも思う。

backendなどそれぞれのディレクトリに説明を書いた後で、どうしていくべきか。

各ディレクトリに分ける？流石にそこまでするのは大変そう...。

公式ではこのように案内。Ruleに小分けしていく。

code:md

your-project/

├── .claude/

│ ├── CLAUDE.md # Main project instructions

│ └── rules/

│ ├── code-style.md # Code style guidelines

│ ├── testing.md # Testing conventions

│ └── security.md # Security requirements

code:markdown

.claude/rules/

├── frontend/

│ ├── react.md

│ └── styles.md

├── backend/

│ ├── api.md

│ └── database.md

└── general.md

2-1. Permission / Hooks — 「やってはいけないこと」を機械的にブロックする

AGENTS.mdやrulesにルールを書いても、Claudeが毎回従うとは限りません。機械的にチェックできるものはPermissionとHooks、Linterに落とし込んで、ルール違反を不可能にする方が確実です。

レビュー

手元でAIレビューを動かす状態

自動でAIがある程度レビューしてコメントしている状態

AIがレビューしてマージまでしている状態

参考

Next

ルールの整備

レビューの自動化

段階的にApprove-Auto-Mergeまでを行えるように...

調査などの置き換え

自動で毎週走るとかそういう

Skillsをもう少し深める