tierward

Tierward

Claude 负责生成。由你或你的团队做决定。 一个开发框架，为 Claude Code 提供受治理的分阶段流程，让你从第一天起就能稳定、可审查地构建真正的软件。 原生支持 MCP：可通过 Claude Desktop、ChatGPT、Cursor、VS Code 读取 Tierward 治理状态。

Claude Code 速度很快。它带来的问题不在代码，而在审查。当 AI 自主编写所有内容时，你最终会批准自己并未完全理解的差异，直到后面几个代码块才发现回归问题，还会逐渐弄不清系统实际做了什么。

Tierward 介于 Claude 和完成之间。团队可以逐级采用，从零流程的探索配置，逐步升级到完全受治理的流水线：实现前设置明确的 STOP 检查点，通过审计技能在问题进入生产环境前将其发现；还有一个 Stop 钩子，会在 Claude 表示完成时运行测试，并在测试失败时让它返回修复。从 Tier 0 开始，需要更多结构时再逐步升级。

自 v1.17.0 起，Tierward 除 CLI 外还附带 MCP 服务。任何支持 MCP 的客户端都可以读取项目的 doctor 报告、team-settings 策略、最近一次 arch-audit 和技能清单，无需运行 Tierward CLI。请参阅 MCP 服务。

---

理念

Tierward 的核心理念很简单：Claude Code 并不会因为能力减弱而变得更难协作，而是因为自主决策的积累速度超过了任何人的审查速度，才变得更难协作。流水线通过一份审查约定来约束流程：先确认范围，再编写代码；先写出假设，再修复问题；测试通过后才能结束。对于不需要这种结构的工作，它不会拖慢进度。

设置分层体系是因为流程需要付出成本。一个人的 Bug 修复不应该承担团队功能工作流的额外开销。两种流水线覆盖不同需求：Fast Lane（4 个步骤，确认范围）适用于快速修复；Full（14 个阶段，4 个审查关卡）适用于团队功能。两者都遵守相同的约定：Claude 按阶段推进工作，团队逐步审批每个步骤。从符合当前风险的层级开始，随着风险加大再添加更多流程。

Tierward 为承担结果的每个人打造，无论是产品经理还是开发者，让决策权留在他们手中，而不是交给模型。

Claude Code 优先，这是有意设计的

Tierward 仅适用于 Claude Code。不支持 Cursor，没有 Copilot 层，也没有多工具抽象。这是有意为之。

让 Tierward 发挥作用的强制机制都是 Claude Code 原语：Stop hook 是 settings.json 中的硬性操作系统级拦截；STOP gate 位于 pipeline.md 中，这是 Claude 在会话开始时读取的规则文件；审计技能则是在 Claude Code Agent 循环中运行的结构化程序。这些概念无法通过抽象层封装后移植。它们是对 Claude Code 架构的直接调用。

要支持多种工具，就得把这些机制替换为最低公分母抽象，从而剥离强制执行层。Tierward 的价值恰恰在于这种强制执行：Stop hook 不会要求 Claude 运行测试，而是阻止 Claude 完成任务，直到测试通过。

如果你的团队除了 Claude Code 还使用其他 AI 编码工具，Tierward 只管理 Claude Code 会话。底层原则（完成前先测试、编码前先明确需求、部署前先审计）并非 Claude 专属，但实现方式是 Claude 专属的，这是我们有意做出的选择。

---

工作原理

1. 一次搭建。 npx tierward init 会检测你的项目类型，并根据技术栈和团队规模搭建工作流、审计技能、安全规则和治理文件。设置不到两分钟即可完成。

2. 按照工作流开展工作。 工作流是 Claude 在会话开始时读取的规则文件。对于 Tier M：实现前扫描依赖，明确需求后设置 STOP gate，编写代码后运行 /simplify。你无需手动管理，就能获得相应的结构。

3. 按需运行审计技能。 /security-audit、/arch-audit 和 /systematic-debugging 等技能是在 Claude Code 中运行的多步骤程序。在需要时调用它们：部署前、测试失败时或完成一次迁移后。每项技能都会生成结构化报告。

4. 由你或团队做决定。 STOP gate 会暂停 Claude 并展示其计划；提交 gate 会在你批准前阻止执行 git commit。在支持代码所有者的 GitHub 套餐中，CODEOWNERS 会将对 .claude/ 的更改提交给人工审核者；如果分支保护要求由代码所有者审核，也会阻止合并。Stop hook 还会在任务关闭前验证测试是否通过。不进行自主合并。

---

快速开始

npx tierward init

向导会检测你的项目状态并引导你完成设置。提供三种路径：

路径	适用场景
现有项目	为已有代码的项目添加结构
新项目	从头开始
基于现有文档	分享代码库或文档，Claude 会读取并填充所有内容

初始化后，打开 Claude Code 并开始工作。脚手架会立即生效。

上下文构建器（v1.27.0）

如果你希望脚手架能够一致地还原，并以书面形式记录你的要求，请在 init 之前运行 context：

npx tierward context                       # produces CONTEXT.md
npx tierward init                          # reads CONTEXT.md, scaffolds with no further prompts
npx tierward context --all                 # one-shot: context then init
npx tierward context --from-yaml file.md   # bypass interview, validate + copy
npx tierward validate-context              # CI gate: exit 0/1 on schema check

CONTEXT.md 是经过架构验证的项目上下文文件。全新项目会进行一次适合项目经理的访谈。现有代码库会经过三阶段推断：算法检测、LLM 提取、混合式项目经理审核。第一个问题会将你引导至项目经理流程或开发者流程。开发者流程会复用旧版 init 向导中的技术问题（projectName、stack、commands、scaffold options），并根据团队规模和工作范围自动推导 tier.rationale，因此开发者无需撰写项目管理方面的理由说明。

从 v1.27.0 开始，架构涵盖全部四个工作流层级：适用于个人或 Bug 修复任务的 tier 0（发现）和 tier S（快速通道）；适用于功能模块工作的 tier M（标准），包含功能开关（has_api、has_database、has_frontend、has_design_system、has_prd）；以及适用于复杂领域项目的 tier L（完整）。

---

功能说明

一份契约，覆盖四个等级。无论是独自修复 bug，还是由团队全面治理的流水线，规则都相同：Claude 提议，团队审批。

按风险匹配的分级流水线

等级	流水线	适用场景
0 - 探索	仅停止钩子	初次探索——零流程
S - 快速通道	4 个步骤，确认范围	单人开发者、低风险、快速修复
M - 标准	13 个阶段、3 个 STOP 关卡	功能模块、1-2 位协作者
L - 完整	14 个阶段、4 个 STOP 关卡	团队项目、复杂的领域变更

从等级 0 开始。需要更完善的结构时，通过提高等级重新运行 init（方法）。

向导还会询问变更如何进入 main：通过 staging 分支（Web 技术栈的默认方式）、通过本地直接合并 direct（原生应用的默认方式），或通过拉取请求 pr（不使用 staging 分支，也不推送到 main）（晋升模式）。

27 个审计技能

在 Claude Code 中运行的可执行多步骤程序，而非提示词指令。它们是结构化的审计工作流，并会根据任务路由模型（机械检查使用 haiku，分析使用 sonnet）。

• 所有等级（8 个）： /arch-audit、/security-audit、/perf-audit、/skill-dev、/simplify、/commit、/skill-security、/systematic-debugging
• M 和 L 级另有 18 个： /api-design、/skill-db、/migration-audit、/visual-audit、/ux-audit、/responsive-audit、/ui-audit、/accessibility-audit、/test-audit、/doc-audit、/api-contract-audit、/infra-audit、/compliance-audit、/dependency-audit、/pr-review、/skill-review、/dependency-scan、/repo-hygiene
• L 级另有 1 个： /context-review

技能会根据项目有条件地安装：hasApi、hasDatabase、hasFrontend、hasDesignSystem。各技能的功能、安装条件及所需内容：审计技能。

自动检测 11 种技术栈

Node.js/TS、Node.js/JS、Python、Go、Swift、Kotlin、Rust、.NET、Ruby、Java，以及通用备用方案。安全规则、权限和 CLAUDE.md 字段都会自动适配。

MCP 服务（v1.17.0+）

tierward 软件包除了 CLI，还提供 MCP 服务（tierward-mcp 二进制文件），版本锁定，只需执行一次 npm install -g。任何支持 MCP 的客户端（Claude Desktop、ChatGPT desktop、Cursor、VS Code、Copilot Studio）都可以在不运行 Tierward CLI 的情况下查询 Tierward 治理状态。六个只读工具涵盖 doctor 报告、team-settings、最近一次 arch-audit、技能清单、软件包元数据和 /pr-review 评论。完整参考请见下方的 MCP 服务部分。

Tierward 也是一个 Claude Code 插件（v1.32.0+），通过此代码库中的插件市场分发。该插件为 Claude Code 添加 8 个治理技能：commit、arch-audit、security-audit、perf-audit、simplify、skill-dev、skill-security 和 humanize。它不包含 MCP 服务，如需使用，请安装 npm 软件包。在 Claude Code（2.1.275 或更高版本）中安装插件：

/plugin install tierward --marketplace marcoguillermaz/Tierward

渐进式采用

无需完整脚手架即可单独安装组件：

npx tierward add skill security-audit   # install one skill
npx tierward add rule git                # install one rule
npx tierward add rule security           # install the security rule

自定义技能（custom-* 前缀）会在升级时保留。请参阅自定义技能指南。

---

架构

your-project/
├── CLAUDE.md                    # Project context (<200 lines)
├── .claude/
│   ├── settings.json            # Permissions + Stop hook (mechanical enforcement)
│   ├── team-settings.json       # Team policy: minTier / allowed / blocked / required (v1.16+)
│   ├── rules/
│   │   ├── pipeline.md          # Development workflow (tier-appropriate)
│   │   ├── security.md          # Stack-aware: web / apple / android / systems
│   │   ├── git.md               # Commit format, branch rules
│   │   └── output-style.md      # Communication rules
│   ├── skills/                  # Audit skills (conditional per project)
│   ├── hooks/                   # Governance gates and the audit log hook
│   └── session/                 # Session recovery (gitignored)
├── docs/                        # Requirements, specs, backlog (M/L)
├── .github/                     # PR template, CODEOWNERS
└── .pre-commit-config.yaml      # Secret scanning

settings.json 中的 Stop 钩子是强制执行机制。当 Claude 尝试完成任务时，它会运行测试；如果测试失败，就会让 Claude 返回修复问题。所有等级（包括探索）都包含此机制。

---

CLI 命令

npx tierward init                    # scaffold wizard
npx tierward init --dry-run          # preview without writing
npx tierward init --answers file.json  # skip prompts (CI/automation)
npx tierward doctor                  # validate setup (28 checks)
npx tierward doctor --report         # JSON output for CI
npx tierward doctor --ci             # silent, exit 1 on failure
npx tierward upgrade                 # refresh safe files, show diffs for the rest
npx tierward upgrade --anthropic     # show diff for Anthropic-influenced files (dry-run)
npx tierward upgrade --anthropic --apply  # write the diff (with .bak backup)
npx tierward add skill <name>        # install one skill
npx tierward add rule <name>         # install one rule
npx tierward new skill               # create a custom skill (wizard)
tierward-mcp                            # MCP server (stdio); wire from .mcp.json

MCP 服务

tierward-mcp 是一个模型上下文协议服务。它通过六种只读工具，让任何支持 MCP 的客户端（Claude Desktop、ChatGPT desktop、Cursor、VS Code、Copilot Studio）都能读取 Tierward 治理状态：doctor 报告、团队设置、最近一次 arch-audit、技能清单、软件包元数据和 /pr-review 评论。CLI 和 MCP 服务包含在同一个 npm 软件包中，版本锁定。只读模式在 v2.1.0 中保持不变。

在 Claude Code 中，将其添加到项目根目录的 .mcp.json 文件中即可与团队共享，或者为你自己配置，让它在多个项目中可用：

claude mcp add --transport stdio --scope user tierward -- tierward-mcp

工具参考、.mcp.json 代码片段和项目根目录解析方式：MCP 服务。

---

流程控制

停止钩子（所有层级）——当 Claude 尝试结束时，钩子会运行你的测试；如果测试失败，就会阻止 Claude 停止，让它返回修复问题。如果 Claude 在同一轮中再次停止，钩子会放行，因此无法修复的失败不会陷入循环（工作原理）。

STOP 门禁（Tier M/L）——实现前审查需求。每个区块都会自动选择先写规范或确认范围的模式。

晋升门禁（Tier S/M/L）——当某个区块或修复正在进行时，治理门禁会暂停晋升，直到你单独回复 Promote；每个关键词对应一次晋升。推送到 staging 或 main 算作晋升，合并拉取请求（gh pr merge 或 GitHub MCP 合并工具）也算。门禁会读取 Claude 运行的命令，因此有少数方式可以绕过它，例如通过 REST API 合并（详情）。

审计日志记录——文件写入和编辑（以及 Tier M/L 上的 shell 命令）会追加到你机器上的 ~/.claude/audit/<project>.jsonl（详情）。

AI 署名——每个 Claude 辅助完成的提交都会标记 Co-authored-by。

每周 arch-audit——SessionStart 钩子会检查过去 7 天内是否运行过 /arch-audit。

CODEOWNERS——修改 .claude/ 的拉取请求会请求技术负责人的审查。只有在分支保护或规则集启用“Require review from Code Owners”时，审查才是强制的。GitHub 的所有套餐都支持公共仓库中的代码所有者；私有仓库则仅 Pro、Team 和 Enterprise 套餐支持。

---

测试

node packages/cli/test/integration/run.js    # 1171 integration checks
node --test 'packages/cli/test/unit/**/*.test.js'   # 596 unit tests

覆盖范围：各层级的文件结构、停止钩子的存在性、流水线门禁数量、占位符解析、技能精简、原生技术栈适配、评分标准评分、跨技术栈内容不变量（10 种技术栈，即列出的技术栈，不含 other 后备项）、黄金文件断言（Swift、Node-TS、Python）、通过 --answers 测试数据完整执行 CLI。

单独的 template-coverage 层（位于 packages/cli/test/template-coverage/）会在交付的模板出现跨层级语义偏差、缺少门禁条款或包含未记录的占位符时直接失败。三个脚本（cross-tier-lint.mjs、gate-enum.mjs、placeholder-check.mjs）可独立运行以支持本地工作，也会在 run.js 中自动运行。策略和概念注册表：docs/architecture/test-coverage-strategy.md。

---

要求

• Node.js >= 22
• Claude Code CLI
• Git

---

文档

docs.tierward → marcoguillermaz.github.io/Tierward：快速入门、层级、技能参考、配置。

文档	受众	内容
自定义技能指南	扩展 Tierward 的开发者	SKILL.md 格式、frontmatter 架构、编写模式
运维指南	采用 Tierward 的团队	完整参考：安装、层级、工作流、治理、常见问题
质量评分标准	评估工作区的团队	8 个维度的评分（D1-D8，0-100%）

---

路线图

12 个月计划请参阅 GitHub 里程碑。

当前：v2.3.0 不再为新项目预先批准命令。项目的 .claude/settings.json 仅保留拒绝列表，因此在默认模式下，Claude Code 会在运行未经允许的命令前征求确认。init 不再覆盖现有的设置文件：它会备份该文件，并添加 Tierward 的 hooks 和拒绝规则，但不会添加允许或询问规则。拒绝列表现在会拒绝所有常见的强制推送形式，治理关卡也涵盖未指定分支的推送、--all 和 --mirror 推送，以及会写入分支的 GitHub MCP 工具。审计技能现在会自行运行扫描，不再丢失子 Agent 的结果；/pr-review 则在主对话中运行，并始终将审查交给其子 Agent。现在，若 .pre-commit-config.yaml 无法解析，tierward doctor 会发出警告；插件的 marketplace 文件已移至 Claude Code 查找它的 .claude-plugin/。v2.2.0 将宽泛的 git、npx 和 curl 允许规则替换为指定命令，让技能重新等待各自的结果，并修复了模板 hooks 读取其数据的方式，因此审计日志、Tier L 破坏性命令检查以及 Stop hook 的循环保护都能正常工作。v2.1.0 允许每个项目选择如何将更改合并到 main（通过 staging 分支、直接合并，或仅通过拉取请求），并将审计模型基线更新为当前的 Claude 模型。v2.0.1 和 v2.0.2 修复了生成的 pre-commit 配置，防止 tierward upgrade 覆盖脚手架生成的文件，并让治理关卡能够读取调用实际运行的命令。v2.0.0 将平台专属的安全上下文文件合并为单一的通用 security.md，这是此次主版本升级的破坏性变更；同时新增了 /repo-hygiene 清理检查。

后续：待上游 Anthropic 规范 MCP 服务发布后，让 /arch-audit 支持 MCP。待 AST 追踪成熟或出现明确需求信号后，重新评估 /privacy-audit（Issue #97 子任务 3）。

---

支持

Tierward 是开源项目，采用 MIT 许可证，并以开放方式构建。如果它对你的团队有帮助：

• ❤️ 在 GitHub 上赞助：为持续开发提供资金，可定期或一次性赞助
• ☕ 请我喝杯咖啡：一次性支持，无需账户
• ⭐ 为仓库点星：帮助其他产品和工程团队发现这个项目
• 🐛 提交问题或发起讨论
• 🔧 提交拉取请求：请参阅下文的贡献指南

---

贡献

开发环境设置、项目结构和 PR 指南请参阅 CONTRIBUTING.md。

如需报告安全问题，请参阅 SECURITY.md。

许可证

MIT

---

由 Marco Guillermaz 构建并维护。以 tierward 的名称发布在 npm 上。讨论和提问：GitHub Discussions。