AI支援設計計測プラットフォーム

AIと決定的な解析器を組み合わせて、設計品質を証拠ベースで計測するための docs-first リポジトリです。現時点ではドメイン設計評価を最初の評価領域として扱い、将来的にはアーキテクチャ設計、運用設計、セキュリティ設計などへ拡張できる前提で文書を整理しています。

読み始め

1. docs/overview/platform-vision.md
2. docs/guides/user-guide.md
3. docs/platform/measurement-model.md
4. docs/domains/domain-design.md
5. docs/domains/architecture-design.md
6. docs/domains/architecture-scenario-model.md
7. docs/roadmap/phased-delivery.md

文書構成

• docs/README.md: 文書全体の索引
• docs/guides/user-guide.md: 初回利用者向けの最短ガイド
• docs/overview/platform-vision.md: プラットフォーム全体のVisionと対象範囲
• docs/platform/measurement-model.md: 共通計測モデルと評価領域拡張の前提
• docs/platform/runtime-and-commands.md: 実行パイプラインとコマンド体系
• docs/platform/analysis-mechanism.md: current implementation の解析経路と metric 反映の追跡ガイド
• docs/platform/data-model.md: 標準データモデルと出力契約
• docs/domains/domain-design.md: ドメイン設計評価の詳細仕様
• docs/domains/architecture-design.md: APSI を中核にしたアーキテクチャ設計評価の本体仕様
• docs/domains/architecture-scenario-model.md: quality scenario の入力仕様
• docs/domains/architecture-pattern-profiles.md: pattern family ごとの重点と利得 / 税
• docs/domains/architecture-evidence-lifecycle.md: greenfield / brownfield の evidence 切替
• docs/domains/architecture-metric-mapping.md: APSI モデルと current implementation の対応表
• docs/operations/policy-and-ci.md: ポリシー設定、CI、レビュー運用
• docs/operations/architecture-source-collectors.md: source config と reference collector の接続例
• docs/roadmap/phased-delivery.md: 段階的導入計画

中核原則

• AIは採点者ではなく、証拠抽出器と曖昧性整理器として使う
• スコアは固定式と決定的解析で算出する
• すべての指標に evidence confidence unknowns provenance を付ける
• 組織横断の絶対評価より、候補比較と時系列比較を重視する
• 評価領域ごとの違いは、共通基盤の上に載る拡張パックとして扱う

実装状況

• CLI中心の TypeScript / Node 実装を追加済み
• Phase 1 相当として、依存解析、境界漏れ検出、進化局所性、スコア計算、レポート、ゲート判定を実装済み
• Phase 2 の入口として、doc.extract_* の external CLI extractor、trace.* の証拠付きリンク生成、review.resolve の review log 化を追加済み
• 将来拡張向けに domain_design と architecture_design の pack 境界を追加済み

クイックスタート

最初に CLI の使い方を追いたい場合は、docs/guides/user-guide.md を先に読むと、セットアップから代表コマンドまでをまとめて確認できます。

npm install
npm run build
node dist/src/cli.js --help

ドメイン設計スコアの計測例

node dist/src/cli.js score.compute \
  --domain domain_design \
  --repo fixtures/domain-design/sample-repo \
  --model fixtures/domain-design/model.yaml \
  --policy fixtures/policies/default.yaml

アーキテクチャ依存方向の計測例

node dist/src/cli.js score.compute \
  --domain architecture_design \
  --repo fixtures/architecture/sample-repo \
  --constraints fixtures/architecture/constraints.yaml \
  --policy fixtures/policies/default.yaml

source config を使った brownfield evidence の取り込み例

node dist/src/cli.js score.compute \
  --domain architecture_design \
  --repo fixtures/validation/scoring/qsf/repo \
  --constraints fixtures/validation/scoring/qsf/constraints.yaml \
  --policy fixtures/policies/default.yaml \
  --scenario-catalog fixtures/validation/scoring/qsf/scenarios.yaml \
  --scenario-observation-source fixtures/examples/architecture-sources/scenario-observation-source.command.yaml \
  --telemetry-source fixtures/examples/architecture-sources/telemetry-source.command.yaml \
  --telemetry-normalization-profile fixtures/validation/scoring/oas/raw-normalization-profile.yaml \
  --complexity-source fixtures/examples/architecture-sources/complexity-source.command.yaml \
  --profile layered

collector と source config の詳細は docs/operations/architecture-source-collectors.md にまとめています。

Codex CLI を使った用語抽出例

node dist/src/cli.js doc.extract_glossary \
  --docs-root docs \
  --extractor cli \
  --provider codex

Review log を適用した再抽出例

node dist/src/cli.js doc.extract_glossary \
  --docs-root docs \
  --extractor cli \
  --provider claude \
  --review-log path/to/review-log.json \
  --apply-review-log

このプロジェクト自身を計測する

自己計測用の最小定義は config/self-measurement/domain-model.yaml と config/self-measurement/architecture-constraints.yaml に置いています。

1. Git 履歴を有効化する

ELS は Git 履歴を参照するため、未初期化の環境では warning と低 confidence になります。ローカルでまだ Git を初期化していない場合は次を実行します。

git init
git add .
git -c user.name="Context Probe" -c user.email="context-probe@example.com" commit -m "chore: initialize context-probe"

2. ドメイン設計スコアを出す

node dist/src/cli.js score.compute \
  --domain domain_design \
  --repo . \
  --model config/self-measurement/domain-model.yaml \
  --policy fixtures/policies/default.yaml

3. アーキテクチャ設計スコアを出す

node dist/src/cli.js score.compute \
  --domain architecture_design \
  --repo . \
  --constraints config/self-measurement/architecture-constraints.yaml \
  --policy fixtures/policies/default.yaml

4. Markdown レポートを生成する

node dist/src/cli.js report.generate \
  --domain domain_design \
  --repo . \
  --model config/self-measurement/domain-model.yaml \
  --policy fixtures/policies/default.yaml \
  --format md

検証

npm run check
npm test

npm test には fixtures/validation/extraction/ の curated golden corpus を使った抽出品質検証も含まれます。ここでは doc.extract_* trace.link_terms review.list_unknowns を既存CLIのまま叩き、must_include must_exclude must_link_to_code max_review_items で回帰を検知します。