# Foundation: Context Engineering

## Purpose
定义稳定知识、运行时上下文和 handoff 摘要之间的边界，避免把会议纪要、长文档和临时报错直接堆给所有 agent。

## When to Use
- 设计 `CC Switch` 多 agent 协作方式时
- 某个线程上下文越来越大、输出开始发散时
- 需要决定什么该进入知识库、什么只留在本轮执行时

## Inputs
- 当前阶段的源材料
- 上一阶段的高密度产物
- 当前任务的范围边界

## Outputs
- 边界清晰的 handoff 摘要
- 可复用稳定知识
- 可丢弃的运行时噪音

## Primary Agent/Model
`GPT-5.4 Pro xhigh`

## Secondary Agent/Model
`Claude Opus 4.6`

## Required Skills
- 无强制 skill；遵循本知识库的 handoff 和阶段模板

## Steps
1. 区分“长期规则”和“单次执行信息”。
2. 只把可复用、可稳定引用的内容写入知识库。
3. 每个阶段结束后，把长上下文压缩成 `ANALYSIS.md`、`SPECS/*.md`、`.plans/*.md` 或 handoff 摘要。
4. 进入下一阶段前，优先开新线程，让新线程只读取高密度产物，而不是带着旧对话继续滚动。

## Exit Criteria
- 下一阶段不依赖上一阶段的完整长对话
- handoff 内容短、准、可执行
- 知识库只保留长期有效的规则

## Failure Recovery
- 如果模型开始引用过时讨论、已废弃方案或混乱术语，立即 reset 线程并只提供高密度产物
- 如果手头信息无法压缩成一句目标、一个范围、一个来源清单，说明当前上下文还没整理好，先回到计划阶段

## Related Templates
- [`../templates/analysis-template.md`](../templates/analysis-template.md)
- [`../templates/agent-handoff-template.md`](../templates/agent-handoff-template.md)

## Stable Knowledge
- 设计哲学、命名规则、阶段流程、技术栈白名单、技能映射、模板、ADR

## Runtime Context
- 当前会议摘录
- 单次探索结果
- 临时报错和实验结论
- 某一轮对比参考仓库的细节

## Handoff Rule
- 任何 handoff 必须能回答：要做什么、不能做什么、以什么为准、交付什么、怎么验收。
- handoff 不是全文转发，更不是把整个聊天记录交给下一个 agent。