How do I trigger an instruction update?

You can use the /sw:update-instructions command within Claude Code or run the command via the SpecWeave CLI using 'npx specweave update-instructions'.

Which files are affected by this skill?

The skill specifically manages CLAUDE.md (used by Claude Code) and AGENTS.md (used by generic AI development tools).

Will this skill overwrite my custom project notes?

No. The skill uses specific markers to identify framework sections and is designed to preserve any content written outside of those markers or between managed sections.

Why is syncing instruction files important?

Syncing ensures your AI agent has access to the most recent rules, formatting standards, and framework features provided by SpecWeave updates.

What happens if I run this on a file without SpecWeave markers?

The skill identifies it as a legacy file, prepends the new managed content at the top, and preserves all your original content below a separator.

SpecWeave Instruction Sync

Name: SpecWeave Instruction Sync
Author: anton-abyzov

byanton-abyzov

•

Productivity & Workflow

Syncs and merges SpecWeave instruction files while preserving custom developer modifications through a smart merge system.

About

SpecWeave Instruction Sync is a specialized utility designed to maintain project-specific AI instruction files like CLAUDE.md and AGENTS.md. It uses a sophisticated smart merge system that identifies framework-managed sections using HTML comment markers, allowing SpecWeave to update core logic, rules, and best practices while ensuring that any custom sections added by the developer remain completely untouched. This is essential for keeping AI agents aligned with the latest framework capabilities without losing critical project-specific context or manual customizations.

Key Features

23 GitHub stars
Automatic parsing of SW-managed sections using HTML markers
Seamless synchronization with the latest SpecWeave framework updates
Smart merge for CLAUDE.md and AGENTS.md instruction files
Support for legacy file migration and fresh installations
Preservation of user-defined content between managed sections

Use Cases

Restoring or refreshing corrupted AI agent configuration files
Syncing global framework rules into existing project documentation
Updating project instruction files after a SpecWeave version upgrade

About

Key Features

23 GitHub stars
Automatic parsing of SW-managed sections using HTML markers
Seamless synchronization with the latest SpecWeave framework updates
Smart merge for CLAUDE.md and AGENTS.md instruction files
Support for legacy file migration and fresh installations
Preservation of user-defined content between managed sections

Use Cases

Restoring or refreshing corrupted AI agent configuration files
Syncing global framework rules into existing project documentation
Updating project instruction files after a SpecWeave version upgrade