概要
アーキテクチャを曖昧なドキュメントではなく厳密なスキーマとして定義し、人間とAIが同じルールに従ってコード生成・開発を行うための仕組みと成果を紹介しています。
詳細内容
ZOZOTOWNのiOS開発における、アーキテクチャの品質維持とAI活用を両立させるための先進的な取り組みについての解説です。従来の「努力目標」としてのドキュメント管理を脱却し、コンポーネントの責務や依存関係を「スキーマ」として構造化することで、人間とAIの双方を共通のルールで制約しています。
具体的には、以下の3段階のプロセスで運用されています。
1. **定義**: `architecture-guidelines.md`で各レイヤーの命名・依存・禁止事項を定義し、テンプレートを整備する。
2. **設計**: `/architecture`コマンドを用い、Figmaや仕様書から画面設計を記述した「設計YAML」を自動生成。人間は設計判断に集中する。
3. **実装**: `/codegen`コマンドでYAMLからSwiftのボイラープレート（View, ViewModel, Repository, Test等）を一括生成する。
このアプローチにより、AIが生成するコードの品質が安定し、ハルシネーションが抑制されました。結果として、コードレビューの焦点が実装詳細からプロダクトのUXや仕様の妥当性といった「本質的な品質」へとシフトしたと報告されています。