Agent Skills › Azure/agent-landing-zone › architecture-decision

architecture-decision

GitHub

用于记录可验证的AI着陆区架构决策。当涉及模块边界、身份、网络或部署拓扑等具有高反转成本的变更时，对比备选方案并评估约束，最终生成ADR文档。

infra/.github/skills/architecture-decision/SKILL.md Azure/agent-landing-zone

触发场景

需要记录架构决策评估模块边界或网络隔离变更高成本架构选择对比

安装

npx skills add Azure/agent-landing-zone --skill architecture-decision -g -y

更多选项

非标准路径

npx skills add https://github.com/Azure/agent-landing-zone/tree/main/infra/.github/skills/architecture-decision -g -y

不安装直接使用

npx skills use Azure/agent-landing-zone@architecture-decision

指定 Agent (Claude Code)

npx skills add Azure/agent-landing-zone --skill architecture-decision -a claude-code -g -y

安装 repo 全部 skill

npx skills add Azure/agent-landing-zone --all -g -y

预览 repo 内 skill

npx skills add Azure/agent-landing-zone --list

SKILL.md

Frontmatter

{
    "name": "architecture-decision",
    "description": "Conducts and records a verifiable AI Landing Zone architecture decision. Use when a choice alters module boundaries, contracts, identity, networking, deployment topology, or operation with meaningful reversal cost."
}

AI Landing Zone architecture decision

Load the relevant engineering-principles references and current Azure best-practice guidance.
Define operator outcome, constraints, affected modules and contracts, and up to five prioritized characteristics with measures.
Compare at least two viable alternatives and the option of not changing.
Evaluate identity, RBAC, network isolation, parameter compatibility, Azure limits, cost, operation, migration, consumer impact, and reversibility.
Record the decision under docs/adr/ using the ADR template.
Define fitness functions, adoption order, rollback or roll-forward, and a review trigger.

Do not turn a tool, service, or framework preference into an architecture requirement. Record a bounded investigation when evidence is missing.