/arch-doctor一条命令即可验证的环境
在生成任何内容之前，检查 schema、hook jar、已注册的 hook、边界规则和溯源信息。hook 无法验证时会以 0 退出；doctor 把这种静默的绿色变成有名字的一行。
产品
十一个部件，一个 harness
像读手册一样阅读：每条命令做什么、证明了什么，以及哪些地方没有同类项目能做到。
/init-project通过 Initializr 生成，harness 内置其中
基础项目在运行时来自 start.spring.io，绝不来自模型的记忆；若有版本号被当作事实写入，CI 会失败。项目自带 .claude/，之后不再依赖本仓库。
/new-feature每层一个负责人的规格
use-case-design → domain-modeling → rest-api-architect 或 graphql-api-architect → 适用时加入安全、出站 HTTP、AI、搜索、消息和定时任务 → persistence-architect → 适用时加入缓存 → test-architect。只问会改变设计的问题。
独有 已批准的规格由 hook 冻结
/new-feature-implement受限的执行器，分组执行
/clear 之后，已批准的规格交给执行器智能体。在 UC-005 中：domain 2m29s · adapters 14m22s · tests 17m29s · compose 4m05s · publish 3m55s。
/audit-usage每次运行都有度量，零 token 成本
每次 skill 或智能体调用生成一份报告：每个环节的计费 token 与模型、带耗时的调用树、触及的文件、失败的工具、前后的 HEAD。提示词会被脱敏。
独有 确定性的逐次运行轨迹
/arch-adopt升级时不丢失手工修改
把 harness 安装到并非在此生成的项目中，或升级落后的项目。拒绝不干净的工作区，为写入的每个文件记录哈希，并打印迁移说明而不执行它们。
独有 通过哈希检测本地修改
// bank-app/.claude/.arch-provenance.json { "ref": "v0.40.0", "commit": "e5ed817", "files": { … 322 hashes } }
/platform-upgrade低于下限的项目，有一条向上的路
/arch-adopt 拒绝 Spring Boot 低于 4.0 的项目。/platform-upgrade 把构建带到 Initializr 今天提供的那条线：先是由数据写成的 OpenRewrite 配方，再是引导式处理，直到构建变绿。测试前后各跑一次，并且绝不提交。
skills × 7 类按类别划分的写入领地
design、orchestrator、build、observer、report、ops、meta。类别声明 skill 可以写入哪些路径；其余一律被 guard 拒绝，默认拒绝。
独有 领地即数据
design docs/use-cases/UC-*/** orchestrator docs/use-cases/** · lessons-learned build 按 skill: compose, .claude/** observer 无 report docs/lessons-learned/** ops 无 meta .claude/** · CLAUDE.md
agents × 4 类智能体的范围由规则决定，而非靠自觉
driver、executor、installer、verifier。子智能体按自己的类别判定，无论调用者留下的是哪个阶段。
driver project-initializer executor java-spring-boot-developer installer archunit · commons-logging · mapstruct · compose-service verifier issue-verifier
guard · check在文件改变之前拒绝
覆盖 Write 与 Edit，覆盖它能识别的 shell 写入形式（>、tee、sed -i、sh -c），并在 Stop 时再次对照本轮 git 看到的改动。
✗ import jakarta.persistence.Entity (domain/) ✗ Edit docs/use-cases/UC-001-…/UC-001-spec.md ✗ sed -i 's/18/16/' UC-001-spec.md ✗ git push --force origin main exit 2
更多harness 的其余部分
docker-architect 让基础设施在设计中决定，sonar-lessons → report-issue 公开闭环改进，每个项目都有 AGENTS.md，ArchHook.java 有十一种模式且不依赖 shell，还有一个验证 harness 自身的 CI。