artifact-sync

Generate minimal updates for drifted CLAUDE.md, guides, and skill docs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dylan-conlin/orch-go --skill artifact-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: artifact-sync
Source: https://github.com/dylan-conlin/orch-go/tree/main/skills/src/worker/artifact-sync
Command: npx skills add https://github.com/dylan-conlin/orch-go --skill artifact-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drifted artifacts (CLAUDE.md, guides, and skill docs) can become stale as code evolves. This skill keeps artifacts in sync with minimal, targeted updates.

Core Features & Use Cases

  • Parses drift reports and identifies stale entries across CLAUDE.md, guides, and skill docs.
  • Reads relevant commits and changed sources to propose precise edits, then applies them.
  • Commits updates with a conventional message to maintain history and traceability.

Quick Start

Run orch sync --fix to trigger artifact-sync and review the generated updates.

Frequently Asked Questions about artifact-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix drifted documentation when my code changes?

To fix drifted documentation when code changes, artifact-sync parses drift reports and recent commits to generate minimal, targeted edits for stale files. It then applies these precise updates and commits them automatically to maintain history.

What is documentation drift and how do I detect it in my project?

Documentation drift occurs when project guides and docs become stale as code evolves. You can detect it by running a drift report, which artifact-sync parses to identify outdated entries across files like CLAUDE.md and skill docs.

Can I sync CLAUDE.md and skill docs automatically with minimal edits?

Yes, you can sync CLAUDE.md and skill docs automatically with minimal edits. Artifact-sync reads changed sources and relevant commits to propose precise updates, ensuring only necessary changes are made to keep artifacts current.

What's the best way to update stale guides after a recent commit?

The best way to update stale guides after a recent commit is to run the sync command with the fix flag. This triggers artifact-sync to read the commit range, propose minimal edits to the guides, and commit the updates with a conventional message.

Why does artifact-sync propose minimal updates instead of rewriting entire files?

Artifact-sync proposes minimal updates instead of rewriting entire files to ensure targeted synchronization. By reading diffs and applying only necessary edits, it maintains traceability and prevents unnecessary changes to documentation like CLAUDE.md and guides.

Do I need a drift report to sync project documentation with recent code changes?

You need a drift report or a defined commit range to sync project documentation effectively. Artifact-sync relies on these inputs to identify stale entries and read changed sources, allowing it to generate and apply the correct minimal updates.