---
Spec-Type: control
Initiative: 20260413-ai-gateway-backflow
Status: done
Owner-Session: ys-team
Write-Scope:
  - examples/baseline/.ys_team/methods.md
  - examples/baseline/.ys_team/policy.md
  - examples/baseline/.ys_team/memory/policy.md
  - examples/baseline/.ys_team/team.md
  - examples/baseline/AGENTS.md
  - docs/methodology/02-role-protocol.md
  - docs/methodology/03-discussion-protocol.md
  - docs/methodology/05-governance.md
  - .ys_team/methods.md
  - .ys_team/policy.md
  - .ys_team/memory/policy.md
Depends-On: []
Verification: "diff 对比 baseline 文件变更量不超过原文件 50%；grep 检查 methodology 文件不含 SKILL.md/Agent tool/Claude Code 等平台概念"
---

# ai-gateway 实战规则回流

## Background

ai-gateway 在 ys-team 0.3.0 基础上，通过实际项目使用演进出了多项 baseline 没有的治理规则。对比分析确认其中 8 项是通用能力、3 项是可模板化的模式，应回流到 baseline 和 methodology。

## Goals

将 ai-gateway 验证的治理规则按三档回流：
1. 5 项进 methodology + baseline（方法论层面通用）
2. 2 项只进 baseline policy（操作层面有用）
3. 3 项作为空模板段进 baseline（模式有用，值由项目填）

## Non-Goals

- 不照搬 ai-gateway 的项目特定内容（性能约束具体值、角色中文名、commit 规则）
- 不让 baseline 膨胀到 ai-gateway 的体量
- 不修改 SKILL.md 文件
- 不修改 docs/guide/

## Deliverables

### 第一档：进 methodology + baseline（5 项）

| 规则 | methodology 文件 | baseline 文件 |
|------|-----------------|--------------|
| 讨论成本意识（三个警告信号） | 03-discussion-protocol.md | methods.md |
| Infer First 三段判断框架 | 03-discussion-protocol.md | methods.md |
| 外部升级四要素 | 02-role-protocol.md | methods.md |
| 记忆隐私约束 | 05-governance.md | memory/policy.md |
| Subagent Policy 三级语义 | 02-role-protocol.md | methods.md |

### 第二档：只进 baseline policy（3 项）

| 规则 | baseline 文件 |
|------|--------------|
| Spec-Review Gate 规则 | policy.md |
| QA Gate 规则 | policy.md |
| Quality Bar 空段 | policy.md |

### 第三档：空模板段进 baseline（3 项）

| 模式 | baseline 文件 |
|------|--------------|
| Architecture Constraints 段 | AGENTS.md |
| Environment Constraints 段 | AGENTS.md |
| Current Signals 段 | team.md |

### 本仓同步

本仓 .ys_team/ 的 methods.md、policy.md、memory/policy.md 同步更新，与 baseline 对齐。

## Acceptance Criteria

- [ ] baseline methods.md 增加讨论成本意识、Infer First、外部升级四要素、Subagent Policy
- [ ] baseline policy.md 增加 Spec-Review Gate、QA Gate、Quality Bar 段
- [ ] baseline memory/policy.md 增加隐私约束段
- [ ] baseline team.md 增加 Current Signals 空段
- [ ] baseline AGENTS.md 增加 Architecture Constraints、Environment Constraints 空段
- [ ] methodology 03 增加讨论成本意识警告信号、Infer First 框架
- [ ] methodology 02 增加外部升级四要素、Subagent Policy 三级语义
- [ ] methodology 05 增加记忆隐私约束
- [ ] baseline 各文件增量 < 50%
- [ ] methodology 文件不含 SKILL.md / Agent tool / Claude Code 等平台概念
- [ ] 本仓 .ys_team/ 与 baseline 对齐

## Collaboration Summary

- Participants: 方法论架构师、产品演进负责人、交付守门人
- Reporter: 方法论架构师
- Rounds: 1
- Escalations: 无
- Estimated Cost: minimal
- Submit Recommendation: Yes

## Discussion Digest

- 方法论架构师：11 个回流点按方法论通用性分三档，5 个进 methodology + baseline，2 个只进 baseline policy，3 个作为空模板段。
- 产品演进负责人：同意分档，强调 baseline 不能膨胀，Infer First 只保留框架不照搬完整列表。
- 交付守门人：范围 = baseline 5 文件 + methodology 3 文件 + 本仓 3 文件。验收 = 增量 < 50%、methodology 自洽、本仓对齐。

## Verification

```bash
# baseline 文件增量检查（每个文件增量不超过原文件 50%）
wc -l examples/baseline/.ys_team/methods.md
wc -l examples/baseline/.ys_team/policy.md
wc -l examples/baseline/.ys_team/memory/policy.md

# methodology 平台无关检查
grep -rn "SKILL\.md\|Agent tool\|Claude Code\|Claude\|\.claude/" docs/methodology/02-role-protocol.md docs/methodology/03-discussion-protocol.md docs/methodology/05-governance.md
```

## Risks

- 低：纯文档变更，不影响代码或运行时行为
- 中：baseline 变更后，新项目 init 会拿到更丰富的模板，但已初始化的项目不受影响

## Rollback Plan

git revert 即可回滚所有文件变更。