Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .changes/actionlint/docs-drop-pointer-stamps-docs-59d1ab35.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
7 changes: 7 additions & 0 deletions .changes/bugs/docs-drop-pointer-stamps-docs-e20c0f12.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
7 changes: 7 additions & 0 deletions .changes/discipline/docs-drop-pointer-stamps-docs-f0dd0f3d.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
7 changes: 7 additions & 0 deletions .changes/education/docs-drop-pointer-stamps-docs-790e9362.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
7 changes: 7 additions & 0 deletions .changes/go-format/docs-drop-pointer-stamps-docs-88dd9c85.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
7 changes: 7 additions & 0 deletions .changes/guardrails/docs-drop-pointer-stamps-docs-7c556591.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
7 changes: 7 additions & 0 deletions .changes/knowledge/docs-drop-pointer-stamps-docs-34f4830b.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
7 changes: 7 additions & 0 deletions .changes/miro/docs-drop-pointer-stamps-docs-17e595f4.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
7 changes: 7 additions & 0 deletions .changes/planning/docs-drop-pointer-stamps-docs-58a74f42.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
7 changes: 7 additions & 0 deletions .changes/review/docs-drop-pointer-stamps-docs-faffce07.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
bump: patch
---

### Changed

- Pointer records no longer carry an as-of date or recheck trigger; stored values keep theirs.
4 changes: 2 additions & 2 deletions docs/cloud-sessions.md
Original file line number Diff line number Diff line change
Expand Up @@ -285,8 +285,8 @@ from the two together (see
Code process starts, before SessionStart hook effects land, and is not re-read afterwards; the
hooks reference's only same-session pickup is
[`reloadSkills`](https://code.claude.com/docs/en/hooks#reload-skills-that-a-hook-installs), whose
section names skill directories and not a plugin install, and whether it reaches one is unprobed
(as of 2026-11-04; recheck when that section names plugins). Neither `/plugin`
section names skill directories and not a plugin install, and whether it reaches one is unprobed.
Neither `/plugin`
([terminal-only commands](https://code.claude.com/docs/en/claude-code-on-the-web#manage-context))
nor `--plugin-dir` exists in cloud sessions to force one. On an
ephemeral VM this is a chicken-and-egg problem, because every fresh session re-installs after its registry is
Expand Down
7 changes: 7 additions & 0 deletions docs/contracts/authoring-formats/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,13 @@ value is minor; clarification is a patch. A recheck of the Mermaid-C4 record lan
it produces a drift outcome; refreshing the record's as-of date with no verdict change is no entry
and no version bump, per the upstream-drift contract's "When a trigger fires".

## [1.0.7] - 2026-11-11

Clarification. No key, allowed value, or default changes.

- The Mermaid-C4 record drops its as-of date and keeps its named trigger, per upstream-drift
owner decision D26: it records no upstream number or string.

## [1.0.6] - 2026-11-11

Clarification. No key, allowed value, or default changes.
Expand Down
5 changes: 2 additions & 3 deletions docs/contracts/authoring-formats/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,17 +78,16 @@ output.

Mermaid is not one of the system key's values. This convention offers a C4 dialect only once its
maintainers document the C4 syntax as stable and a reader of the key can emit it. Mermaid meets
neither condition as of the date below. No reader of the key can emit it: the architecture
neither condition. No reader of the key can emit it: the architecture
plugin's resolver fixes the system set to `likec4` and `c4-plantuml`, and neither
`/planning:design` nor the four C4 map views' render scripts have a mermaid C4 path. Adding the
value would mean a resolver change and five emitters, which no consumer has asked for. The
landscape keeps its mermaid default and its `C4Context` output without a focal system, since
mermaid offers no dedicated landscape type as of the same date. The decision depends on mermaid's
mermaid offers no dedicated landscape type. The decision depends on mermaid's
C4 docs, so it carries a record per [`upstream-drift`](../upstream-drift/README.md):

- **Pointer**: when deciding whether mermaid can be a system-key value or whether the landscape's
mermaid output shape should change, fetch <https://mermaid.js.org/syntax/c4.html> live.
- **As of**: 2026-11-04
- **Recheck trigger**: Any of these observable events: the pointer page, or a sibling mermaid C4
syntax page linked from it, documents the C4 syntax as stable; mermaid documents a dedicated
landscape diagram type; or an issue in this repository asks for mermaid C4 output from a reader
Expand Down
5 changes: 0 additions & 5 deletions docs/contracts/config-cascade/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -454,7 +454,6 @@ decision.
is a declared exception, not drift.
- **Basis:** [ADR 0042](../../adr/0042-ratify-consumer-config-location-outliers-in-place.md) on the owner decision on #3577; the existing `.claude/standards.yaml` pointer
already roots the directory, so no new mechanism is needed.
- **As of:** 2026-09-29.
- **Recheck:** a web-session measurement shows plugin-owned `.claude/<name>` writes are fine
everywhere and a consumer reports confusion, or Claude Code changes protected-path handling.
- **`songwriting` reads template overrides from `songwriting/templates/`.** The consumer's prompt
Expand All @@ -469,7 +468,6 @@ decision.
- **Basis:** [ADR 0042](../../adr/0042-ratify-consumer-config-location-outliers-in-place.md); `plugins/songwriting/skills/setup/SKILL.md` "The two surfaces"; the path the
`rhyme`, `song-form`, `meter-prosody`, `co-write`, `metaphor`, `diagnose`, `object-writing`,
`practice` and `workflow` skills check.
- **As of:** 2026-09-29.
- **Recheck:** a template override becomes a settings-shaped file (keyed values rather than
prose), or the setup skill starts writing under `.claude/`.
- **`work-items` reads its recurring schedule from `.github/recurring-schedule.json`.** The file
Expand All @@ -483,7 +481,6 @@ decision.
exception.
- **Basis:** [ADR 0042](../../adr/0042-ratify-consumer-config-location-outliers-in-place.md); `plugins/work-items/reference/tracker-seam.md` "Recurring schedule";
`plugins/work-items/skills/setup/SKILL.md`.
- **As of:** 2026-09-29.
- **Recheck:** the schedule gains a personal override or user-global layer, or the reconciling
automation moves out of `.github/`.
- **`autonomy` exempts its security axes.** Layers refine additively as the contract requires, except
Expand Down Expand Up @@ -516,7 +513,6 @@ decision.
- **Claim:** the three gitignore postures stay; recommend is default; two consumer-root
appends are declared exceptions; own-ignore-file is a different file.
- **Basis:** the owner decision on #3573 (keep the three postures), ADR 0040, and ADR 0015.
- **As of:** 2026-09-29.
- **Recheck:** a setup skill grows a third consumer-root append, or a maintainer
converges the fleet onto one posture.
- **`source-control` stops `branch_issue_pattern` resolution on an unusable layer (#4673).**
Expand Down Expand Up @@ -646,7 +642,6 @@ conformance.

- **Claim:** the glance table is generated from the Implementers rows; engines are not unified.
- **Basis:** #3575 and `scripts/sync-config-cascade-semantics.py`.
- **As of:** 2026-09-29.
- **Recheck:** operators still miss the row, then add the per-setup check line.

## Implementers
Expand Down
3 changes: 1 addition & 2 deletions docs/contracts/ecosystem-commands/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -163,8 +163,7 @@ no other ecosystem-commands key. It diverges from the tolerant-reader paragraph
file outside the supported YAML subset stops the run with exit 2
(`plugins/code-metrics/scripts/resolve-config.py:450-455`) instead of failing soft. Parseable but
schema-invalid content is not validated. **Basis:** `plugins/code-metrics/reference/config.md` "Layers and
merge form", the paragraph on consumer ecosystems files. **As of:** 2026-09-29. **Recheck:** when
that paragraph names another key, or an audit skill starts running a verb from the ecosystem file.
merge form", the paragraph on consumer ecosystems files. **Recheck:** when that paragraph names another key, or an audit skill starts running a verb from the ecosystem file.

## Task-runner deferral (recorded decision)

Expand Down
7 changes: 7 additions & 0 deletions docs/contracts/execution-target/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Changelog for the execution-target convention

## 2.0.1 - 2026-11-11

The vendor-fact pointers no longer carry an as-of date or recheck trigger, per the upstream-drift
convention 5.0.0; the routine-triggers record, which stores no upstream number or string, drops
its stamps too. The cloud launch pointer links the renamed "Start a cloud session from your
terminal" section, and the cloud environments pointer links its two sections by anchor.

## 2.0.0 - 2026-10-21

Removed the `<!-- execution-target:fallback v1 -->` item marker comment and the "Item fallback"
Expand Down
13 changes: 5 additions & 8 deletions docs/contracts/execution-target/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -233,17 +233,14 @@ The lanes launcher carries a copy of the plugin column (`stage_required_plugins`
- **Routine triggers.** Pointer: the "Supported events" table on
[Routines](https://code.claude.com/docs/en/routines#supported-events) (pull request and release
events), and its "Connectors" section (every connected connector is included by default and its
tools run without approval). As of: 2026-10-04. Recheck trigger: the table gains an issues event, or
the connector default changes. The open conflict is anthropics/claude-code#72290 (an issue-opened
tools run without approval). The open conflict is anthropics/claude-code#72290 (an issue-opened
routine trigger that did not fire, closed as stale); nothing here relies on an issue trigger.
- **Cloud launch and upload.** Pointer:
[From terminal to cloud](https://code.claude.com/docs/en/claude-code-on-the-web#from-terminal-to-cloud)
[Start a cloud session from your terminal](https://code.claude.com/docs/en/claude-code-on-the-web#start-a-cloud-session-from-your-terminal)
and [Send local repositories without GitHub](https://code.claude.com/docs/en/claude-code-on-the-web#send-local-repositories-without-github).
As of: 2026-10-04. Recheck trigger: `--cloud` stops uploading a bundle when the App is missing, or
gains a branch or worktree option.
- **Cloud environments.** Pointer: "What carries over from your setup" and "Network access" on
[Cloud environments](https://code.claude.com/docs/en/cloud-environments). As of: 2026-10-04.
Recheck trigger: either table changes.
- **Cloud environments.** Pointer:
[What carries over from your setup](https://code.claude.com/docs/en/cloud-environments#what-carries-over-from-your-setup)
and [Network access](https://code.claude.com/docs/en/cloud-environments#network-access).

## Versioning

Expand Down
Loading
Loading