doc-sync

Detect documentation drift from git history and propose edits to project docs.

3|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/t6adev/claude-code-tools --skill doc-sync-t6adev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-sync
Source: https://github.com/t6adev/claude-code-tools/tree/main/tools/skills/docs/doc-sync
Command: npx skills add https://github.com/t6adev/claude-code-tools --skill doc-sync-t6adev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the process of reconciling documentation with code changes by reading git history, identifying drift between CLAUDE.md, docs/architecture.md, docs/requirements.md, and README.md, and proposing targeted updates that are applied only after user approval.

Core Features & Use Cases

  • Read recent changes from git history and identify documentation drift.
  • Propose precise, minimal edits to CLAUDE.md, docs/architecture.md, docs/requirements.md, and README.md.
  • Apply approved changes in a controlled, stepwise workflow with human confirmation.

Quick Start

Ask doc-sync to read git diff and propose targeted doc updates.

Frequently Asked Questions about doc-sync

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

FAQPage Schema
How do I keep my documentation in sync with code changes using git diff?

To keep documentation in sync, doc-sync reads recent git history to detect documentation drift and proposes targeted edits to CLAUDE.md, docs/architecture.md, docs/requirements.md, and README.md. Updates are applied only after user approval.

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

Documentation drift occurs when project docs become outdated relative to code changes. You can detect documentation drift by reading git history to identify inconsistencies between your current code and files like CLAUDE.md, docs/architecture.md, and README.md.

How to update CLAUDE.md and README.md based on recent git history?

To update CLAUDE.md and README.md based on git history, you can use a documentation-sync workflow that reads recent commits, identifies drift, and proposes focused edits. The proposed changes are then applied stepwise only after human confirmation.

Can I automatically apply documentation updates to docs/architecture.md without manual review?

No, documentation updates to docs/architecture.md cannot be applied automatically without manual review. The change-propagation workflow ensures controlled, minimal changes by applying proposed edits only after explicit user approval.

Does doc-sync support documentation files outside of CLAUDE.md and the docs directory?

No, doc-sync focuses on reconciling documentation drift specifically within CLAUDE.md, docs/architecture.md, docs/requirements.md, and README.md. It proposes minimal edits to these targeted files rather than supporting arbitrary documentation paths.

What is the best way to propagate code changes to project documentation?

The best way to propagate code changes to project documentation is using an automated review-and-apply workflow. It reads git history, identifies drift across CLAUDE.md and docs files, and proposes focused edits that are applied only after user approval for controlled synchronization.