Golden-Promise · Golden-Promise · Mar 27, 2026 · Mar 27, 2026 · Mar 27, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,22 +4,21 @@ All notable changes to `codex-skill-library` should be documented in this file.
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-03-27
+
 ### Added
 
-- Publish four long-task continuity packages under `skills/`: `skill-context-keeper`, `skill-phase-gate`, `skill-handoff-summary`, and `skill-task-continuity`.
-- Add bilingual package entry docs, routing-first `SKILL.md` files, OpenAI agent metadata, reader-facing references, downstream template assets, and package contract tests for the new continuity packages.
-- Add the continuity-suite bootstrap helper and downstream template set for `AGENTS.md` plus `.agent-state/*.md` files without turning the repository root into a consumer repo.
-- Add `docs/long-task-suite.md` and `docs/long-task-suite.zh-CN.md` so maintainers and readers can understand the suite architecture without opening package internals.
-- Add a static continuity eval harness under `evals/` with seed cases, per-package artifact checks, routing checks, exact workflow-token checks, and optional guardrail metadata validation.
-- Add a pull-request workflow for published package tests plus continuity eval checks.
-- Add bilingual release checklist guidance for the continuity-suite publication flow.
+- Publish the context-protocol continuity suite under `skills/`, including the new atomic packages `skill-subtask-context` and `skill-context-packet`.
+- Add layered starter assets for `AGENTS.md`, `.agent-state/INDEX.md`, `.agent-state/root/`, `.agent-state/subtasks/`, and archive directories through the continuity bootstrap helper.
+- Add bilingual migration guides in [docs/context-protocol-migration.md](docs/context-protocol-migration.md) and [docs/context-protocol-migration.zh-CN.md](docs/context-protocol-migration.zh-CN.md).
+- Add protocol-era suite overview docs that describe root state, subtask state, packets, checkpoints, and handoffs as separate continuity objects.
+- Expand the static continuity eval harness to cover six packages, root/subtask/packet artifact tokens, and protocol-era workflow cases.
 
 ### Changed
 
-- Update root docs, skills indexes, and publishing guides so all four continuity packages are discoverable, install guidance stays aligned with `skill-installer`, and maintainers can find smoke-test and release-checklist steps quickly.
-- Move command-heavy install examples out of the repository root README and keep package-level install guidance closer to the published package entry points.
-- Polish the four continuity package READMEs so they read more like package landing pages, stay friendlier for first-time readers, and preserve strict package boundaries.
-- Keep pinned install guidance aligned to the upcoming `v0.6.1` release after withdrawing the original `v0.6.0` tag.
+- Refocus `skill-context-keeper` on root-state refresh and compression, `skill-handoff-summary` on root/subtask handoffs, and `skill-phase-gate` on optional operational checkpoints.
+- Update root repository indexes and suite docs so the six-package continuity model is discoverable from the repo landing pages.
+- Rewrite publishing and release-checklist docs around protocol validation, six-package smoke tests, and release-scope-driven tag selection instead of a fixed placeholder version.
 - Treat the continuity eval contract as a release-facing surface: routing now depends on published trigger guidance, workflow tokens must match exact package and polarity contracts, and optional guardrail metadata must be valid when present.
 
 ## [0.5.1] - 2026-03-25

diff --git a/README.md b/README.md
@@ -26,7 +26,9 @@ This repository is designed for people who want to:
 | Skill | Best For | Docs |
 | --- | --- | --- |
 | `skill-governance` | Governing skill assets with task-first add, enable, doctor, repair, audit, and document flows | [EN](skills/skill-governance/README.md) / [中文](skills/skill-governance/README.zh-CN.md) |
-| `skill-context-keeper` | Refreshing current task state without drifting into checkpoints or handoff ownership | [EN](skills/skill-context-keeper/README.md) / [中文](skills/skill-context-keeper/README.zh-CN.md) |
+| `skill-context-keeper` | Refreshing and compressing trusted root-task state | [EN](skills/skill-context-keeper/README.md) / [中文](skills/skill-context-keeper/README.zh-CN.md) |
+| `skill-subtask-context` | Opening and maintaining bounded child-task state without bloating the root summary | [EN](skills/skill-subtask-context/README.md) / [中文](skills/skill-subtask-context/README.zh-CN.md) |
+| `skill-context-packet` | Writing the minimum next-turn context packet for root or subtask work | [EN](skills/skill-context-packet/README.md) / [中文](skills/skill-context-packet/README.zh-CN.md) |
 | `skill-phase-gate` | Adding preflight and postflight checkpoints around meaningful edits | [EN](skills/skill-phase-gate/README.md) / [中文](skills/skill-phase-gate/README.zh-CN.md) |
 | `skill-handoff-summary` | Writing compact continuation handoffs when work pauses or changes owners | [EN](skills/skill-handoff-summary/README.md) / [中文](skills/skill-handoff-summary/README.zh-CN.md) |
 | `skill-task-continuity` | Bootstrapping and composing the continuity suite without replacing the atomic packages | [EN](skills/skill-task-continuity/README.md) / [中文](skills/skill-task-continuity/README.zh-CN.md) |
@@ -36,7 +38,7 @@ This repository is designed for people who want to:
 1. Open the package list in [skills/README.md](skills/README.md).
 2. Choose a skill and read its package `README.md`.
 3. Follow the installation guidance in that package README.
-4. For the continuity workflow, start with `skill-task-continuity` when you need suite bootstrap or composition guidance, or install the narrower atomic package directly.
+4. For the continuity workflow, start with `skill-task-continuity` when you need suite bootstrap or composition guidance, or jump directly to `skill-context-keeper`, `skill-subtask-context`, `skill-context-packet`, `skill-phase-gate`, or `skill-handoff-summary` when the next action is already clear.
 5. Use the package reference pages for boundary notes now, and later for examples, prompts, and deeper guidance.
 
 ## Reading Guide
@@ -45,9 +47,15 @@ This repository is designed for people who want to:
 - 中文技能索引: [skills/README.zh-CN.md](skills/README.zh-CN.md)
 - `skill-governance` package: [EN](skills/skill-governance/README.md) / [中文](skills/skill-governance/README.zh-CN.md)
 - `skill-context-keeper` package: [EN](skills/skill-context-keeper/README.md) / [中文](skills/skill-context-keeper/README.zh-CN.md)
+- `skill-subtask-context` package: [EN](skills/skill-subtask-context/README.md) / [中文](skills/skill-subtask-context/README.zh-CN.md)
+- `skill-context-packet` package: [EN](skills/skill-context-packet/README.md) / [中文](skills/skill-context-packet/README.zh-CN.md)
 - `skill-phase-gate` package: [EN](skills/skill-phase-gate/README.md) / [中文](skills/skill-phase-gate/README.zh-CN.md)
 - `skill-handoff-summary` package: [EN](skills/skill-handoff-summary/README.md) / [中文](skills/skill-handoff-summary/README.zh-CN.md)
 - `skill-task-continuity` package: [EN](skills/skill-task-continuity/README.md) / [中文](skills/skill-task-continuity/README.zh-CN.md)
+- Context protocol migration guide: [docs/context-protocol-migration.md](docs/context-protocol-migration.md)
+- 中文迁移说明: [docs/context-protocol-migration.zh-CN.md](docs/context-protocol-migration.zh-CN.md)
+- Continuity suite overview: [docs/long-task-suite.md](docs/long-task-suite.md)
+- 中文连续性套件总览: [docs/long-task-suite.zh-CN.md](docs/long-task-suite.zh-CN.md)
 - Repository publishing guide: [docs/publishing.md](docs/publishing.md)
 - 中文发布说明: [docs/publishing.zh-CN.md](docs/publishing.zh-CN.md)
 - Release checklist for the continuity suite: [docs/release-checklist-long-task-suite.md](docs/release-checklist-long-task-suite.md)
@@ -66,6 +74,8 @@ codex-skill-library/
     README.zh-CN.md
     skill-governance/
     skill-context-keeper/
+    skill-subtask-context/
+    skill-context-packet/
     skill-phase-gate/
     skill-handoff-summary/
     skill-task-continuity/
@@ -75,5 +85,6 @@ codex-skill-library/
 
 Repository versioning, release flow, and validation steps are documented in [docs/publishing.md](docs/publishing.md).
 The continuity-suite release checklist lives in [docs/release-checklist-long-task-suite.md](docs/release-checklist-long-task-suite.md).
+Protocol migration and overview docs live in [docs/context-protocol-migration.md](docs/context-protocol-migration.md) and [docs/long-task-suite.md](docs/long-task-suite.md).
 Package-level install guidance stays in each package README.
 If you are publishing this repository for the first time, start with those maintainer docs instead of the package runtime docs.
diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -26,7 +26,9 @@
 | Skill | 适用场景 | 文档 |
 | --- | --- | --- |
 | `skill-governance` | 用任务式入口治理 skill 资产，包括新增、启用、体检、修复、审计和补文档 | [EN](skills/skill-governance/README.md) / [中文](skills/skill-governance/README.zh-CN.md) |
-| `skill-context-keeper` | 刷新当前任务状态，不扩展成检查点或交接职责 | [EN](skills/skill-context-keeper/README.md) / [中文](skills/skill-context-keeper/README.zh-CN.md) |
+| `skill-context-keeper` | 刷新并压缩可信的 root-task state | [EN](skills/skill-context-keeper/README.md) / [中文](skills/skill-context-keeper/README.zh-CN.md) |
+| `skill-subtask-context` | 打开并维护有边界的 child-task state，避免 root summary 持续膨胀 | [EN](skills/skill-subtask-context/README.md) / [中文](skills/skill-subtask-context/README.zh-CN.md) |
+| `skill-context-packet` | 为 root 或 subtask 工作写下一轮最小上下文 packet | [EN](skills/skill-context-packet/README.md) / [中文](skills/skill-context-packet/README.zh-CN.md) |
 | `skill-phase-gate` | 在有分量的改动前后加入 preflight / postflight 检查点 | [EN](skills/skill-phase-gate/README.md) / [中文](skills/skill-phase-gate/README.zh-CN.md) |
 | `skill-handoff-summary` | 在暂停或换人时生成紧凑、面向续做的交接摘要 | [EN](skills/skill-handoff-summary/README.md) / [中文](skills/skill-handoff-summary/README.zh-CN.md) |
 | `skill-task-continuity` | 负责连续性套件的启动与组合，但不替代原子包 | [EN](skills/skill-task-continuity/README.md) / [中文](skills/skill-task-continuity/README.zh-CN.md) |
@@ -36,7 +38,7 @@
 1. 先看 [skills/README.zh-CN.md](skills/README.zh-CN.md) 浏览当前可用 skill。
 2. 进入具体 skill 包的 `README.md` 了解它是否适合你的场景。
 3. 按该包 README 中的安装说明安装目标包。
-4. 如果你需要整套连续性流程的启动或组合说明，先从 `skill-task-continuity` 开始；如果只需要单个动作，直接安装对应的原子包。
+4. 如果你需要整套连续性流程的启动或组合说明，先从 `skill-task-continuity` 开始；如果下一步动作已经明确，也可以直接进入 `skill-context-keeper`、`skill-subtask-context`、`skill-context-packet`、`skill-phase-gate` 或 `skill-handoff-summary`。
 5. 现在可先阅读该包下的参考页了解边界说明，后续阶段再继续使用其中补充的示例与提示词资料。
 
 ## 阅读入口
@@ -45,9 +47,15 @@
 - 中文技能索引: [skills/README.zh-CN.md](skills/README.zh-CN.md)
 - `skill-governance` 包说明: [EN](skills/skill-governance/README.md) / [中文](skills/skill-governance/README.zh-CN.md)
 - `skill-context-keeper` 包说明: [EN](skills/skill-context-keeper/README.md) / [中文](skills/skill-context-keeper/README.zh-CN.md)
+- `skill-subtask-context` 包说明: [EN](skills/skill-subtask-context/README.md) / [中文](skills/skill-subtask-context/README.zh-CN.md)
+- `skill-context-packet` 包说明: [EN](skills/skill-context-packet/README.md) / [中文](skills/skill-context-packet/README.zh-CN.md)
 - `skill-phase-gate` 包说明: [EN](skills/skill-phase-gate/README.md) / [中文](skills/skill-phase-gate/README.zh-CN.md)
 - `skill-handoff-summary` 包说明: [EN](skills/skill-handoff-summary/README.md) / [中文](skills/skill-handoff-summary/README.zh-CN.md)
 - `skill-task-continuity` 包说明: [EN](skills/skill-task-continuity/README.md) / [中文](skills/skill-task-continuity/README.zh-CN.md)
+- English context protocol migration guide: [docs/context-protocol-migration.md](docs/context-protocol-migration.md)
+- 中文迁移说明: [docs/context-protocol-migration.zh-CN.md](docs/context-protocol-migration.zh-CN.md)
+- English continuity suite overview: [docs/long-task-suite.md](docs/long-task-suite.md)
+- 中文连续性套件总览: [docs/long-task-suite.zh-CN.md](docs/long-task-suite.zh-CN.md)
 - English publishing guide: [docs/publishing.md](docs/publishing.md)
 - 中文发布说明: [docs/publishing.zh-CN.md](docs/publishing.zh-CN.md)
 - English continuity-suite release checklist: [docs/release-checklist-long-task-suite.md](docs/release-checklist-long-task-suite.md)
@@ -66,6 +74,8 @@ codex-skill-library/
     README.zh-CN.md
     skill-governance/
     skill-context-keeper/
+    skill-subtask-context/
+    skill-context-packet/
     skill-phase-gate/
     skill-handoff-summary/
     skill-task-continuity/
@@ -75,5 +85,6 @@ codex-skill-library/
 
 仓库级的版本、发布流程和校验说明统一放在 [docs/publishing.zh-CN.md](docs/publishing.zh-CN.md)。
 连续性套件发布清单在 [docs/release-checklist-long-task-suite.zh-CN.md](docs/release-checklist-long-task-suite.zh-CN.md)。
+协议迁移和套件总览放在 [docs/context-protocol-migration.zh-CN.md](docs/context-protocol-migration.zh-CN.md) 与 [docs/long-task-suite.zh-CN.md](docs/long-task-suite.zh-CN.md)。
 包级安装说明统一保留在各自 README 中。
 如果你是第一次发布这个仓库，建议先看这些维护者文档，而不是直接从包内运行时说明开始。
diff --git a/docs/context-protocol-migration.md b/docs/context-protocol-migration.md
@@ -0,0 +1,131 @@
+# Context Protocol Migration Guide
+
+## Who This Is For
+
+Use this guide if you already know the older long-task continuity suite and need to understand what changed.
+
+You can ignore this guide if:
+
+- you are starting fresh with the current six-package suite
+- you only need one atomic package and do not care about the broader workflow
+- you are reading package docs directly and do not need the historical bridge
+
+## Why The Model Changed
+
+The older continuity framing was useful, but it still treated too much work as “state vs gate vs handoff.”
+That left two important jobs under-modeled:
+
+- isolated child-task context
+- minimum next-turn context injection
+
+The context protocol makes both of those first-class.
+
+## Old Model vs New Model
+
+| Older Mental Model | Context Protocol Replacement |
+| --- | --- |
+| One task state that keeps growing | Separate `root/` state from `subtasks/` state |
+| Summaries are the main continuity object | Packets become the default next-turn injection object |
+| `skill-phase-gate` often feels central | `skill-phase-gate` is now an optional checkpoint only |
+| Handoff is mostly a flat `.agent-state/HANDOFF.md` | Handoff can target root or subtask scope |
+| Orchestration is mainly about four packages | Suite routing now spans six packages and a layered repo layout |
+
+## Package Mapping
+
+### Still The Same In Spirit
+
+- `skill-context-keeper`
+  - still owns trusted root-task refresh
+  - now explicitly owns root-state compression too
+- `skill-handoff-summary`
+  - still owns continuation-oriented pause artifacts
+  - now works for both root and subtask scope
+- `skill-task-continuity`
+  - still owns bootstrap and package routing
+  - now boots a layered protocol layout instead of a flat one
+
+### Newly First-Class
+
+- `skill-subtask-context`
+  - owns bounded child-task state under `.agent-state/subtasks/<slug>/`
+- `skill-context-packet`
+  - owns minimum next-turn packets under `.agent-state/root/PACKET.md` or `.agent-state/subtasks/<slug>/PACKET.md`
+
+### Narrowed On Purpose
+
+- `skill-phase-gate`
+  - no longer acts like the center of continuity
+  - only adds an optional operational checkpoint around risky work
+
+## How To Adopt The New Workflow
+
+### Recommended Path
+
+1. Start in beginner mode.
+2. Bootstrap `AGENTS.md`, `.agent-state/INDEX.md`, and `.agent-state/root/`.
+3. Keep using `skill-context-keeper` for root-state refresh.
+4. When the root summary gets noisy, split one bounded child task with `skill-subtask-context`.
+5. When the next turn does not need the whole state file, create a packet with `skill-context-packet`.
+6. Use `skill-phase-gate` only when the checkpoint itself adds value.
+7. Use `skill-handoff-summary` whenever work pauses or ownership changes.
+
+### Beginner Mode
+
+You usually only need:
+
+- `.agent-state/INDEX.md`
+- `.agent-state/root/TASK_STATE.md`
+- `.agent-state/root/PACKET.md`
+- `.agent-state/root/HANDOFF.md`
+
+Stay here until you have a real child task with a different owner, scope, or risk boundary.
+
+### Expanded Mode
+
+Move into expanded mode when at least one of these becomes true:
+
+- the root task is carrying too much unrelated local detail
+- another agent should own a bounded slice of the work
+- packet-sized continuation is better than loading the whole root summary
+- archived stale detail is making active state unreadable
+
+## Common Mistakes
+
+### Treating Packets As Full State
+
+Packets are not the durable canonical record.
+They are the minimum next-turn injection object.
+If you keep shoving full history into packets, you lose the point of compression.
+
+### Keeping Child-Task Detail In Root State
+
+If a child task has its own files, risks, and exit criteria, give it its own state.
+Otherwise the root summary becomes the place where all context goes to rot.
+
+### Using `skill-phase-gate` As The Continuity Center
+
+If the main problem is stale state, use `skill-context-keeper`.
+If the main problem is bounded child-task isolation, use `skill-subtask-context`.
+If the main problem is context budget, use `skill-context-packet`.
+
+### Writing Handoffs For Work That Is Not Actually Pausing
+
+If the work is still live and the next turn just needs a small injection surface, write a packet instead of a handoff.
+
+## What Does Not Change
+
+- public install paths stay under `skills/<skill-name>/`
+- the suite is still repo-first and documentation-first
+- routing remains narrow on purpose
+- static evals remain the maintainer regression surface
+
+## Quick Decision Table
+
+| Need | Use |
+| --- | --- |
+| Refresh the main task picture | `skill-context-keeper` |
+| Open or refresh a child task | `skill-subtask-context` |
+| Shrink the next turn into minimal context | `skill-context-packet` |
+| Add a risky-change checkpoint | `skill-phase-gate` |
+| Pause or transfer with a durable note | `skill-handoff-summary` |
+| Bootstrap the suite or choose the next package | `skill-task-continuity` |