mino-architecture-quality-strategy
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseArchitecture Quality Strategy
Architecture Quality Strategy
product valueを成立させる品質portfolioを選び、責務、依存、data authority、実行・配備、移行をsystem全体で整合させる。名前付きarchitectureは目的ではなく候補手段として扱う。
从产品价值(product value)出发选择能支撑其落地的质量组合(quality portfolio),在系统层面统一职责、依赖关系、数据权限(data authority)、执行与部署、迁移策略。命名架构(named architecture)仅作为候选手段而非目标。
Outcome Contract
Outcome Contract
主成果物としてを作る。通常は次の最小構成を返し、詳細schemaはworkflow referenceへ置く。
Architecture Strategy Package- 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
- とcanonical
subject_verdict: coherent | conditional | incomplete | indeterminatedecision - platformがtarget / transition / recoveryを分岐させる場合だけ、platform別scenarioとvalidation matrix
未決のpriority、quality priority、reversibility、target authorityはSelection Gateへ隔離し、選択済みtargetとして表現しない。
核心交付物为。通常返回以下最小组成,详细 schema 请参考工作流文档(workflow reference)。
Architecture Strategy Package- 参与者(actor)、产品价值、决策范围、时间跨度(horizon)、能力(capability)及投资假设
- 仅针对业务能力(business capability)/子域(subdomain)进行核心/支撑/通用的临时分类
- 主/次/约束/非刻意优化的质量组合及可观测场景
- 当前发现、含最小可行方案(do-minimum)的选项、权衡、成本、风险、可逆性
- 已选定目标的职责、依赖关系、数据源(source of truth)、权限
- 架构决策记录(ADR)及过渡阶段、兼容性、迁移、恢复、中止、旧路径移除方案
- 每条临时路径的负责人、引入日期、目的、观测指标、移除条件、移除阶段
- 从价值→质量场景→当前发现→选项→目标→过渡→验证的可追溯链路
- 及标准决策(canonical
subject_verdict: coherent | conditional | incomplete | indeterminate)decision - 仅当平台需区分目标/过渡/恢复流程时,提供平台专属场景及验证矩阵
未确定的优先级、质量优先级、可逆性、目标权限需隔离至选择网关(Selection Gate),不得作为已选定目标呈现。
Reference Routing
Reference Routing
- 内部pathは、配置先にかかわらず、インストールされたdirectoryを参照rootとして解決する。
skills/ - 最初に、
skills/mino-core/references/core.md、skills/mino-core/references/shared-policies.mdを読み、共通gateを再定義しない。skills/mino-core/references/requirements-and-traceability.md - 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へscoped artifactを依頼し、返却IDを参照する。$mino-interface-implementation-separation - standalone依頼が複数成果物と実装まで求める場合はへ一度hand offする。
$mino-reproducible-development - 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请求限定范围的工件(scoped artifact),并引用返回ID。$mino-interface-implementation-separation - 若独立请求要求交付多份工件及实现内容,需先转交至处理。
$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
- actor、value、decision owner、scope、horizon、target platformを確認し、Evidence状態とdecision maturityを記録する。
- capability kindをへ判定する。core / supporting / genericはbusiness capability / subdomainだけへ適用する。
business_capability | subdomain | technical_capability | unknown - 価値を損なう失敗、roadmap、必要品質から品質portfolioとscenarioを作る。
- current architectureをlocal、system、journey、organization、future changeで評価する。
- debtを症状 → 品質 → owner → 構造原因で説明し、business criticality、expected change、debt impact、failure risk、remediation costで比較する。
- current / do-minimumを含むoptionの品質、cost、risk、reversibilityを比較する。
- 選択済みtargetだけに一意なsource of truth、authority、dependencyを割り当てる。人間判断待ちはconditional designにする。
- ADRと、deploy order、exit criteria、irreversible point、abort、rollback / forward recovery、旧path削除を持つtransition phaseを設計する。
- valueからvalidationまでIDでtraceし、scenarioを実行・simulationするか、oracle、owner、実行条件のある未実行planを残す。
- 确认参与者、价值、决策负责人、范围、时间跨度、目标平台,记录证据状态及决策成熟度。
- 将能力类型判定为。核心/支撑/通用分类仅适用于业务能力/子域。
business_capability | subdomain | technical_capability | unknown - 基于价值损失风险、路线图、必要质量要求制定质量组合及场景。
- 从局部、系统、流程、组织、未来变更维度评估当前架构。
- 按症状→质量→负责人→结构原因说明技术债务(debt),并按业务关键性、预期变更、债务影响、失败风险、修复成本进行比较。
- 对比含当前/最小可行方案的选项的质量、成本、风险、可逆性。
- 仅为已选定目标分配唯一数据源、权限、依赖关系。需人工判断的内容标记为条件设计(conditional design)。
- 设计架构决策记录(ADR)及包含部署顺序、退出标准、不可逆点、中止、回滚/向前恢复、旧路径移除的过渡阶段。
- 用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を確定せず、の該当状態としてSelection Gate、反証Evidence、残存riskを返す。
conditional | incomplete | indeterminate- named architectureやtechnologyが目的になっている。
- technical capabilityへcore / supporting / genericを付けている。kind自体がunknownならclassificationもunknownにし、確認方法と影響を残す。
- coreでないcapabilityに架空のunique valueやdomain visionを作っている。はvalue-preservation / risk statement、理由、Evidenceがある場合だけ許す。
not_applicable - 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、未実行事項が分離される。
- 、validation result、counterevidence、再評価trigger、residual riskをcanonical readinessと分離する。
subject_verdict
- 质量组合及投资需与产品价值、预期变更、失败风险关联。
- 选项对比需包含当前/最小可行方案、权衡、成本、可逆性。
- 能力、选项、目标决策、过渡阶段、验证环节需具备ID、证据、负责人,且无空值,记录语义契约。
- 当前发现的优先级需包含5个维度、债务影响说明、对比理由,并可追溯至人工负责人记录。若负责人未知,需提供解决方法或未确定理由及证据。
- 具备目标及过渡、迁移、部署顺序、退出标准、不可逆点、中止、回滚/向前恢复、旧路径移除方案。
- 若存在临时路径,需包含每条路径的负责人、引入日期、目的、指标/日志、移除条件、移除阶段。
- 从价值到验证的追溯链路需明确标记,不得隐瞒。
covered | partial | missing | contradictory - 若存在Windows/Linux/macOS要求,需分离各平台的场景、证据、未执行事项。
- 将、验证结果、反证证据、重新评估触发条件、剩余风险与标准就绪状态分离。
subject_verdict