mino-architecture-quality-strategy

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Architecture Quality Strategy

Architecture Quality Strategy

product valueを成立させる品質portfolioを選び、責務、依存、data authority、実行・配備、移行をsystem全体で整合させる。名前付きarchitectureは目的ではなく候補手段として扱う。
从产品价值(product value)出发选择能支撑其落地的质量组合(quality portfolio),在系统层面统一职责、依赖关系、数据权限(data authority)、执行与部署、迁移策略。命名架构(named architecture)仅作为候选手段而非目标。

Outcome Contract

Outcome Contract

主成果物として
Architecture Strategy Package
を作る。通常は次の最小構成を返し、詳細schemaはworkflow referenceへ置く。
  • actor、product value、decision scope、horizon、capabilityと投資仮説
  • business capability / subdomainだけを対象にしたcore / supporting / genericの仮分類
  • primary / secondary / constraint / intentionally-not-optimizedの品質portfolioと観測可能なscenario
  • current finding、do-minimumを含むoption、trade-off、cost、risk、reversibility
  • 選択済みtargetのresponsibility、dependency、source of truth、authority
  • ADRとtransition phase、compatibility、migration、recovery、abort、old path removal
  • temporary pathごとのowner、導入日、目的、観測、削除条件、削除phase
  • value → quality scenario → current finding → option → target → transition → validationのtrace
  • subject_verdict: coherent | conditional | incomplete | indeterminate
    とcanonical
    decision
  • platformがtarget / transition / recoveryを分岐させる場合だけ、platform別scenarioとvalidation matrix
未決のpriority、quality priority、reversibility、target authorityはSelection Gateへ隔離し、選択済みtargetとして表現しない。
核心交付物为
Architecture Strategy Package
。通常返回以下最小组成,详细 schema 请参考工作流文档(workflow reference)。
  • 参与者(actor)、产品价值、决策范围、时间跨度(horizon)、能力(capability)及投资假设
  • 仅针对业务能力(business capability)/子域(subdomain)进行核心/支撑/通用的临时分类
  • 主/次/约束/非刻意优化的质量组合及可观测场景
  • 当前发现、含最小可行方案(do-minimum)的选项、权衡、成本、风险、可逆性
  • 已选定目标的职责、依赖关系、数据源(source of truth)、权限
  • 架构决策记录(ADR)及过渡阶段、兼容性、迁移、恢复、中止、旧路径移除方案
  • 每条临时路径的负责人、引入日期、目的、观测指标、移除条件、移除阶段
  • 从价值→质量场景→当前发现→选项→目标→过渡→验证的可追溯链路
  • subject_verdict: coherent | conditional | incomplete | indeterminate
    及标准决策(canonical
    decision
  • 仅当平台需区分目标/过渡/恢复流程时,提供平台专属场景及验证矩阵
未确定的优先级、质量优先级、可逆性、目标权限需隔离至选择网关(Selection Gate),不得作为已选定目标呈现。

Reference Routing

Reference Routing

  • 内部pathは、配置先にかかわらず、インストールされた
    skills/
    directoryを参照rootとして解決する。
  • 最初に
    skills/mino-core/references/core.md
    skills/mino-core/references/shared-policies.md
    skills/mino-core/references/requirements-and-traceability.md
    を読み、共通gateを再定義しない。
  • portfolio、option、ADR、target / transition、validationでは
    skills/mino-architecture-quality-strategy/references/workflow.md
    を読む。
  • context boundaryとdomain visionの発見が必要なときだけ
    skills/mino-core/references/domain-discovery.md
    を読む。
  • 既存systemの段階移行では
    skills/mino-core/references/change-safety.md
    を読む。
  • deployment、filesystem、process、operation、migrationのplatform差が判断を分岐させるときだけ
    skills/mino-core/references/platform-compatibility.md
    を読む。
  • standalone依頼でmodel、contract、consumer boundaryの詳細が必要な場合は、必要な範囲だけ
    $mino-domain-model-completeness
    $mino-design-by-contract
    $mino-interface-implementation-separation
    へscoped artifactを依頼し、返却IDを参照する。
  • standalone依頼が複数成果物と実装まで求める場合は
    $mino-reproducible-development
    へ一度hand offする。
  • routerまたはpeer Skillからscoped artifactを依頼された場合は再routingせず、Architecture Strategy Packageと未解決obligationだけをcallerへ返す。
  • quality normalization、ADR、target / transition schemaはsuite operationalizationとして扱う。
  • 内部路径无论部署位置,均以已安装的
    skills/
    目录作为根目录解析。
  • 首先阅读
    skills/mino-core/references/core.md
    skills/mino-core/references/shared-policies.md
    skills/mino-core/references/requirements-and-traceability.md
    ,不得重新定义通用网关。
  • 质量组合、选项、ADR、目标/过渡、验证环节需阅读
    skills/mino-architecture-quality-strategy/references/workflow.md
  • 仅当需要发现上下文边界(context boundary)及领域愿景(domain vision)时,阅读
    skills/mino-core/references/domain-discovery.md
  • 现有系统阶段迁移需阅读
    skills/mino-core/references/change-safety.md
  • 仅当部署、文件系统、流程、操作、迁移的平台差异会影响决策时,阅读
    skills/mino-core/references/platform-compatibility.md
  • 独立请求中若需模型、契约、消费者边界的详细内容,仅在必要范围内向
    $mino-domain-model-completeness
    $mino-design-by-contract
    $mino-interface-implementation-separation
    请求限定范围的工件(scoped artifact),并引用返回ID。
  • 若独立请求要求交付多份工件及实现内容,需先转交至
    $mino-reproducible-development
    处理。
  • 若路由或同级Skill请求限定范围的工件,不得重新路由,仅向调用方返回Architecture Strategy Package及未解决义务。
  • 质量标准化、ADR、目标/过渡 schema 需作为套件可操作性(suite operationalization)处理。

Authority Boundary

Authority Boundary

  • このSkillの成果物がsystem-wideなproduct value、quality portfolio、responsibility / data authority、target / transition decisionのcanonical recordを保持する。valueとpriorityの承認は権限を持つ人間が所有する。
  • use-case modelの完全性、condition単位の契約、consumer operation boundaryを二重に確定しない。必要な専門成果物のIDを参照する。
  • target authorityを選択できない場合は候補とSelection Gateを返し、local Skillの判断で確定しない。
  • 本Skill的交付物为系统级产品价值、质量组合、职责/数据权限、目标/过渡决策的标准记录(canonical record)。价值与优先级的审批权限归指定人员所有。
  • 不得重复确认用例模型的完整性、基于条件的契约、消费者操作边界。需引用必要专业交付物的ID。
  • 若无法选定目标权限,需返回候选方案及选择网关,不得由本地Skill自行确定。

Workflow

Workflow

  1. actor、value、decision owner、scope、horizon、target platformを確認し、Evidence状態とdecision maturityを記録する。
  2. capability kindを
    business_capability | subdomain | technical_capability | unknown
    へ判定する。core / supporting / genericはbusiness capability / subdomainだけへ適用する。
  3. 価値を損なう失敗、roadmap、必要品質から品質portfolioとscenarioを作る。
  4. current architectureをlocal、system、journey、organization、future changeで評価する。
  5. debtを症状 → 品質 → owner → 構造原因で説明し、business criticality、expected change、debt impact、failure risk、remediation costで比較する。
  6. current / do-minimumを含むoptionの品質、cost、risk、reversibilityを比較する。
  7. 選択済みtargetだけに一意なsource of truth、authority、dependencyを割り当てる。人間判断待ちはconditional designにする。
  8. ADRと、deploy order、exit criteria、irreversible point、abort、rollback / forward recovery、旧path削除を持つtransition phaseを設計する。
  9. valueからvalidationまでIDでtraceし、scenarioを実行・simulationするか、oracle、owner、実行条件のある未実行planを残す。
  1. 确认参与者、价值、决策负责人、范围、时间跨度、目标平台,记录证据状态及决策成熟度。
  2. 将能力类型判定为
    business_capability | subdomain | technical_capability | unknown
    。核心/支撑/通用分类仅适用于业务能力/子域。
  3. 基于价值损失风险、路线图、必要质量要求制定质量组合及场景。
  4. 从局部、系统、流程、组织、未来变更维度评估当前架构。
  5. 按症状→质量→负责人→结构原因说明技术债务(debt),并按业务关键性、预期变更、债务影响、失败风险、修复成本进行比较。
  6. 对比含当前/最小可行方案的选项的质量、成本、风险、可逆性。
  7. 仅为已选定目标分配唯一数据源、权限、依赖关系。需人工判断的内容标记为条件设计(conditional design)。
  8. 设计架构决策记录(ADR)及包含部署顺序、退出标准、不可逆点、中止、回滚/向前恢复、旧路径移除的过渡阶段。
  9. 用ID建立从价值到验证的追溯链路,执行或模拟场景,或保留含验证方(oracle)、负责人、执行条件的未执行计划。

Platform Compatibility

Platform Compatibility

  • platformをdeployment environmentと品質scenarioの一部として扱い、OS名自体をarchitecture目的にしない。
  • case sensitivity、permission、file lock、process終了、container / WSL境界の差は、品質や移行判断を分岐させる場合だけoption比較へ含める。
  • 複数platform対応がrequiredなら、target / transition / recoveryをplatform別に検証し、一部の結果で全体をpassにしない。
  • 将平台作为部署环境及质量场景的一部分,不得将OS名称本身作为架构目标。
  • 仅当大小写敏感性、权限、文件锁、进程终止、容器/WSL边界差异会影响质量或迁移决策时,才纳入选项对比。
  • 若需支持多平台,需针对各平台分别验证目标/过渡/恢复流程,不得因部分平台通过而判定整体通过。

Hard Gates

Hard Gates

以下のいずれかに該当する場合はtargetを確定せず、
conditional | incomplete | indeterminate
の該当状態としてSelection Gate、反証Evidence、残存riskを返す。
  • named architectureやtechnologyが目的になっている。
  • technical capabilityへcore / supporting / genericを付けている。kind自体がunknownならclassificationもunknownにし、確認方法と影響を残す。
  • coreでないcapabilityに架空のunique valueやdomain visionを作っている。
    not_applicable
    はvalue-preservation / risk statement、理由、Evidenceがある場合だけ許す。
  • core domain以外のsecurity、legal、accounting等の必要品質を落としている。
  • 選択済みtargetに複数のsource of truth / authorityがある、またはconditional候補に選択gate・Evidence取得方法がないまま選択済みと表現している。
  • unknownなclassification、priority、quality priority、reversibility、irreversible point、approval、recovery strategyをAI判断で確定している。
  • transitionの複数writerに期限、reconciliation、conflict rule、removal conditionがない。
  • required platformのoperation / recovery scenarioが未定義または未実行なのに、platform parityをverifiedとしている。
  • architecture traceがvalue、quality scenario、current finding、option、target decision、transition phase、validationを接続していない。
  • debt priorityでbusiness criticality、expected change、debt impact、failure risk、remediation costをEvidence付きで比較せず、根拠のない数値scoreまたはAIだけで最終順位を決めている。priority owner recordのstatus、value、resolution_or_reason、evidenceを落としている。
  • validation planをexecuted / passedと表現している。oracle、owner、実行条件が揃うdesign artifactのreadyと、engineering statusのplannedを混同している。
  • AIがvalue、quality priority、trade-offの承認、irreversible decisionを確定している。
若出现以下任一情况,不得确定目标,需返回对应状态
conditional | incomplete | indeterminate
、选择网关、反证证据、剩余风险。
  • 将命名架构或技术作为目标。
  • 为技术能力标记核心/支撑/通用分类。若能力类型本身为unknown,则分类也为unknown,并保留确认方法及影响说明。
  • 为非核心能力虚构独特价值或领域愿景。仅当有价值保留/风险声明、理由及证据时,允许标记为
    not_applicable
  • 降低核心领域以外的安全、法律、财务等必要质量要求。
  • 已选定目标存在多个数据源/权限,或条件候选方案未明确选择网关及证据获取方法却标记为已选定。
  • 通过AI判断确定未知的分类、优先级、质量优先级、可逆性、不可逆点、审批、恢复策略。
  • 过渡环节的多位编写者未明确期限、协调规则、冲突解决规则、移除条件。
  • 所需平台的操作/恢复场景未定义或未执行,却标记平台兼容性已验证(verified)。
  • 架构追溯链路未连接价值、质量场景、当前发现、选项、目标决策、过渡阶段、验证环节。
  • 技术债务优先级未结合业务关键性、预期变更、债务影响、失败风险、修复成本及证据进行比较,仅通过无依据的数值评分或AI确定最终排名。遗漏优先级负责人记录的状态、价值、解决方式/理由、证据。
  • 将验证计划标记为已执行/已通过。混淆设计工件就绪状态(含验证方、负责人、执行条件)与工程状态(planned)。
  • AI确定了价值、质量优先级、权衡的审批及不可逆决策。

Completion

Completion

  • portfolioとinvestmentがproduct value、expected change、failure riskへ接続される。
  • option比較にcurrent / do-minimum、trade-off、cost、reversibilityがある。
  • capability、option、target decision、transition phase、validationがID、Evidence、ownerを持ち、空欄でなく意味契約を記録する。
  • current findingのpriorityが5 factor、debt impactの影響説明、比較理由、人間owner recordへ追跡できる。ownerがunknownなら解決方法または未確定理由とEvidenceがある。
  • targetとtransition、migration、deploy order、exit criteria、irreversible point、abort、rollback / forward recovery、old path removalがある。
  • temporary pathがある場合、各pathのowner、introduced_at、purpose、metric / log、removal condition、removal phaseがある。
  • valueからvalidationまでのtraceが
    covered | partial | missing | contradictory
    を隠さない。
  • Windows / Linux / macOS要件がある場合、platform別scenario、Evidence、未実行事項が分離される。
  • subject_verdict
    、validation result、counterevidence、再評価trigger、residual riskをcanonical readinessと分離する。
  • 质量组合及投资需与产品价值、预期变更、失败风险关联。
  • 选项对比需包含当前/最小可行方案、权衡、成本、可逆性。
  • 能力、选项、目标决策、过渡阶段、验证环节需具备ID、证据、负责人,且无空值,记录语义契约。
  • 当前发现的优先级需包含5个维度、债务影响说明、对比理由,并可追溯至人工负责人记录。若负责人未知,需提供解决方法或未确定理由及证据。
  • 具备目标及过渡、迁移、部署顺序、退出标准、不可逆点、中止、回滚/向前恢复、旧路径移除方案。
  • 若存在临时路径,需包含每条路径的负责人、引入日期、目的、指标/日志、移除条件、移除阶段。
  • 从价值到验证的追溯链路需明确标记
    covered | partial | missing | contradictory
    ,不得隐瞒。
  • 若存在Windows/Linux/macOS要求,需分离各平台的场景、证据、未执行事项。
  • subject_verdict
    、验证结果、反证证据、重新评估触发条件、剩余风险与标准就绪状态分离。