skills.rest
baldimir
baldimirCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

update-primary-doc

Synchronize primary project documents with repository changes using CLAUDE.md rules.

Updated Mar 31, 2026
Search Tags:#automation#documentation#docs#CLAUDE.md#synchronize#sync-rules#primary-docs
One-click install
npx skills add https://github.com/baldimir/bob-skills --skill update-primary-doc-baldimir
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-primary-doc
Source: https://github.com/baldimir/bob-skills/tree/main/.bob/skills/update-primary-doc
Command: npx skills add https://github.com/baldimir/bob-skills --skill update-primary-doc-baldimir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps primary project documents (DESIGN.md, VISION.md, README.md, THESIS.md, etc.) synchronized with repository changes using a table-driven processor that requires no project-specific knowledge. Extended by project-specific mappings (e.g., java-update-design and skills-update-readme) to tailor the workflow per project type.

Core Features & Use Cases

  • Table-driven Sync Rules loaded from CLAUDE.md to map file changes to primary document sections.
  • Works as a base foundation that can be extended for specific project types and mappings.
  • Supports modular primary documents (primary + modules) and validates updates before staging.

Quick Start

Configure CLAUDE.md with a primary document and sync rules, then invoke this skill to generate a proposal for updating the primary document.

Frequently Asked Questions about update-primary-doc

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

FAQPage Schema
How do I synchronize primary project documents with repository changes?▼

To synchronize primary docs, configure CLAUDE.md with sync rules mapping file changes to document sections. The skill then generates section-aware update proposals and validates them before staging.

What are sync rules in CLAUDE.md for documentation updates?▼

Sync rules are table-driven configurations in CLAUDE.md that map specific repository file changes to corresponding sections in primary documents like DESIGN.md or README.md without requiring project-specific knowledge.

Can I use this skill to update a README.md for a custom project?▼

Yes, you can use it for custom projects by configuring CLAUDE.md with the primary document and sync rules. Specialized extensions like skills-update-readme tailor the workflow for README synchronization.

How does the table-driven processor handle modular primary documents?▼

The table-driven processor handles modular primary documents by supporting both primary and module files. It applies configured sync rules to generate proposals and validates updates before staging to ensure traceability.

What's the best way to keep Java design docs synchronized with code changes?▼

The best way to keep Java design docs synchronized is by using the java-update-design extension, which applies the base table-driven sync rules from CLAUDE.md specifically to Java project design documents.

Does updating primary docs require project-specific knowledge?▼

No, updating primary docs does not require project-specific knowledge. The table-driven processor relies entirely on sync rules loaded from CLAUDE.md to map repository changes to document sections safely.

Related Skills

Explore More Software Engineering Skills→
mdproctormdproctor
1

update-primary-doc

Synchronize primary documents with repository changes using CLAUDE.md rules.

Community
Advanced
sergeyitalysergeyitaly
1

doc-coauthoring

Guide structured document creation through context gathering, section refinement, and reader testing.

Community
Intermediate
ZhushuaijiangZhushuaijiang

find-skills

Discover and install agent skills using the Skills CLI workflow.

Community
Intermediate
drt0927drt0927
5

document-release

Update project documentation to reflect shipped changes after a release.

Community
Advanced