Skip to content

docs: reconcile RFC coordination index with shipped reality - #1349

Merged
GarthDB merged 2 commits into
mainfrom
docs/reconcile-rfc-coordination
Aug 19, 2026
Merged

docs: reconcile RFC coordination index with shipped reality#1349
GarthDB merged 2 commits into
mainfrom
docs/reconcile-rfc-coordination

Conversation

@GarthDB

@GarthDB GarthDB commented Aug 19, 2026

Copy link
Copy Markdown
Member

Description

Reconciles docs/rfc-coordination.md (the RFC "living index") and its two sibling
docs with what has actually shipped, and updates the five GitHub RFC discussions
whose status blockquotes had drifted out of sync with the index.

Related Issue

N/A — documentation reconciliation, not tied to a single issue.

Motivation and Context

The coordination doc is meant to be updated in the same PR that lands a change,
but several months of shipped work (Phase B, CTR, guidelines) had landed without
it, leaving the index unable to be trusted as an entry point. This makes the
three docs and the five affected discussions consistent with shipped reality
again.

How Has This Been Tested?

  • node tools/changeset-linter/src/cli.js check --fail-on-warnings passes.
  • Verified every file in packages/design-data-spec/spec/*.md is referenced by
    the coordination doc.
  • Verified every SPEC-XXX id cited in the doc exists in rules.yaml.
  • Cross-checked Phase B shipping claims against the closed beads epic and the
    actual cascade write-path code (sdk/core/src/write.rs, CLI/TUI/MCP call
    sites) before flipping any status language.

Screenshots (if appropriate):

N/A

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)

Docs-only change (patch changeset for @adobe/design-data-spec).

Checklist:

  • I have signed the Adobe Open Source CLA.
  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING document.
  • I have added tests to cover my changes.
  • All new and existing tests passed.

… guidelines

Phase B (foundation-corpus write path), Component/Token Relationships, and the
guideline entity had all shipped without the coordination index or its sibling
docs catching up, so the "living index" no longer matched reality.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@changeset-bot

changeset-bot Bot commented Aug 19, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: ec5f852

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@adobe/design-data-spec Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

- rfc-coordination.md, token-studio-sunset.md: beads IDs 122/459 were
  mistakenly linked as GitHub issue URLs, which resolve to an unrelated
  auto-generated release PR; unlinked them (beads have no GitHub issue).
- agent-surface.md: promote write_token to NORMATIVE (MUST), matching
  authoring-workflow.md now that the Phase B write target has shipped.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

Run report for ec5f8522

Total time: 139.9ms | Comparison time: 110.7ms | Estimated loss: 29.2ms (20.8% slower)

Action Time Status Info
⬛️ SetupProto(0.57.4) 0ms Skipped
🟩 SyncWorkspace 10.7ms Passed
🟩 SyncProject(design-data-spec) 0.7ms Passed
⬛️ SetupToolchain(node:20.17.0) 12.1ms Skipped
⬛️ SetupToolchain(pnpm:10.17.1) 2.2ms Skipped
⬛️ SetupToolchain(javascript) 0ms Skipped
🟩 SetupEnvironment(javascript) 0.5ms Passed
⬛️ InstallDependencies(javascript) 6.5ms Skipped
🟩 RunTask(design-data-spec:check) 107.6ms Passed
Changed files
.changeset/reconcile-rfc-coordination-docs.md
docs/rfc-coordination.md
docs/token-studio-sunset.md
packages/design-data-spec/spec/agent-surface.md
packages/design-data-spec/spec/authoring-workflow.md

@GarthDB
GarthDB merged commit 16a8077 into main Aug 19, 2026
9 checks passed
@GarthDB
GarthDB deleted the docs/reconcile-rfc-coordination branch August 19, 2026 22:20
@github-actions

Copy link
Copy Markdown
Contributor

🎨 Token Changes Report

Tokens Changed (0)

Original Branch: main


This comment was automatically generated by the token diff tool. 🤖

@github-actions

Copy link
Copy Markdown
Contributor

🧩 Component Schema Changes Report

No component schema changes detected.

This comment was automatically generated by the component schema diff tool. 🤖

@GarthDB GarthDB mentioned this pull request Aug 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant