理由を必ず書く
なぜその形なのかが分からない人が触ると、善意で壊されます。規約には理由を添え、理由から導き直せるようにします。
STANDARDS
判断の理由まで書いた、
設計標準を。
「そう決まっているから」で守られる規約は、必ず劣化します。当社の設計標準は、すべての規約に理由と、やり過ぎの基準と、機械で守らせる方法を書いています。その考え方で、御社の設計標準とプロジェクト推進標準の策定を支援し、開発を速くする道具を提供します。
PRINCIPLES
標準を書くときの、3 つの前提
中核の理念は一つです。疎結合。ある一点を直すために、大きな単位のルールを触らなければならない状態を作らない。すべての規約は、この理念の適用例です。
守れることは機械に守らせる
人の注意力に依存する規約は、規模が大きくなるほど守られません。独自ワーニングと品質ゲートで、違反をマージの前に止めます。
やり過ぎの基準も書く
疎結合はコストを伴います。線引きがなければ、新人は過剰設計に走り、忙しい人は密結合に倒れます。どこまでやるかを明記します。
DESIGN STANDARD
設計標準の策定と、品質ゲートへの組み込み
当社の設計標準は、原則から演繹する形で、設計・運用・応用・理論・ビューの各領域を扱っています。これを御社の業務とチームに合わせて調整し、守られる形で導入します。
扱う領域
- ルールとクラス: 制御の親子、オーケストレーションとロジックの分離、クラス階層
- ルールの契約と状態: 部品と道具の区別、パラメータの受け渡し、拡張点
- データと定数: 参照データの置き場所、フラグ設計、主キー、定数
- 書き込み経路と冪等性: 単一の原子経路、検証・ロック・コミット
- 境界と統合: OOTB のラップ、Int / Data の分離、同期と非同期
- 安定性、認可、環境とリリース、品質保証、観測可能性、非機能
- Constellation UI のビュー設計、AI・意思決定基盤
提供の形
- 御社向け設計標準の策定: 現行アプリの棚卸しから、適用の優先順位、命名規約、レビュー観点まで
- 品質ゲートへの組み込み: 独自ワーニング、PegaUnit とシナリオテスト、Deployment Manager のマージ条件
- 設計レビュー顧問: 月次で御社の設計をレビューし、標準の運用と更新を支えます
- 標準の見直し: Pega のリリースに合わせて年 2 回、新しい書き込み手段や機能の追加を確認します
標準は読むだけでは定着しません。レビューとセットで初めて機能します。そのため当社は、文書の納品だけで終わる形はお勧めせず、品質ゲートへの組み込みと、しばらくの間のレビューを一緒に提案しています。
記述の根拠は領域によって強さが異なります。実案件の経験と実測に基づく部分、構築経験と整理に基づく部分、公刊文献に基づく部分を区別して明記し、推測で書いた記述は入れていません。
DELIVERY STANDARD
プロジェクト推進標準の策定
Pega の公式方法論である Blueprint Delivered を土台に、要件・設計・品質・リリースの各段階で何を作り、誰が何を判断するかを定めます。Pega のプロジェクトが失敗する典型は、技術ではなく進め方にあります。発注側の準備、PoC の成功基準、MLP のスコープ、品質ゲート、移送の経路。これらを型にします。
- 段階ごとの成果物と判断者: 準備、要件（DCO）、設計、構築、検証、リリース、運用
- 40 種以上のドキュメントテンプレート: 要件定義書、機能一覧、画面仕様、設計書、テスト計画、リリース手順ほか
- Agile Studio を使ったスプリント運営と、ウォーターフォール型の計画フェーズの両方に対応
- 品質ゲートの設計: Compliance Score、独自ワーニング、テストカバレッジの目標値
TOOLKIT
自前の道具を持つ、ということ。
当社は「AI で作るが、AI を持ち込まない」という方針で道具を作っています。自社環境で AI を使って作り、お客様の環境に持ち込むのは、AI なしで決定論的に動くスクリプトとテンプレートだけです。規制の厳しいお客様にも、そのまま説明できる形です。
Constellation UI Kit
Constellation の画面を組むときの部品と使い方をまとめたキットです。無償で公開しています。デモとマニュアル、ダウンロードはこちらから。
Constellation UI Kit を見るドキュメントテンプレート
要件・設計・テスト・リリース・運用の各段階で使う 40 種以上のテンプレートです。研修と内製化支援のお客様に提供し、プロジェクト推進標準と対応づけて使います。
開発支援ツール
ログの解析、ルールの一括確認、環境の取り違え防止など、現場で繰り返す作業を速くする自社ツール群です。お客様のアプリに組み込まず、独立したアプリとして持ち込みます。
持ち込む道具は、お客様の成果物と混ざらないように、独立したアプリと専用のルールセットで分離し、安定したらロックします。契約では既存の知的財産の留保を明記します。この方針自体が、内製化支援でお客様に勧めている「自社資産の守り方」でもあります。
FAQ
よくあるご質問
Pega の公式ガイドラインと矛盾しませんか？
矛盾しません。公式のガードレールを前提にしたうえで、公式が判断を委ねている部分（ケースの分割、データの置き場所、連携の境界、権限の層など）に、理由つきの判断を与えるのが当社の設計標準です。実測が公式ドキュメントと食い違う場合は、日付つきで実測を優先します。
既存のアプリケーションに後から標準を入れられますか？
入れられます。まず現行アプリの設計とガードレールを棚卸しし、影響の大きい順に適用します。独自ワーニングは新規の変更から効かせ、既存部分は計画的に直します。すべてを一度に合わせる必要はありません。
ツールやテンプレートだけを購入できますか？
Constellation UI Kit は無償で公開しています。ドキュメントテンプレートと開発支援ツールは、現在は研修・内製化支援・設計レビュー顧問のお客様に提供しています。単体での提供はお問い合わせください。