VCDesign IDG RP BOA VCD Library

Library

For AI: library.yaml

VCDesign エコシステムの「衛星リポジトリ」を境界ごとに固定するための索引です。
読むためではなく、参照先(責任の所在)を決めるために使用します。

Index of satellite repositories. Not meant to be read sequentially, but to fix boundaries and show where each responsibility lives.

1. VCDesign Core & Architecture

不変の哲学(VCDesign)から、具体的な実装(IDG)までの階層構造。

PHILOSOPHY (WHY)

vcdesign-core

何を「価値」として守るか
技術選定の前に決めるべき、不変の定義と責任境界。
Defines what to protect (Value, Responsibility, Provenance).

↓ Implements
ARCHITECTURE (WHERE)

boa-core

どこで守るか(Boundary Oriented Architecture)
曖昧な「解釈」がシステムを汚染しないための、境界構築メソッド。
Defines where to protect it (Boundaries, Meanings, Resolutions).

↓ Enforces
COMPONENT (HOW)

interface-determinability-gate (IDG)

どうやって守るか(具体的なゲート実装)
責任なきデータをシステムに入れないための、決定可能性ゲートの実装例。
Defines how to protect it (The Gate implementation).

References & Resources:
  • vcdesign-origins Primary sources / 歴史的アンカー
    解釈が入る前の一次情報をそのまま保存している場所。すべての議論の原点。
    Preserve origins as-is. No interpretations, no conclusions added.
  • idg-boundary-patterns (Profiles) Boundary Lenses / 境界レンズ集
    曖昧性が発生しやすいポイントをパターン化したもの。(Moved to IDG repository)
    Catalog of boundary lenses. Identify where ambiguity tends to emerge when deploying IDG.

2. Tools & Governance

vcdlint

CI / Linter

「良い設計か」ではなく「必要な手続きが抜けていないか」を機械的にチェックするツール。
公式/共有の境界をまたぐ際に、責任者(Resolution)の定義がない等のガバナンス違反をCIで落とします。
Mechanically check for missing required procedures (not design quality). Fail CI on governance violations.

Focus: Governance CI

Predictability Gate

Operation Gate

AIモデルを作る前に「そもそもこの判断をAIに委譲してよいか」を決めるための意思決定ゲート。
予測精度云々の前に、外したときの影響が取り返しがつかない領域(不可逆性)を排除します。
Pre-model decision gate: determine if this judgment can be delegated to AI, considering irreversibility.

Focus: Pre-model safety

3. Factory IoT & Field Patterns

Factory Data Storage Notes

Storage

「どこに保存するか」は技術選定ではなく責務の割り当てである、という視点のメモ。
データがどの時点で「確定(不可逆)」するのかを見極め、適切な置き場所を決めるための指針です。
'Where to store' is responsibility assignment, not tech selection. Identify irreversible commitment points.

Factory Data Shapes

Contract

Edge(発生)→Bus(輸送)→DB(蓄積)→BI(活用) という長いフローの中で、データの形(Shape)をどう固定するか。
意味の揺れを防ぐためのカタログと命名規則の実例。
Fix data Shape across the Edge→Bus→DB→BI flow to prevent semantic drift.

DB Layer Design Principles

Principles

データベースに何を期待し、何を期待してはいけないか。
「万能なDB」を作ろうとして失敗しないために、DB層が引き受けるべき責務を原理原則で切り分けます。
Separate DB layer responsibilities by principle to avoid building (and failing at) an omnipotent database.

OT-IT Async Design Appendix

Async

同期通信(API呼び出し)前提のITシステムを、非同期な現場(OT)に持ち込むと破綻します。
時間軸のズレと思想の衝突を前提とした、非同期ファーストな設計パターン集。
Don't impose sync-first IT on async OT field. Design patterns for temporal misalignment and philosophical conflicts.

Edge Semantics Template

Template

現場(Edge)で発生したデータを、意味付けしてから中央に送るための実装テンプレート。
生の数値ではなく「意味」を扱うことで、後工程での誤読リスクを減らします。
Implementation template for tagging raw Edge data with semantics before sending to central. Prevents downstream misreading.