feat(skills): add /sync-website editorial-sync skill (Phase 3)#401
Merged
Conversation
Hub-homed skill (alongside /dxr-release) that handles the class-B editorial half of the website org-sync: surfaces new ADRs / repos / extensions / closed milestones and authors the matching roadmap / architecture / ecosystem prose into displayxr-website's hand-written TSX, opening a PR (prose warrants review; mechanical facts direct-commit via sync-org.yml). - Operates on a temp clone of displayxr-website; does not assume cwd. - Detection: repos/extensions/demos self-correct via grep vs authored TSX; ADRs converge against a skill-owned lib/data/editorial-baseline.json reviewed-set (the architecture page never cites ADR numbers, so a naive check would re-flag all of them forever). Verified: first run = full backlog, then delta-only. - Registered in link-dxr-skills.sh + symlinked globally; documented in CLAUDE.md. Design: displayxr-website/docs/org-sync.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Phase 3 of the website org-sync system (design:
displayxr-website/docs/org-sync.md).The mechanical layer (versions, demo cards, repo list, extension names) already auto-syncs to displayxr-website via its
sync-org.yml(direct-commit). This adds the editorial half: a hub-homed/sync-websiteskill that surfaces the class-B narrative drift and authors prose.What it does
/dxr-release).roadmap.ts,ecosystem.ts,architecture/page.tsx,extensions/page.tsx), never the generated JSON.tsc/lint/build) and opens a PR — prose warrants a human glance, unlike mechanical facts.--dry-runreports gaps and changes nothing.Convergence design
Repos/extensions self-correct (grep vs authored TSX). ADRs don't — the architecture page summarizes decisions in product terms and never cites ADR numbers, so a naive check re-flags all of them forever. So the skill keeps a
lib/data/editorial-baseline.jsonreviewed-set: first run reconciles the backlog, subsequent runs see only the delta. Verified end-to-end (23 ADRs → fold → 0 → a new ADR surfaces).Smoke-tested against live website — detection already finds two genuine gaps (
XR_EXT_atlas_capture,XR_EXT_workspace_file_dialognot on/extensions).Files
.claude/skills/sync-website/SKILL.md(new), symlinked globally viascripts/link-dxr-skills.sh, noted inCLAUDE.md. Tooling/docs only — no runtime code.🤖 Generated with Claude Code