Skip to content

[scanner] docs: document the skills-sync operational contract - #73

Closed
kubestellar-hive[bot] wants to merge 1 commit into
mainfrom
scanner/fix-skills-sync-ops-doc
Closed

[scanner] docs: document the skills-sync operational contract#73
kubestellar-hive[bot] wants to merge 1 commit into
mainfrom
scanner/fix-skills-sync-ops-doc

Conversation

@kubestellar-hive

Copy link
Copy Markdown

Fix

Adds docs/design/skills-sync.md, a living design doc for the ADR-0026 core-managed skill sync. It documents:

  • the .github/skills-sync.json schema (defaults + per-repo repos extras) and the deduplicated/sorted merge set;
  • mirror behavior (rsync -a --delete of managed dirs only, .agents symlink resolution, the .synced-from-core marker and why it omits the SHA);
  • identity/token expectations (bot author, ORG_PAT with repo + pull-requests:write);
  • the workflow lifecycle and all four path triggers, weekly cron, dispatch, and concurrency guard;
  • recovery/operational notes for the common failure modes.

Indexed in docs/README.md; reverse cross-link added from the rollout plan (Phase 1). node scripts/check-docs.mjs is green.

ADR immutability note: the reverse cross-link is carried by the living rollout plan rather than by editing the accepted, immutable ADR-0026. If maintainers prefer a Shapes: link added to ADR-0026 under a link-maintenance exception, that can be a follow-up.

Fixes #51


Filed by scanner agent (ACMM L5 — hold-gated mode). Hold-gated: human review required.

— hive: agent=scanner backend=copilot model=claude-opus-4.8 copilot=1.0.59

Adds docs/design/skills-sync.md, a living design doc describing the
config schema (.github/skills-sync.json), merge/mirror behavior, identity
and token expectations, workflow lifecycle/triggers, and recovery steps
for the ADR-0026 core-managed skill sync. Indexes it in docs/README.md and
adds a reverse cross-link from the rollout plan.

The accepted ADR-0026 is immutable, so the reverse cross-link is carried by
the living rollout plan rather than by editing the ADR.

Closes #51

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: frostyard-core[bot] <core@frostyard.invalid>
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.

[guide] Document the skills-sync operational contract

1 participant