diff --git a/CHANGELOG.md b/CHANGELOG.md index 45d3b5d..533e579 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,7 +11,8 @@ Every entry states what was actually tested. A static check or an authored examp is not a behavioral evaluation, and adopting a version is an implementation choice, not a demonstrated accuracy gain. -The latest bundle is described in the [v0.2.7 release notes](docs/releases/v0.2.7.md). +The latest bundle is described in the [v0.2.8 release notes](docs/releases/v0.2.8.md). +Previous [v0.2.7 release notes](docs/releases/v0.2.7.md) are retained. Previous [v0.2.6 release notes](docs/releases/v0.2.6.md) are retained. Previous [v0.2.5 release notes](docs/releases/v0.2.5.md) are retained. Previous [v0.2.4 release notes](docs/releases/v0.2.4.md) are retained. @@ -24,7 +25,7 @@ Earlier [v0.1.6 release notes](docs/releases/v0.1.6.md) are retained. Earlier contents and validation are summarized in the [v0.1.5 release notes](docs/releases/v0.1.5.md), with earlier [v0.1.4](docs/releases/v0.1.4.md) and [v0.1.3](docs/releases/v0.1.3.md) notes retained. -## context-docs 0.2.8 — 2026-11-21 (unreleased) +## context-docs 0.2.8 — 2026-11-22 - Specify how Codex and Claude Code hand off edits to a shared context file through the task channel or the user. Keep private context and journal @@ -33,8 +34,8 @@ with earlier [v0.1.4](docs/releases/v0.1.4.md) and [v0.1.3](docs/releases/v0.1.3 private scratch path for a file-backed payload. - Checked with repository static, journal and site tests on Python 3.9 and 3.14. An isolated install verified both packages in Codex and Claude Code - project layouts. See the [candidate notes](docs/releases/v0.2.8.md#candidate-checks) - for the scope and remaining publication steps. + project layouts. See the [release notes](docs/releases/v0.2.8.md#candidate-checks) + for the scope of those checks. ## Experimental Antigravity support label — 2026-11-17 (no package release) diff --git a/README.md b/README.md index 82ddd58..eeb6fa1 100644 --- a/README.md +++ b/README.md @@ -21,10 +21,11 @@ next session to read them. [Website](https://context-docs.com/) · [Get started](#get-started) · [See an example](#what-you-get) · [User guide](docs/getting-started.md) · [Evidence](docs/evaluation-results.md) · [Contribute](CONTRIBUTING.md) -**Status: experimental, core skill v0.2.8 (unreleased) and adoption skill v0.1.16.** -The published bundle remains v0.2.7. +**Status: experimental, core skill v0.2.8 and adoption skill v0.1.16.** +The [v0.2.8 experimental prerelease](docs/releases/v0.2.8.md) covers shared +writer handoff and private journal input. Everyday installation selects this bundle. The [v0.2.7 release notes](docs/releases/v0.2.7.md) cover a narrow instruction -simplification and qualified checks. Everyday installation selects this bundle. +simplification and qualified checks. The Codex candidate report's automatic-loading confirmation remains unverified; Claude instruction events support loading in its checked sessions only. The [v0.2.6 release notes](docs/releases/v0.2.6.md) cover metadata filtering, @@ -74,7 +75,7 @@ cases show how to hand off the same project through saved Markdown. Install both skills, then adopt them in the project you want to maintain. Already installed? Skip to [Use it](#use-it). -The instructions below select published bundle **v0.2.7**: core **0.2.7** and +The instructions below select published bundle **v0.2.8**: core **0.2.8** and adoption **0.1.16**. See the [guide](docs/getting-started.md#development-source-installs) for development-source installations. @@ -84,13 +85,13 @@ Ask Codex: ```text Use $skill-installer to install both skills from jaredchu/context-docs -at the published tag v0.2.7: +at the published tag v0.2.8: - skills/context-docs - skills/adopt-context-docs Install them together in ~/.agents/skills/. Preserve existing installations and local customizations; report version mismatches before upgrading. Report the installed VERSION values: -context-docs 0.2.7 and adopt-context-docs 0.1.16. +context-docs 0.2.8 and adopt-context-docs 0.1.16. ``` [Manual installation and project-only setup →](docs/getting-started.md#install-in-codex) @@ -100,7 +101,7 @@ context-docs 0.2.7 and adopt-context-docs 0.1.16. For a first installation, run these commands in a terminal: ```sh -git clone --branch v0.2.7 https://github.com/jaredchu/context-docs.git +git clone --branch v0.2.8 https://github.com/jaredchu/context-docs.git cd context-docs mkdir -p ~/.claude/skills cp -r skills/context-docs skills/adopt-context-docs ~/.claude/skills/ @@ -109,7 +110,7 @@ cat ~/.claude/skills/context-docs/VERSION ~/.claude/skills/adopt-context-docs/VE If either skill is already installed, [review the upgrade guidance](docs/getting-started.md#upgrading) before copying files. [Project-only setup and instruction loading →](docs/getting-started.md#install-in-claude-code) -The version output should be `0.2.7` followed by `0.1.16`. +The version output should be `0.2.8` followed by `0.1.16`. ### Install in Cursor (experimental) @@ -125,7 +126,7 @@ in Cursor's own user directory (**fresh placement not tested**): ```sh ( - git clone --branch v0.2.7 https://github.com/jaredchu/context-docs.git && + git clone --branch v0.2.8 https://github.com/jaredchu/context-docs.git && cd context-docs && mkdir -p ~/.cursor/skills && test ! -e ~/.cursor/skills/context-docs && @@ -136,7 +137,7 @@ in Cursor's own user directory (**fresh placement not tested**): ``` The sequence stops at the first failure: a failed clone copies nothing, and the -guard copies nothing if either folder already exists. Expect `0.2.7` then +guard copies nothing if either folder already exists. Expect `0.2.8` then `0.1.16`; no version output means installation did not complete. [Cursor setup, evidence and limits →](docs/getting-started.md#cursor-experimental) @@ -158,7 +159,7 @@ From the root of your target project, for a first installation: test ! -L .agents/skills/context-docs && test ! -e .agents/skills/adopt-context-docs && test ! -L .agents/skills/adopt-context-docs && - git clone --branch v0.2.7 https://github.com/jaredchu/context-docs.git context-docs-skills && + git clone --branch v0.2.8 https://github.com/jaredchu/context-docs.git context-docs-skills && mkdir -p .agents/skills && cp -r context-docs-skills/skills/context-docs context-docs-skills/skills/adopt-context-docs .agents/skills/ && cat .agents/skills/context-docs/VERSION .agents/skills/adopt-context-docs/VERSION @@ -166,7 +167,7 @@ From the root of your target project, for a first installation: ``` The guards preserve existing folders and symlinks; a failed clone copies nothing. -The source checkout is `context-docs-skills/` in your project. Expect `0.2.7` then +The source checkout is `context-docs-skills/` in your project. Expect `0.2.8` then `0.1.16`. Reuse existing project copies; review the upgrade guidance before replacing them. [Antigravity setup, evidence and limits →](docs/getting-started.md#antigravity-experimental) diff --git a/docs/getting-started.md b/docs/getting-started.md index 4d1c7f3..7b39b14 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -4,8 +4,8 @@ Install both skills once, adopt them in a project, and let its maintenance rule keep context current after meaningful work. No background service is installed. -Everyday installation below selects published bundle **v0.2.7**: -core **0.2.7** and adoption **0.1.16**. The [release notes](releases/v0.2.7.md) +Everyday installation below selects published bundle **v0.2.8**: +core **0.2.8** and adoption **0.1.16**. The [release notes](releases/v0.2.8.md) retain the bundle scope and evidence limits. ## Install in Codex @@ -14,13 +14,13 @@ Ask the built-in installer: ```text Use $skill-installer to install both skills from jaredchu/context-docs -at the published tag v0.2.7: +at the published tag v0.2.8: - skills/context-docs - skills/adopt-context-docs Install them together in ~/.agents/skills/. Preserve existing installations and local customizations; report version mismatches before upgrading. Report the installed VERSION values: -context-docs 0.2.7 and adopt-context-docs 0.1.16. +context-docs 0.2.8 and adopt-context-docs 0.1.16. ``` The adoption skill requires `context-docs` as a sibling folder. It is a small @@ -28,9 +28,9 @@ setup wrapper, not a standalone replacement for the core skill. The core skill can be installed and used by itself. For a manual installation, clone the published bundle with -`git clone --branch v0.2.7 https://github.com/jaredchu/context-docs.git`, then copy +`git clone --branch v0.2.8 https://github.com/jaredchu/context-docs.git`, then copy both complete folders from that checkout's `skills/` into `~/.agents/skills/`. -Read both copied `VERSION` files: core should be `0.2.7` and adoption `0.1.16`. +Read both copied `VERSION` files: core should be `0.2.8` and adoption `0.1.16`. For a repository-scoped installation, copy both into `.agents/skills/` at the project root instead. Use one scope to avoid duplicate skill entries. Check existing folders and review changes before upgrading; retain @@ -46,14 +46,14 @@ If either skill is already installed, [review the upgrade guidance](#upgrading) before copying files. For a first installation: ```sh -git clone --branch v0.2.7 https://github.com/jaredchu/context-docs.git +git clone --branch v0.2.8 https://github.com/jaredchu/context-docs.git cd context-docs mkdir -p ~/.claude/skills cp -r skills/context-docs skills/adopt-context-docs ~/.claude/skills/ cat ~/.claude/skills/context-docs/VERSION ~/.claude/skills/adopt-context-docs/VERSION ``` -The version output should be `0.2.7` followed by `0.1.16`. +The version output should be `0.2.8` followed by `0.1.16`. Keep both folders side by side: the adoption skill reads its sibling core skill. Invoke a skill as `/context-docs` or `/adopt-context-docs`, or describe the task and let Claude select it. The packaged `agents/openai.yaml` is Codex metadata and @@ -85,7 +85,7 @@ CLI observations and limits. Behavior on other clients has not been evaluated. For development work, deliberately select a reviewed source branch or commit and read its `VERSION` files before copying packages. Copying from a working checkout selects its contents rather than the published bundle and may include unreleased edits. Preserve existing customizations and use one installation -scope. The everyday instructions above remain pinned to v0.2.7. +scope. The everyday instructions above remain pinned to v0.2.8. ## Cursor (experimental) @@ -115,7 +115,7 @@ Cursor reads, copy both complete folders from the published tag into one scope: ```sh ( - git clone --branch v0.2.7 https://github.com/jaredchu/context-docs.git && + git clone --branch v0.2.8 https://github.com/jaredchu/context-docs.git && cd context-docs && mkdir -p ~/.cursor/skills && test ! -e ~/.cursor/skills/context-docs && @@ -128,7 +128,7 @@ Cursor reads, copy both complete folders from the published tag into one scope: The sequence stops at the first failure. A failed clone, for example into an existing `context-docs` folder, copies nothing. The guard copies nothing if either skill folder already exists; follow the [upgrade guidance](#upgrading) instead. -Expect `0.2.7` followed by `0.1.16`; no version output means installation did +Expect `0.2.8` followed by `0.1.16`; no version output means installation did not complete. For one repository only, use `.cursor/skills/` at its root instead. These documented locations were not exercised in the trial. @@ -199,7 +199,7 @@ completed both fresh behavioral cases: adoption in 160.531 seconds and refresh i instruction loading remains unverified. The report retains the refresh final answer's unsupported link-verification claim and the limits of timeout comparisons. The parent model remained `gemini-3.8-flash-medium`; the account tier was unknown. -Core **0.2.7** and adoption **0.1.16** remain unchanged. The follow-up used a +That follow-up kept core **0.2.7** and adoption **0.1.16**. It used a task-specific read-only command helper and permission note, not a skill-package adapter or an installation requirement. These independent cases do not establish a repeatable end-to-end workflow or automatic instruction loading. @@ -215,7 +215,7 @@ project root: test ! -L .agents/skills/context-docs && test ! -e .agents/skills/adopt-context-docs && test ! -L .agents/skills/adopt-context-docs && - git clone --branch v0.2.7 https://github.com/jaredchu/context-docs.git context-docs-skills && + git clone --branch v0.2.8 https://github.com/jaredchu/context-docs.git context-docs-skills && mkdir -p .agents/skills && cp -r context-docs-skills/skills/context-docs context-docs-skills/skills/adopt-context-docs .agents/skills/ && cat .agents/skills/context-docs/VERSION .agents/skills/adopt-context-docs/VERSION @@ -224,10 +224,9 @@ project root: The sequence stops on the first failure and refuses existing skill folders or symlinks. A failed clone copies nothing. The new `context-docs-skills/` folder is -the source checkout; it is not the active skill directory. Expect `0.2.7` then +the source checkout; it is not the active skill directory. Expect `0.2.8` then `0.1.16`. For existing installations, [review upgrades](#upgrading) first. -The trial copied these same complete packages locally; the network clone sequence -is checked with a simulated clone, not a new authenticated installation. +The earlier CLI trial used v0.2.7. Tests for the v0.2.8 commands use a simulated clone. **Other locations (documented, untested).** Google's [skills reference](https://antigravity.google/docs/skills) lists `~/.gemini/config/skills/` as the shared global location. It also lists diff --git a/docs/project-context.md b/docs/project-context.md index 4cd48cf..43bd6f4 100644 --- a/docs/project-context.md +++ b/docs/project-context.md @@ -3,7 +3,7 @@ Context Docs packages a Markdown maintenance workflow for people without an established way to preserve project knowledge across AI sessions. Keep useful decisions, current work and next steps accurate with little manual organization. -Standalone experimental **v0.2.7** is published. The owner separately authorized +Standalone experimental **v0.2.8** is published. The owner separately authorized website deployment and later selected automatic website deployment from `main`; installed upgrades remain separate actions. @@ -19,11 +19,12 @@ and evidence IDs when those records explain a project issue. ## Current focus -The [unreleased v0.2.8 candidate](releases/v0.2.8.md) clarifies +The [v0.2.8 experimental prerelease](releases/v0.2.8.md) clarifies [shared-context writer handoff](../skills/context-docs/SKILL.md#make-the-smallest-useful-update) and [private journal payload delivery](../skills/context-docs/references/event-journal.md#capture-during-maintenance). -The event helper and adoption skill keep their existing behavior. Published -installation commands still select v0.2.7. +The published bundle uses core 0.2.8 and adoption 0.1.16. Installation +commands select v0.2.8. The isolated package check passed, and the public +skills.sh core listing still matched v0.2.7 on the read-only recheck. **Experimental Antigravity support, validated through CLI; App and IDE not separately tested** is published from **`4093383`** after the owner's commit, @@ -426,8 +427,8 @@ transfer documentation follow-up are complete; no additional skill fix is select The earlier technical minimalist UI/UX and identity reboot, abstract C logo and README artwork were deployed from `92042e9`; the [website record](../site/README.md#latest-deployment) retains successful source CI, Pages jobs and artifact/live checks. The skill -release remains v0.2.7 at `00c4b51`. The owner-retained Cloudflare analytics beacon -is the only observed live HTML difference from the repository build. +release at that point was v0.2.7 at `00c4b51`. The owner-retained Cloudflare +analytics beacon was the only observed live HTML difference for that build. The isolated skills.sh install passed at v0.2.7 publication, but public page checks then matched v0.2.6 after a bounded wait. Content refresh remains unverified; do not treat HTTP 200 telemetry as an updated page or repeat installs/replay telemetry. diff --git a/docs/releases/README.md b/docs/releases/README.md index 46d1b68..dcc07c3 100644 --- a/docs/releases/README.md +++ b/docs/releases/README.md @@ -12,13 +12,13 @@ including an isolated skills.sh refresh and full page-content verification. ## v0.2.x -- **[v0.2.8 candidate](v0.2.8.md):** core 0.2.8 and adoption 0.1.16, - with isolated package checks and the publication steps still pending. +- **[v0.2.8](v0.2.8.md):** core 0.2.8 and adoption 0.1.16. The current install + instructions select this experimental prerelease. - **[v0.2.7](v0.2.7.md):** [local preparation](v0.2.7-validation.json), [publication](v0.2.7-publication.json), [qualified simplification checks](../../evals/simplification/2026-10-26/README.md) and [current evidence overview](../evaluation-results.md#more-recent-studies). - Everyday installation is pinned to this bundle; installed upgrades remain separate. + Everyday installation selected this bundle until the v0.2.8 pin update. - **[v0.2.6](v0.2.6.md):** [preparation](v0.2.6-validation.json), [publication](v0.2.6-publication.json), [installed upgrade](../../.context/events/installed-v026-upgrade-20261019.jsonl), diff --git a/docs/releases/v0.2.8.md b/docs/releases/v0.2.8.md index 258175e..11f656c 100644 --- a/docs/releases/v0.2.8.md +++ b/docs/releases/v0.2.8.md @@ -1,8 +1,9 @@ -# v0.2.8 candidate +# v0.2.8 experimental prerelease -Prepared 21 November 2026 from source `9509321`. The candidate bundles -**Context Docs 0.2.8** and **Adopt Context Docs 0.1.16**. Everyday -installation still selects the published [v0.2.7 bundle](v0.2.7.md). +The [experimental prerelease](https://github.com/jaredchu/context-docs/releases/tag/v0.2.8) +was published on 22 November 2026 from `95e0a44`. It bundles **Context Docs +0.2.8** and **Adopt Context Docs 0.1.16**. The installation instructions +now select this bundle. Previous bundle: [v0.2.7](v0.2.7.md). ## Changes @@ -14,9 +15,8 @@ installation still selects the published [v0.2.7 bundle](v0.2.7.md). - Send optional journal events through standard input. When a payload needs a file, use an authorized private scratch path outside the checkout and journal directory. -- Keep the site badge tied to the source release status. While core 0.2.8 - is unreleased, the site identifies it as such alongside the published - v0.2.7 install instructions. +- Distinguish an unreleased source version from the published install + bundle during release preparation. The bundle includes the existing [adoption skill 0.1.16](../../skills/adopt-context-docs/SKILL.md). The @@ -38,10 +38,10 @@ handoff remain unverified. ## Publication and upgrades -Keep public install instructions on the published bundle until the new -tag is available. After publication is authorized, validate the exact release -commit, coordinate the install-pin switch, and follow the -[release checklist](../../CONTRIBUTING.md#release-checklist) for the separate -skills.sh refresh and page verification. Existing users can follow the -[upgrade guide](../getting-started.md#upgrading) when they choose to install -a published update. +Both public source archives and a separate isolated, project-scoped install +matched all 16 verified skill files. The skills.sh install telemetry request +returned HTTP 200. The core listing still matched v0.2.7 on a later +read-only recheck. The adoption listing matched the bundled 0.1.16 instructions. + +Follow the [upgrade guide](../getting-started.md#upgrading) to preserve +existing project context and settings when upgrading. diff --git a/site/compare.html b/site/compare.html index e470f02..e9bc3e9 100644 --- a/site/compare.html +++ b/site/compare.html @@ -25,7 +25,7 @@

Why use
Context Docs?

You may already have enough. Codex and Claude Code provide instructions and memory, and both can maintain project documents. Context Docs packages a reusable way to decide what to keep and how to maintain it.

Source review: · Copy revised:
Context Docs reviewed: core 0.2.6 / adoption 0.1.15 · Experimental
Documentation research, not a comparative benchmark

-

Current published bundle: v0.2.7 (core 0.2.7 / adoption 0.1.16). This comparison has not been rerun.

+

Current published bundle: v0.2.8 (core 0.2.8 / adoption 0.1.16). This comparison has not been rerun.

diff --git a/site/getting-started.html b/site/getting-started.html index eeea626..3185f08 100644 --- a/site/getting-started.html +++ b/site/getting-started.html @@ -32,7 +32,7 @@

Start here.
Keep what matters.

You don't need to design a documentation system. Install two skills, use them in one project, and leave the next session a useful place to start.

Install the skills How the next session starts

For Codex, Claude Code, experimental Cursor and Antigravity support · Experimental · {{PACKAGE_STATUS}}
Core {{CORE_VERSION}} · Adoption {{ADOPTION_VERSION}}

-

v0.2.7 release notes · v0.2.6 release notes · Previous: v0.2.5

+

v0.2.8 release notes · v0.2.6 release notes · Previous: v0.2.5

@@ -42,7 +42,7 @@

Start here.
Keep what matters.

STEP 01

Install the skills.

You'll need Codex, Claude Code, experimental Cursor or Antigravity, and a project folder you can edit. Start with one project you already work on. No cloud account or background service is needed for Context Docs itself.

Install context-docs, the maintenance workflow, and adopt-context-docs, its setup companion. Keep the complete folders side by side.

-

These install commands select published v0.2.7: core 0.2.7 and adoption 0.1.16.

+

These install commands select published v0.2.8: core 0.2.8 and adoption 0.1.16.

Install in Codex

Paste this request into Codex:

{{CODEX_INSTALL}}

Install in Claude Code

For a first installation, run in a terminal with Git available:

{{CLAUDE_INSTALL}}
@@ -85,7 +85,7 @@

Refresh evidence and limits.

This is an illustration, not a required template or an evaluation result. Your agent should use evidence from your project and preserve its useful existing structure.

[[icon:plus]][[icon:minus]]Optional: release details and qualified checks (v0.2.4–v0.2.7) -

The v0.2.7 release shortens repeated instructions while retaining the existing scope and safeguards. Guided checks in Codex and Claude cover refresh, repeat and re-adoption on one reused fixture. Codex's automatic-loading claim remains unverified; Claude instruction events support loading in those sessions only. These checks establish no general reliability or user-effort savings. Read the qualified simplification results. Everyday installs here select published v0.2.7.

+

The v0.2.7 release shortens repeated instructions while retaining the existing scope and safeguards. Guided checks in Codex and Claude cover refresh, repeat and re-adoption on one reused fixture. Codex's automatic-loading claim remains unverified; Claude instruction events support loading in those sessions only. These checks establish no general reliability or user-effort savings. Read the qualified simplification results.

The v0.2.4 release adds a small clarity preference during authorized context edits: use clear, direct sentences and consistent project terms while preserving conditions, uncertainty, rationale and evidence. Keep existing layouts and unrelated owner text. ASD-STE100 compliance is not required.

Both clients pass the focused Markdown checks. Claude's chat report adds an unsupported pronoun; the saved Markdown is unaffected. These guided, author-scored cases do not demonstrate comprehension gains or automatic everyday application. Read the qualified clarity smoke results.

The v0.2.5 release adds conditional guidance for concurrent sessions editing the same context file: agree on one writer before edits begin, send other participants' findings to that writer, and change writers through an explicit handoff. Prefer narrow edits; after a conflict or stale-text failure, reread the current file and reconcile changes before retrying. Installing skills in both Codex and Claude does not coordinate sessions. There is no file locking or automatic merge guarantee.

diff --git a/site/index.html b/site/index.html index 2590a1a..5706178 100644 --- a/site/index.html +++ b/site/index.html @@ -95,7 +95,7 @@

You ask the agent to read the note

-

03 Get started

Set up once.
Keep your usual workflow.

Install both skills, then run the setup skill inside the project you want to keep notes for.

Experimental · {{PACKAGE_STATUS}}
Core {{CORE_VERSION}} · Adoption {{ADOPTION_VERSION}}

These install commands select published v0.2.7: core 0.2.7 and adoption 0.1.16.

Step-by-step guide
+

03 Get started

Set up once.
Keep your usual workflow.

Install both skills, then run the setup skill inside the project you want to keep notes for.

Experimental · {{PACKAGE_STATUS}}
Core {{CORE_VERSION}} · Adoption {{ADOPTION_VERSION}}

These install commands select published v0.2.8: core 0.2.8 and adoption 0.1.16.

Step-by-step guide

Already installed? Read the upgrade guidance before copying files. Preserve your local customizations.

@@ -127,7 +127,7 @@

Install in Claude Code

For a first installation, ru

Switching between Codex and Claude Code? The same saved files can carry unfinished work to the other client. See both directions.

[[icon:plus]][[icon:minus]]Optional: release details and qualified checks (v0.2.4–v0.2.7) -

The v0.2.7 release shortens repeated instructions while retaining the existing scope and safeguards. Guided checks in Codex and Claude cover refresh, repeat and re-adoption on one reused fixture. Codex's automatic-loading claim remains unverified; Claude instruction events support loading in those sessions only. These checks establish no general reliability or user-effort savings. Read the qualified simplification results. Everyday installs here select published v0.2.7.

+

The v0.2.7 release shortens repeated instructions while retaining the existing scope and safeguards. Guided checks in Codex and Claude cover refresh, repeat and re-adoption on one reused fixture. Codex's automatic-loading claim remains unverified; Claude instruction events support loading in those sessions only. These checks establish no general reliability or user-effort savings. Read the qualified simplification results.

The v0.2.4 release adds a small clarity preference during authorized context edits: use clear, direct sentences and consistent project terms while preserving conditions, uncertainty, rationale and evidence. Keep existing layouts and unrelated owner text. ASD-STE100 compliance is not required.

Both clients pass the focused Markdown checks. Claude's chat report adds an unsupported pronoun; the saved Markdown is unaffected. These guided, author-scored cases do not demonstrate comprehension gains or automatic everyday application. Read the qualified clarity smoke results.

The v0.2.5 release adds conditional guidance for concurrent sessions editing the same context file: agree on one writer before edits begin, send other participants' findings to that writer, and change writers through an explicit handoff. Prefer narrow edits; after a conflict or stale-text failure, reread the current file and reconcile changes before retrying. Installing skills in both Codex and Claude does not coordinate sessions. There is no file locking or automatic merge guarantee.

diff --git a/site/test_build.py b/site/test_build.py index 5eb8161..07ffd76 100644 --- a/site/test_build.py +++ b/site/test_build.py @@ -768,7 +768,7 @@ def test_cursor_install_stops_on_failure_and_preserves_existing_destinations(sel '#!/bin/sh\n' 'echo "$@" >> "$FAKE_GIT_LOG"\n' '[ "$FAKE_GIT_MODE" = ok ] || { echo "fatal: clone failed" >&2; exit 128; }\n' - 'for skill in context-docs:0.2.7 adopt-context-docs:0.1.16; do\n' + 'for skill in context-docs:0.2.8 adopt-context-docs:0.1.16; do\n' ' mkdir -p "context-docs/skills/${skill%%:*}"\n' ' echo "${skill#*:}" > "context-docs/skills/${skill%%:*}/VERSION"\n' 'done\n') @@ -790,7 +790,7 @@ def run(mode, prepare): FAKE_GIT_MODE=mode, FAKE_GIT_LOG=str(tmp / 'git.log')) result = subprocess.run(['sh', '-c', command], cwd=work, env=env, capture_output=True, text=True, timeout=30) - self.assertIn('clone --branch v0.2.7', (tmp / 'git.log').read_text()) + self.assertIn('clone --branch v0.2.8', (tmp / 'git.log').read_text()) return result, work, dest def stale_checkout(work, dest): @@ -810,7 +810,7 @@ def stale_checkout(work, dest): with self.subTest('successful first installation'): result, _, dest = run('ok', lambda work, dest: None) self.assertEqual(0, result.returncode, result.stderr) - self.assertEqual('0.2.7\n0.1.16\n', result.stdout) + self.assertEqual('0.2.8\n0.1.16\n', result.stdout) self.assertEqual('0.1.16\n', (dest / 'adopt-context-docs/VERSION').read_text()) def customized(work, dest): @@ -871,7 +871,7 @@ def test_antigravity_install_stops_on_failure_and_preserves_existing_destination '#!/bin/sh\n' 'echo "$@" >> "$FAKE_GIT_LOG"\n' '[ "$FAKE_GIT_MODE" = ok ] || { echo "fatal: clone failed" >&2; exit 128; }\n' - 'for skill in context-docs:0.2.7 adopt-context-docs:0.1.16; do\n' + 'for skill in context-docs:0.2.8 adopt-context-docs:0.1.16; do\n' ' mkdir -p "context-docs-skills/skills/${skill%%:*}"\n' ' echo "${skill#*:}" > "context-docs-skills/skills/${skill%%:*}/VERSION"\n' 'done\n') @@ -894,7 +894,7 @@ def run(mode, prepare): result = subprocess.run(['sh', '-c', command], cwd=work, env=env, capture_output=True, text=True, timeout=30) if (tmp / 'git.log').exists(): - self.assertIn('clone --branch v0.2.7', (tmp / 'git.log').read_text()) + self.assertIn('clone --branch v0.2.8', (tmp / 'git.log').read_text()) return result, work, dest def stale_checkout(work, dest): @@ -914,7 +914,7 @@ def stale_checkout(work, dest): with self.subTest('successful first installation'): result, _, dest = run('ok', lambda work, dest: None) self.assertEqual(0, result.returncode, result.stderr) - self.assertEqual('0.2.7\n0.1.16\n', result.stdout) + self.assertEqual('0.2.8\n0.1.16\n', result.stdout) self.assertEqual('0.1.16\n', (dest / 'adopt-context-docs/VERSION').read_text()) def customized(work, dest):