用途:architect-pyramid 是一个“输出编排器”,面向 technical-architect(技术架构师)配置,将结构视图(C4)、决策记录(ADR)与上下文/约束文档(arc42)整合为单一的产物金字塔,供智能体消费,或作为一次性分析交付物输出到 /tmp/architect-workflow/。
主要能力:生成三层目录结构。第一层 01-summary 含 system-context.md(C4 第 1 级系统上下文)与 quality-tree.md(arc42 Canvas/质量属性);第二层 02-analysis 含 structural-views/container.md 与 components.md(C4 第 2、3 级)、architecture-decisions/ADR-001.md 等活跃 ADR(每条决策一个文件)、constraints-and-context.md(arc42 第 1—2 节)与 solution-strategy.md(arc42 第 4 节);第三层 03-dossiers 含 code-level-detail.md(C4 第 4 级)、adr-superseded.md(已取代的 ADR)与 arc42-supplemental.md(arc42 第 5—12 节)。
交叉引用规则:C4 视图引用 ADR,容器与组件图链接到解释其结构的 ADR;ADR 引用 arc42 约束,决策日志链接到驱动该决策的质量属性或约束;arc42 约束引用 C4 视图,约束条目链接到体现该约束的图。每层设 SOURCES 段,使用绝对路径加描述,而非脚注。ADR 生命周期意识:C4 视图仅将 accepted 状态的 ADR 视为权威,指向 proposed ADR 的链接标记为 tentative;ADR 被取代后 C4 视图须重新链接到替代件,完整生命周期表见 references/dimension-boundaries.md。
使用方式:当场景为智能体驱动分析、单次交付且无 Docker 时,采用产物金字塔;团队需在仓库中长期维护文档并本地预览时,采用 AaC 约定(Structurizr + arc42 + adr-tools 结构)。混合情形可先产出金字塔,团队采纳后再迁移到 AaC 结构。交付约定为向调用方返回 00-index.md 的绝对路径,例如 metadata={"artifact": "/tmp/architect-workflow/<slug>/00-index.md"},而非摘要或自然语言移交。
适用场景与限制:适合智能体驱动的架构分析、一次性架构交付物或金字塔先行再迁移的混合流程。资料未提供安装命令、收费、价格与具体平台支持信息;Docker 预览与 CI 发布属于 AaC 约定的内容,金字塔本身不依赖工具。