pali-me

The Sync Documentation skill is an engineering automation tool designed to ensure that project documentation remains accurate and relevant as codebases evolve. By leveraging Git diffs and commit logs, the agent identifies specific modifications—such as database schema updates, testing suite adjustments, or architectural changes—and maps them to the appropriate documentation files within the /docs directory. This process mitigates documentation drift, which is a common challenge in fast-paced development environments where feature implementation often outpaces manual documentation updates. This skill is ideal for software engineers, technical leads, and documentation maintainers who want to enforce strict documentation standards without the overhead of manual tracking.

• Automatically inspects branch-specific git diffs to detect structural and functional changes in the codebase.

• Maps distinct codebase areas, such as db/ migrations, tests/ configurations, or dependency shifts, to corresponding Markdown documentation files.

• Supports context-aware updates by analyzing recent commit messages to understand the 'why' behind specific technical changes.

• Promotes documentation consistency by validating cross-references and ensuring that code examples reflect current implementations.

• Integrates directly into developer workflows via Makefile commands or direct invocation within Claude Code for rapid, context-aware documentation maintenance.

• The skill assumes a standard project directory structure where documentation is housed in a dedicated /docs folder.

• Expected inputs include an active Git branch with pending changes and an existing set of documentation files ready for updates.

• Outputs consist of automated commits or suggestions that modify documentation files with concise explanations and updated code samples.

• Users should review updates to ensure terminology alignment and confirm that version numbers or dates have been correctly incremented.

• Best suited for projects using standard testing frameworks like Jest, React Testing Library, and infrastructure-as-code tools like Maestro for E2E testing.