最近、AIを使って開発する機会がかなり増えてきました。
GitHub CopilotやClaude Code、Codexなど、便利なツールもどんどん増えています。
一人で開発するだけなら、とても便利です。
でも、チーム開発になると少し気になることがありました。
同じ機能なのに作り方が違う
例えば「ログイン機能を追加してください」とAIにお願いしたとします。
同じ内容でも、
- 人によってPromptが違う
- 使用するAIが違う
- AIの考え方も違う
その結果、
- ディレクトリ構成
- 命名規則
- 設計書
- テストコード
などがバラバラになってしまいます。
もちろんコードは動きます。
でも、プロジェクトとして見ると、少し管理しにくくなります。
AIにルールを教えるだけでは足りない？
最初は、
- Coding Rule
- Naming Rule
- Review Rule
などをInstructionとして用意すれば十分だと思っていました。
でも考えていくうちに、
「ルール」だけでは足りないことに気付きました。
例えば新しい機能を追加するとき、
要求を確認する
↓
設計を考える
↓
Mermaidを書く
↓
実装する
↓
UTを書く
↓
レビューする
↓
Playwrightで確認する（自動テスト）
↓
設計書を更新する
という流れがあります。
つまり、必要なのはCoding Ruleだけではなく、
開発全体のWorkflowでした。
AIではなく、Software Engineeringを管理したい
最近はいろいろ調べていて、Superpowers - github.comというプロジェクトも見ました。
pluguinとしていろんなAI ツールClaude Codeなどにインストールできています。
BrainstormingやWriting Plansなど、便利なSkillがたくさんあります。
これらはそのまま使えば十分だと思います。
一方で、
- Feature追加
- Bug修正
- Refactoring
などの開発フローまでは管理していません。
そこで思ったのは、
SkillはSuperpowersを使い、その上にチーム用のWorkflowを作ればいいのではないか？
ということです。
目指したいもの
今考えているのは、
AIに「コードを書かせる仕組み」ではありません。
チーム全員が、
どのAIを使っても、
同じ流れで開発できる仕組みです。
例えば、
- Feature追加
- Bug修正
- 設計変更
- Release
それぞれにWorkflowを用意して、
必要なSkillを順番に実行していくイメージです、それともHandoffも用意します。
さらに、
設計書や処理フロー図のMermaid、テストコードなども一緒に更新できれば、
コードだけではなく、プロジェクト全体を管理できるようになると思っています。