マカルーデジタルでは、Concrete CMSの日本有数の専門企業として、既存の Concrete CMS サイトの保守引き継ぎのご相談を多くいただいています。
前任のベンダー様の事情により保守が継続できなくなった場合でも、オープンソースであるConcrete CMSはメンテナーの変更が可能です。これは大きなメリットの一つです。
一方で、引き継ぎ時には避けて通れない工程があります。
それが、既存カスタマイズの把握です。
Concrete CMSの保守を引き継ぐ際には、テンプレート、ブロック、パッケージ、イベント、オーバーライドなど、どこまで手が入っているかを確認する必要があります。しかしこの作業は、どうしてもエンジニアの経験と読解力に依存しやすく、一定の工数がかかります。
これまでも調査費用はいただいていましたが、実際にはその費用以上に工数がかかるケースも少なくありませんでした。
そこで今回、私たちは AIエージェント向けの社内スキル を開発し、エンジニアとAIが役割分担しながら、より適正な工数で、より明確な確認を行える仕組みを整えました。
スキルで何ができるのか
今回開発したスキルは、Concrete CMSプロジェクトに対して、保守引き継ぎ時に確認したいポイントを整理しながらレポート化するものです。
主に次のような内容を確認できます。
カスタマイズの全体像を把握する
- 独自ブロックや独自機能の有無
- ブロックテンプレートやページテンプレートの追加状況
- コアに対するオーバーライドの有無
- パッケージや application 配下のカスタマイズ状況
- イベントや bootstrap など、振る舞いに影響する処理の追加
このような情報を、コードベースを横断しながら一定の観点で整理し、プロジェクトのカスタマイズ概要としてまとめられるのが特徴です。
引き継ぎ時のリスクを見つけやすくする
保守引き継ぎで重要なのは、単に「何があるか」を知るだけではありません。
実際には、どこが将来的なリスクになりそうか を早い段階で把握することが重要です。
たとえば、
- コアクラスの強いオーバーライドがある
- アップデート時に影響を受けやすい実装がある
- 挙動の起点が分かりにくいイベント処理が追加されている
といった点は、引き継ぎ後の保守性や改修難易度に直結します。
スキルを使うことで、こうしたポイントを一覧化し、エンジニアが優先的に確認すべき箇所を絞り込みやすくなります。
エンジニアとAIが役割分担できる
この取り組みで重視しているのは、AIにすべてを任せることではありません。
AIが全体の洗い出しや整理を担い、最終的な技術判断はエンジニアが行う、という役割分担です。
- AI:コードベース全体の調査、観点ごとの整理、レポート下書き
- エンジニア:妥当性確認、個別実装の読解、見積・提案への落とし込み
この分担により、抜け漏れを減らしながら、必要な箇所にはしっかり人手をかける運用がしやすくなりました。
実際の使い方
使い方は非常にシンプルです。
担当者がAIエージェントに対して、「このプロジェクトのカスタマイズの概要を出してください」 と依頼するだけです。
すると、スキルが社内で定義した観点に沿ってプロジェクトを確認し、保守引き継ぎ時に把握しておきたい情報を整理して返します。
つまり、複雑な操作や特別なコマンドを覚える必要はありません。
現場では、まずAIに概要を出させ、その結果をもとにエンジニアが深掘りする、という流れで活用できます。
この「最初の全体把握」を素早く行えることが、実務上かなり大きな意味を持っています。
実際の出力イメージ(簡略版)
実際にスキルが生成するレポート(overrides.md)は、以下のような形式になります。
※実案件の内容が分からないように簡略化しています。
