manage-codebase-refresh

What problem does it solve?

Prevents documentation from becoming stale by incrementally refreshing codebase docs when source files change, removing manual tracking and reducing documentation drift.

Core Features & Use Cases

• Detects changed files using git diff relative to a baseline derived from --since, state.json fields codebase_last_refreshed or codebase_last_rebuilt, or a 7-day fallback.
• Maps changed files to documentation entries using .workflow/codebase/doc-index.json and refreshes only affected doc sections; the --deep flag forces a broader contextual rescan.
• Updates doc-index.json timestamps and writes codebase_last_refreshed into state.json, emits a concise summary of changes, and surfaces error codes (E001, E002) and warnings (W001) for automation handling.
• Use Case: After a feature merge or refactor, run this skill to automatically update the corresponding docs so documentation reflects the current codebase state.

Quick Start

Run the manage-codebase-refresh skill to incrementally update documentation for files changed since the last refresh.