AIと開発するための「共通ルール」をつくった：projectStandardの紹介
いまの個人開発では、ChatGPT、Claude、Claude Code、Cursor、Codexなど、いろいろなAIツールを使い分けています。ただ、ツールごとに進め方がばらばらだと、品質も保守のしやすさも安定しません。
そこで、studio-tmkのプロジェクトで共通して使う開発標準のリポジトリ「projectStandard」をつくりました。
AIツールを切り替えるたびに、同じ説明を最初からし直していることに気づきました。ツールによってフォルダの切り方や書き方が少しずつ違い、あとから見返すと統一感がありません。それなら、最初にルールを決めて、どのAIにも同じものを読んでもらおうと考えました。
目的
- 開発の進め方を統一する
- 仕様、DB、UI、API、デバッグ、ドキュメントを一貫して扱う
- 自分以外の人や初心者でも運用・保守しやすくする
- AIツールを切り替えても、同じルールで作業できるようにする
AIツールにも、このリポジトリを開発ルールの「一次情報源」として扱ってもらいます。
どんなルールがあるか
ルールは大きく4つの分野に分けています。
- 開発：開発フロー、デバッグの手順、Git、コーディング、ログ、テスト
- 設計：フォルダ構成、API、データベース、UI、セキュリティ、認証
- ドキュメント・AI：docsの書き方、AIツールとの付き合い方
- 運用：デプロイ、バックアップ
デザインも共通ルールに
デザインについても共通の規約を用意しました。各プロジェクトのルートにはDESIGN.mdを1つ置き、AIツールはUIをつくるときに必ずそれを参照する、という決まりです。
このホームページstudio.tmkにもDESIGN.mdがあり、配色や書体、動きのルールをそこにまとめています。
各プロジェクトでの使い方
各プロジェクトにはCLAUDE.mdやAGENTS.mdといった入口のファイルを置き、そこからprojectStandardを参照させます。プロジェクト固有のルールがあるときは、共通ルールとの違いだけを各プロジェクトのdocsに書きます。
iOSアプリ「コマログ」の開発でも、仕様を先に固めてAIに実装を任せ、自分はレビューに回る、という進め方をとりました。共通ルールがあると、AIへの指示がぶれにくくなります。
おわりに
ルールを先に渡しておくと、AIへの説明が短くて済み、仕上がりのぶれも小さくなったと感じています。新しいプロジェクトを始めるときも、迷わずに動き出せるようになりました。これからも、つまずいたところや決めたことを少しずつルールに足していくつもりです。